Remove-CsRgsHolidaySet

구문

Remove-CsRgsHolidaySet -Instance <HolidaySet> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

자세한 정보

발신자에게 가능한 최상의 환경을 제공하기 위해 응답 그룹 응용 프로그램은 응답 그룹 에이전트가 통화에 응답할 수 있는 시간과 응답할 수 없는 시간을 명확히 정의할 수 있는 기능을 제공합니다. 응답 그룹 응용 프로그램을 사용하면 에이전트가 통화에 응답할 수 있는 요일 및 시간을 나타내는 업무 시간을 정의할 수 있습니다. 예를 들어 조직에서 일반적으로 월요일~금요일, 오전 9시부터 오후 5까지 업무를 보는 경우 에이전트가 월요일~금요일, 오전 9시부터 오후 5시까지 전화를 받을 수 있음을 나타내는 업무 시간을 구성합니다. 또한 목요일 오후 8시나 일요일 오후 2시 30분 등에는 에이전트가 전화를 받을 수 없음을 나타내는 업무 시간을 구성할 수도 있습니다.

그러나 대부분의 조직에는 특정 주에 업무를 수행하지 않는 예외가 있습니다. 예를 들어 미국의 경우 크리스마스 또는 추수 감사절이 조직의 휴무일일 수 있습니다. 이러한 예외적인 휴무를 허용하기 위해 응답 그룹 응용 프로그램에서는 일반적으로 조직의 업무일이지만 이유에 관계없이 업무를 수행하지 않는 특정 날짜를 휴일로 지정할 수 있습니다 New-CsRgsHoliday cmdlet을 사용하여 만든 개별 휴일은 휴일 집합에 포함됩니다. 예를 들어 미국의 휴일은 US_Holidays라는 휴일 집합에 포함되고, 일본의 휴일은 Japanese_Holidays라는 휴일 집합에 포함될 수 있습니다. 그런 다음 휴일 및 휴일 집합이 응답 그룹 워크플로에 할당될 수 있습니다.

Remove-CsRgsHolidaySet cmdlet을 사용하여 관리자는 응답 그룹 휴일 집합을 제거할 수 있습니다. 활성 워크플로에 현재 할당된 휴일 집합을 제거하려고 하면 기본적으로 cmdlet이 일시 중지되고 워크플로를 삭제할지 묻는 메시지가 표시됩니다. 이 프롬프트에 응답할 때까지 명령이 실행되지 않으며 휴일 집합이 제거되지 않습니다. 이 프롬프트를 무시하고 활성 워크플로에서 현재 사용 중인 경우에도 휴일 집합을 제거하려면 Force 매개 변수를 추가합니다.

Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "2010 Holidays" | Remove-CsRgsHolidaySet –Force

Remove-CsRgsHolidaySet를 호출하면 전체 휴일 집합이 제거되고 더 이상 사용할 수 없게 되므로 주의해야 합니다. 예를 들어 추수 감사절에도 근무하기 때문에 이러한 단일 휴일을 휴일 집합에서 제거하려면 Set-CsRgsHolidaySet를 사용하여 지정한 휴일만 제거해야 합니다.

이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalServerAdmins 그룹의 구성원은 Remove-CsRgsHolidaySet cmdlet을 로컬로 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsRgsHolidaySet"}

매개 변수

입력 형식

Microsoft.Rtc.Rgs.Management.WritableSettings.HolidaySet 개체입니다. Remove-CsRgsHolidaySet는 응답 그룹 휴일 집합 개체의 파이프라인된 인스턴스를 허용합니다.

반환 형식

Remove-CsRgsHolidaySet는 Microsoft.Rtc.Rgs.Management.WritableSettings.HolidaySet 개체의 기존 인스턴스를 삭제합니다.

예제

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

Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "2010 Holidays" | Remove-CsRgsHolidaySet

예제 1에 표시된 명령은 ApplicationServer:atl-cs-001.litwareinc.com 서비스에서 "2010 Holidays" 휴일 집합을 제거합니다. 이 작업을 수행하기 위해 이 명령은 먼저 휴일 집합의 위치를 지정하는 Identity 매개 변수와 휴일 집합의 이름을 지정하는 Name 매개 변수의 두 가지 매개 변수와 함께 Get-CsRgsHolidaySet를 호출합니다. 반환된 개체는 2010 Holidays 휴일 집합을 삭제하는 Remove-CsRgsHolidaySet에 파이프됩니다.

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

Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com"  | Select-Object Identity -ExpandProperty HolidayList | Where-Object {$_.Name -eq "New Year's Day"}  | Remove-CsRgsHolidaySet 

위 명령은 ApplicationServer:atl-cs-001.litwareinc.com 서비스에서 New Year’s Day 휴일을 포함하는 모든 휴일 집합을 삭제합니다. 이 작업을 수행하기 위해 이 명령은 먼저 Get-CsRgsHolidaySet를 사용하여 ApplicationServer:atl-cs-001.litwareinc.com 서비스에서 찾은 모든 휴일 집합의 컬렉션을 반환합니다. 이 컬렉션은 1) 각 휴일 집합의 Identity 속성을 선택하고, 2) HolidayList 속성 값을 "확장"하는 Select-Object cmdlet에 파이프됩니다. 값을 확장하면 기본 개체의 속성이 반환됩니다. 즉, 휴일의 경우 Name, StartDate 및 EndDate와 같은 속성이 반환됩니다. 여기서 선택한 정보(휴일 집합 ID 및 휴일 속성 값)는 Name이 "New Year's Day"와 같은(-eq) 휴일이 포함된 집합을 선택하는 Where-Object cmdlet에 파이프됩니다. 그런 다음 필터링된 휴일 집합 컬렉션은 New Year's Day 휴일이 포함된 각 휴일 집합을 삭제하는 Remove-CsRgsHolidaySet에 파이프됩니다.

-------------------------- 예제 3 --------------------------

Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com"  | Where-Object {$_.HolidayList.Count -lt 5} | Remove-CsRgsHolidaySet

예제 3에 표시된 명령은 ApplicationServer:atl-cs-001.litwareinc.com 서비스에서 할당된 휴일이 5일 미만인 휴일 집합을 삭제합니다. 이 작업을 수행하기 위해 이 명령은 먼저 Get-CsRgsHolidaySet를 호출하여 ApplicationServer:atl-cs-001.litwareinc.com에서 찾은 모든 휴일 집합의 컬렉션을 반환합니다. 이 컬렉션은 할당된 휴일 수($_.Holidays.Count)가 5보다 작은 휴일 집합만 선택하는 Where-Object cmdlet에 파이프됩니다. 그런 다음 이러한 휴일 집합은 Remove-CsRgsHolidaySet cmdlet에 파이프되어 삭제됩니다.

참고 항목

기타 리소스

Get-CsRgsHolidaySet
New-CsRgsHolidaySet
Set-CsRgsHolidaySet