Get-CsRgsHoursOfBusiness
마지막으로 수정된 항목: 2012-03-23
조직에서 사용하도록 구성된 응답 그룹 업무 시간 컬렉션에 대한 정보를 반환합니다. 업무 시간 컬렉션은 응답 그룹 에이전트가 일반적으로 전화 통화에 응답할 수 있는 요일 및 시간을 나타내는 데 사용됩니다.
구문
Get-CsRgsHoursOfBusiness [-Identity <RgsIdentity>] [-Name <String>]
자세한 정보
발신자에게 가능한 최상의 환경을 제공하기 위해 응답 그룹 응용 프로그램은 응답 그룹 에이전트가 통화에 응답할 수 있는 시간과 응답할 수 없는 시간을 명확히 정의할 수 있는 기능을 제공합니다. 응답 그룹 응용 프로그램을 사용하면 에이전트가 통화에 응답할 수 있는 요일 및 시간을 나타내는 업무 시간을 정의할 수 있습니다. 예를 들어 조직에서 일반적으로 월요일~금요일, 오전 9시부터 오후 5시까지 업무를 보는 경우 에이전트가 월요일~금요일, 오전 9시부터 오후 5시까지 전화를 받을 수 있음을 나타내는 업무 시간을 구성합니다. 또한 목요일 오후 8시나 일요일 오후 2시 30분 등에는 에이전트가 전화를 받을 수 없음을 나타내는 업무 시간을 구성할 수도 있습니다.
Get-CsRgsHoursOfBusiness cmdlet을 사용하면 조직에서 사용하도록 구성된 업무 시간 컬렉션에 대한 정보를 검색할 수 있습니다.
이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalServerAdmins 및 RTCUniversalReadOnlyAdmins 그룹의 구성원은 Get-CsRgsHoursOfBusiness cmdlet을 로컬로 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsRgsHoursOfBusiness"}
매개 변수
| 매개 변수 | 필수 | 유형 | 설명 |
|---|---|---|---|
Identity |
필수 |
Rgs ID |
업무 시간 컬렉션이 호스팅되는 서비스의 ID 또는 컬렉션 자체의 전체 ID를 나타냅니다. 서비스 ID(예: service:ApplicationServer:atl-cs-001.litwareinc.com)를 지정하면 해당 서비스에서 호스팅되는 모든 업무 시간 컬렉션이 반환되고, 컬렉션 ID를 지정하면 지정된 업무 시간 컬렉션만 반환됩니다. 업무 시간 컬렉션 ID는 서비스 ID와 GUID(Globally Unique Identifier)로 구성됩니다(예: service:ApplicationServer-ApplicationServer-1/1987d3c2-4544-489d-bbe3-59f79f530a83). 서비스 ID를 지정한 다음 Name 매개 변수와 컬렉션 이름을 포함하여 업무 시간 컬렉션을 반환할 수도 있습니다. 이렇게 하면 특정 업무 시간 컬렉션에 할당된 GUID를 몰라도 해당 컬렉션을 검색할 수 있습니다. 매개 변수 없이 호출한 경우 Get-CsRgsHoursOfBusiness는 조직에서 사용하도록 구성된 모든 업무 시간 컬렉션을 반환합니다. |
Name |
선택 |
문자열 |
업무 시간 컬렉션을 만들 당시 해당 컬렉션에 지정된 고유 이름입니다. |
입력 형식
없음. Get-CsRgsHoursOfBusiness는 파이프라인된 입력을 허용하지 않습니다.
반환 형식
Microsoft.Rtc.Rgs.Management.WritableSettings.BusinessHours 개체의 인스턴스를 반환합니다.
예제
-------------------------- 예제 1 --------------------------
Get-CsRgsHoursOfBusiness
예제 1에서는 조직에서 사용하도록 구성된 모든 업무 시간 컬렉션에 대한 정보를 반환합니다. 이 작업을 수행하기 위해 매개 변수 없이 Get-CsRgsHoursOfBusiness를 호출합니다.
-------------------------- 예제 2 --------------------------
Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com"
예제 2에 표시된 명령은 atl-cs-001.litwareinc.com에서 사용하도록 구성된 모든 업무 시간 컬렉션을 반환합니다.
-------------------------- 예제 3 --------------------------
Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "Help Desk Business Hours"
위 명령은 atl-cs-001.litwareinc.com에서 "Help Desk Business Hours"라는 단일 컬렉션을 반환합니다.
-------------------------- 예제 4 --------------------------
Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Where-Object {$_.SundayTimeRange1 -ne $Null -or $_.SundayTimeRange2 -ne $Null}
위 명령은 일요일에 대해 구성된 업무 시간이 있는 모든 업무 시간 컬렉션을 반환합니다. 이 작업을 수행하기 위해 이 명령은 먼저 Get-CsRgsHoursOfBusiness를 호출하여 atl-cs-001.litwareinc.com에서 찾은 모든 업무 시간 컬렉션을 반환합니다. 이 데이터는 SundayTimeRange1 속성과 SundayTimeRange2 속성 중 하나 또는 둘 다가 Null 값과 같지 않은 항목만 선택하는 Where-Object cmdlet에 파이프됩니다. 시간 범위 속성이 Null이 아니라는 것은 해당 기간에 대해 업무 시간이 구성되어 있음을 의미합니다.
-------------------------- 예제 5 ------------------------
Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Where-Object {$_.MondayTimeRange1.OpenTime -le "08:00:00"}
예제 5에 표시된 명령은 atl-cs-001.litwareinc.com에서 MondayTimeRange1 속성의 시작 시간이 오전 8시와 같거나 그 이전인 모든 업무 시간 컬렉션을 반환합니다. 이 작업을 수행하기 위해 이 명령은 먼저 Get-CsRgsHoursOfBusiness를 사용하여 atl-cs-001.litwareinc.com에서 모든 업무 시간 컬렉션을 반환합니다. 이 데이터는 MondayTimeRange1.OpenTime 속성 값이 오전 8시(08:00:00)보다 작거나 같은 컬렉션만 선택하는 Where-Object cmdlet에 파이프됩니다.
-------------------------- 예제 6 --------------------------
Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Where-Object {$_.Custom -eq $False}
예제 6에 표시된 명령은 모든 공용 업무 시간 컬렉션(즉, 워크플로 간에 공유할 수 있는 컬렉션)을 반환합니다. 이 작업을 수행하기 위해 이 명령은 먼저 Get-CsRgsHoursOfBusiness를 사용하여 atl-cs-001.litwareinc.com에서 찾은 모든 업무 시간 컬렉션을 반환합니다. 이 데이터는 Custom 속성이 False와 같은 컬렉션만 선택하는 Where-Object cmdlet에 파이프됩니다.