Remove-CsRgsHolidaySet
上一次修改主题: 2012-03-23
删除现有的响应组假日集。响应组假日集是假日的集合。例如,您可能拥有一个代表美国假日队列的假日集(可能包含美国独立日的假日集)和另一个代表法国假日队列的假日集。后一个队列可能将法国国庆日定义为假日,而不会将美国独立日定义为假日。
语法
Remove-CsRgsHolidaySet -Instance <HolidaySet> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
为了尽可能向呼叫者提供最佳体验,响应组应用程序使您可以明确定义响应组代理何时能够应答呼叫以及何时无法应答呼叫。使用响应组应用程序,您可以定义工作时间,指示代理在一周中的哪几天、一天中的哪些时段可以应答呼叫。例如,如果通常情况下您组织的工作时间为周一到周五的上午 9:00 到下午 5:00,则您应将工作时间配置为显示从周一到周五的上午 9:00 到下午 5:00 有可用代理(推而广之,周四晚上 8:00 或周日下午 2:30 代理不可用)。
不过,许多组织除正常工作日之外还有例外情况,例如,美国的组织在 Christmas Day 或 Thanksgiving Day 可能不工作。为了应对此类非典型的不工作现象,响应组应用程序使您可以将特定的日期指定为假日:通常情况下组织应该工作,但因某种原因不工作的日期。各个假日(使用 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 时,整个假日集合都将删除且不再可用。如果只想删除假日集中的单个假日(例如,您的公司要在 Thanksgiving Day 正常工作),则应使用 Set-CsRgsHolidaySet 仅将指定的假日删除。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Remove-CsRgsHolidaySet cmdlet:RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsRgsHolidaySet"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Instance |
必需 |
假日集对象 |
指向要删除的假日集的对象引用。通过管道将工作流对象传递到 Remove-CsRgsHolidaySet 时,可以省略 Instance 参数。 要使用 Instance 参数,请使用类似如下的命令: $x = Get-CsRgsHolidaySet –Identity ApplicationServer:atl-cs-001.litwareinc.com /1987d3c2-4544-489d-bbe3-59f79f530a83 Remove-CsRgsHolidaySet –Instance $x 请注意,使用 Instance 参数时一次只能删除一个假日集。这意味着,对象引用 ($x) 不能包含多个假日集对象。 |
Force |
可选 |
开关参数 |
强制删除假日集。如果存在此参数,即使假日集正在由活动工作流使用,也将在没有任何警告的情况下删除该假日集。如果不存在此参数,则删除当前分配给活动工作流的任何假日集时,系统会要求您确认。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
Confirm |
可选 |
开关参数 |
此参数仅用于测试。 |
输入类型
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”。为执行此操作,该命令首先调用带有以下两个参数的 Get-CsRgsHolidaySet:Identity 参数(用于指定假日集的位置)和 Name 参数(用于指定假日集的名称)。然后,将返回的对象通过管道传递到 Remove-CsRgsHolidaySet,后者将删除假日集 2010 Holidays。
-------------------------- 示例 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 服务上所有假日集的集合。然后将该集合通过管道传递到 Select-Object cmdlet,后者将执行以下两项操作:1) 为每个假日集选择 Identity 属性;2)“展开”HolidayList 属性的值。(展开值时,可返回基础对象的属性。对于假日,这意味着 Name、StartDate 和 EndDate 等属性。)将选定的信息(假日集 Identity 和假日属性值)通过管道传递到 Where-Object,该 cmdlet 将挑选出包含 Name 等于 (-eq) "New Year's Day"的假日的假日集。然后,将筛选出的假日集的集合通过管道传递到 Remove-CsRgsHolidaySet,后者将删除包含假日 New Year’s Day 的每个假日集。
-------------------------- 示例 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 上所有假日集的集合。将该集合通过管道传递到 Where-Object cmdlet,后者将仅选择已分配的假日数 ($_.HolidayList.Count) 小于 5 的假日集。然后,将这些假日集通过管道传递到 Remove-CsRgsHolidaySet cmdlet,并由其删除。