New-CsRgsTimeRange

구문

New-CsRgsTimeRange -CloseTime <Nullable> -OpenTime <Nullable> [-Name <String>]

자세한 정보

응답 그룹 응용 프로그램에서는 업무 시간 컬렉션을 사용하여 에이전트가 일반적으로 전화에 응답할 수 있는 요일 및 시간을 추적합니다. 예를 들어 지원 센터가 매주 월요일 오전 7시부터 오후 7시까지 운영된다고 가정해 보겠습니다. 이 경우 두 가지 작업을 수행해야 합니다. 즉, New-CsRgsHoursOfBusiness cmdlet을 사용하여 지원 센터에 대한 업무 시간 컬렉션을 만들고, 지원 센터가 오전 7시에 시작하여 오후 7시에 종료됨을 나타내도록 MondayTimeRange1 속성을 수정해야 합니다.

기존 업무 시간 컬렉션을 수정하려면 Set-CsRgsHoursOfBusiness cmdlet을 사용해야 합니다. 그러나 이 cmdlet을 사용하여 시간 범위 속성을 직접 수정할 수는 없습니다. 예를 들어 Set-CsRgsHoursOfBusiness에는 MondayTimeRange1 속성에 해당하는 매개 변수가 없습니다. 대신 업무 시간 컬렉션을 수정하려면 Get-CsRgsHoursOfBusiness를 사용하여 해당 컬렉션을 검색하고, 컬렉션 변경 내용을 메모리에만 적용한 다음, Set-CsRgsHoursOfBusiness를 사용하여 실제 업무 시간 컬렉션에 이러한 변경 내용을 기록해야 합니다.

업무 시간 컬렉션에 대한 변경 작업에는 지정된 날짜의 시작 및/또는 종료 시간 변경이 포함되는 경우가 많습니다. 시작 시간 및 종료 시간을 수정하려면 New-CsRgsTimeRange cmdlet을 사용하여 이러한 시간을 지정해야 합니다. 이 cmdlet을 호출하면 결과 값이 개체 참조 변수에 저장됩니다. 그런 다음 이 변수는 업무 시간 컬렉션 내에서 시작 시간 및 종료 시간을 설정하는 데 사용됩니다.

또한 New-CsRgsTimeRange를 사용하여 새 업무 시간 컬렉션을 만들 때마다 시작 시간 및 종료 시간을 지정해야 합니다.

이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalUserAdmins, RTCUniversalServerAdmins 및 RTCUniversalReadOnlyAdmins 그룹의 구성원은 New-CsRgsTimeRange cmdlet을 로컬로 실행할 수 있습니다. 그러나 이 cmdlet은 메모리에만 나타나는 개체를 만들고 자체적으로 시스템을 변경하지 않기 때문에 기본적으로 누구든지 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsRgsTimeRange"}

매개 변수

입력 형식

없음. New-CsRgsTimeRange는 파이프라인된 입력을 허용하지 않습니다.

반환 형식

New-CsRgsTimeRange는 Microsoft.Rtc.Rgs.Management.WritableSettings.TimeRange 개체의 새 인스턴스를 만듭니다.

예제

-------------------------- 예제 1 --------------------------

$sundayHours = New-CsRgsTimeRange -Name "Sunday hours" -OpenTime "08:30" -CloseTime "13:30"
$y = Get-CsRgsHoursOfBusiness -Identity Service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Hours" 
$y.SundayHours1 = $sundayHours
Set-CsRgsHoursOfBusiness -Instance $y

위 예제에서는 New-CsRgsTimeRange cmdlet을 사용하여 기존 업무 시간 집합의 속성을 수정하는 방법을 보여 줍니다. 이 예제에서는 먼저 New-CsRgsTimeRange를 호출하여 "Sunday hours"라는 새 시간 범위를 만듭니다. 이 시간 범위는 시작 시간을 오전 8시 30분(8:30)으로 설정하고 종료 시간을 오후 1시 30분(13:30)으로 설정합니다. 이 명령에서 만든 메모리 내부 시간 범위는 $sundayHours 변수에 저장됩니다.

시간 범위를 구성한 후 이 예제의 두 번째 명령은 Get-CsRgsHoursOfBusiness를 사용하여 ApplicationServer:atl-cs-001.litwareinc.com 서비스에서 찾은 Help Desk Hours라는 업무 시간 컬렉션을 반환합니다. 반환된 컬렉션은 변수 $y에 저장됩니다.

컬렉션을 검색한 후 세 번째 명령은 SundayHours1 속성 값을 $sundayHours(새로 만든 시간 범위를 포함하는 개체 참조)로 설정합니다. 그런 다음 이 명령이 완료되면 Set-CsRgsHoursOfBusiness를 사용하여 Help Desk Hours 업무 시간 컬렉션에 이러한 변경 내용을 기록합니다. Set-CsRgsHoursOfBusiness를 호출하지 못한 경우에는 새로 만든 시간 범위가 메모리에만 존재하고 Windows PowerShell을 닫거나 $sundayHours 변수를 삭제하는 즉시 사라집니다. 이 경우 Help Desk Hours 업무 시간 컬렉션이 업데이트되지 않습니다.

-------------------------- 예제 2 --------------------------

$sundayHours = New-CsRgsTimeRange -Name "Sunday hours" -OpenTime "08:30" -CloseTime "13:30"
New-CsRgsHoursOfBusiness -Parent Service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Hours" -SundayHours1 $sundayHours

예제 2에서는 새 응답 그룹 시간 범위를 만든 다음 새 업무 시간 집합에서 이 시간 범위를 사용합니다. 이 예제의 첫 번째 명령은 New-CsRgsTimeRange cmdlet을 사용하여 Sunday Hours라는 새 시간 범위를 만듭니다. 이 범위의 OpenTime은 오전 8시 30분("8:30")으로 설정되고, CloseTime은 오후 1시 30분("13:30" - 24시간제 형식 사용 시 13시 30분)으로 설정됩니다. 결과 시간 범위 개체는 $sundayHours 변수에 저장됩니다.

두 번째 명령은 New-CsRgsBusinessHours cmdlet을 사용하여 Help Desk Hours라는 새 업무 시간 컬렉션을 만듭니다. 이 명령에서 $sundayHours 변수는 SundayHours1 속성의 시간 범위를 지정합니다.

참고 항목

기타 리소스

New-CsRgsHoursOfBusiness
Set-CsRgsHoursOfBusiness