Remove-CsRgsHoursOfBusiness
上一次修改主题： 2012-03-23
删除现有的响应组工作时间集合。工作时间用于指示通常情况下，响应组代理在一周中的哪几天、一天中的哪些时段可以应答电话呼叫。
语法
Remove-CsRgsHoursOfBusiness -Instance <BusinessHours> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
为了尽可能向呼叫者提供最佳体验，响应组应用程序使您可以明确定义响应组代理何时能够应答呼叫以及何时无法应答呼叫。使用响应组应用程序，您可以定义工作时间；这些时间指示代理在一周中的哪几天、一天中的哪些时段可以应答呼叫。例如，如果通常情况下您组织的工作时间为周一到周五的上午 9:00 到下午 5:00，则您应将工作时间配置为显示从周一到周五的上午 9:00 到下午 5:00 有可用代理（推而广之，周四晚上 8:00 或周日下午 2:30 代理不可用）。
可以使用 New-CsRgsHoursOfBusiness cmdlet 创建新的工作时间集合；以后可以使用 Remove-CsRgsHoursOfBusiness cmdlet 删除此类集合。请注意，调用 Remove-CsRgsHoursOfBusiness 时，整个时间集合都将删除且不再可用。如果仅希望删除特定日期的工作时间（例如，由于您的技术支持周日不再工作），则应使用 Set-CsRgsHoursOfBusiness 仅从集合中删除相应的值。
默认情况下，如果您尝试删除由活动工作流当前使用的工作时间集合，则 Remove-CsRgsHoursOfBusiness 会弹出提示。该提示会要求您确认是否确实要删除该集合，并且仅当对该提示做出响应后才会执行操作。要绕过此提示并以静默方式删除工作时间集合（即使此类集合当前已分配给活动工作流），请添加 Force 参数。例如：
Get-CsRgsHoursOfBusiness –Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Remove-CsRgsHoursOfBusiness –Force
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Remove-CsRgsHoursOfBusiness cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsRgsHoursOfBusiness"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Instance |
必需 |
工作时间对象 |
指向要删除的工作时间的对象引用。通过管道将工作流对象传递到 Remove-CsRgsHoursOfBusiness 时，可以省略 Instance 参数。 要使用 Instance 参数，请使用类似如下的命令： $x = Get-CsRgsHoursOfBusiness –Identity ApplicationServer:atl-cs-001.litwareinc.com /1987d3c2-4544-489d-bbe3-59f79f530a83 Remove-CsRgsHoursOfBusiness –Instance $x 请注意，使用 Instance 参数时一次只能删除一个工作时间集。这意味着，对象引用 ($x) 不能包含多个工作时间对象。 |
Force |
可选 |
开关参数 |
强制删除工作时间集合。如果存在此参数，即使集合当前已分配给活动工作流，也将在没有任何警告的情况下删除该集合。如果不存在此参数，则删除当前分配给活动工作流的任何工作时间集合时，系统会要求您确认。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Rgs.Management.WritableSettings.BusinessHours 对象。Remove-CsRgsHoursOfBusiness 接受通过管道传递的响应组工作时间对象的实例。
返回类型
删除 Microsoft.Rtc.Rgs.Management.WritableSettings.BusinessHours 对象的现有实例。
示例
-------------------------- 示例 1 --------------------------
Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Remove-CsRgsHoursOfBusiness
示例 1 中显示的命令删除 ApplicationServer:atl-cs-001.litwareinc.com 服务上的所有工作时间集合。为执行此操作，该命令首先调用 Get-CsRgsHoursOfBusiness，以返回 ApplicationServer:atl-cs-001.litwareinc.com 服务上的所有工作时间集合。然后，将这些集合通过管道传递到 Remove-CsRgsHoursOfBusiness cmdlet，后者将删除传递给它的每个工作时间集合。
-------------------------- 示例 2 --------------------------
Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "Help Desk Business Hours" | Remove-CsRgsHoursOfBusiness
在示例 2 中，从 ApplicationServer:atl-cs-001.litwareinc.com 删除一个工作时间集合：名为 Help Desk Business Hours 的集合。
-------------------------- 示例 3 --------------------------
Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Where-Object {$_.SundayTimeRange1 -ne $Null -or $_.SundayTimeRange2 -ne $Null} | Remove-CsRgsHoursOfBusiness
上述命令删除已为周日配置工作时间的所有工作时间集合。为执行此操作，该命令首先调用 Get-CsRgsHoursOfBusiness，以返回 ApplicationServer:atl-cs-001.litwareinc.com 上的所有工作时间集合。然后，将这些集合通过管道传递到 Where-Object cmdlet，该 cmdlet 将仅选择满足以下条件之一的项：SundayTimeRange1 属性不等于空值，或 SundayTimeRange2 属性不等于空值。（如果时间范围属性不为空，则意味着已将该时间间隔配置为工作时间。）接下来，将至少满足这些条件之一的任何集合通过管道传递到 Remove-CsRgsHoursOfBusiness cmdlet，后者将删除该工作时间集合。
-------------------------- 示例 4 --------------------------
Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Where-Object {$_.Custom -eq $True} | Remove-CsRgsHoursOfBusiness -Force
示例 4 中显示的命令删除所有自定义工作时间集合（即无法在工作流中共享的集合）。为完成此任务，该命令首先使用 Get-CsRgsHoursOfBusiness，以返回 ApplicationServer:atl-cs-001.litwareinc.com 上的所有工作时间集合。然后，将此数据通过管道传递到 Where-Object cmdlet，后者会仅挑选 Custom 属性等于 True 的集合。然后，将这些集合通过管道传递到 Remove-CsRgsHoursOfBusiness，并由其删除。