Get-CsRgsHoursOfBusiness
上一次修改主题： 2012-03-23
检索有关配置为在组织中使用的响应组工作时间集合的信息。工作时间集合用于指示通常情况下，响应组代理在一周中的哪几天、一天中的哪些时段可以应答电话呼叫。
语法
Get-CsRgsHoursOfBusiness [-Identity <RgsIdentity>] [-Name <String>]
详细说明
为了尽可能向呼叫者提供最佳体验，响应组应用程序使您可以明确定义响应组代理何时能够应答呼叫以及何时无法应答呼叫。使用响应组应用程序，您可以定义工作时间，指示代理在一周中的哪几天、一天中的哪些时段可以应答呼叫。例如，如果通常情况下您组织的工作时间为周一到周五的上午 9:00 到下午 5:00，则您应将工作时间配置为显示从周一到周五的上午 9:00 到下午 5:00 有可用代理（推而广之，周四晚上 8:00 或周日下午 2:30 代理不可用）。
Get-CsRgsHoursOfBusiness cmdlet 提供了一种检索有关配置为在组织中使用的工作时间集合的信息的方法。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Get-CsRgsHoursOfBusiness cmdlet：RTCUniversalServerAdmins、RTCUniversalReadOnlyAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsRgsHoursOfBusiness"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
Rgs 标识 |
代表托管工作时间集合的服务的 Identity 或集合本身的完整 Identity。如果指定服务 Identity（例如，service:ApplicationServer:atl-cs-001.litwareinc.com），则将返回该服务托管的所有工作时间集合。如果指定集合的 Identity，则仅返回指定的工作时间集合。请注意，工作时间集合的 Identity 是由服务 Identity 后跟全局唯一标识符 (GUID) 组成的，例如：service:ApplicationServer-1/1987d3c2-4544-489d-bbe3-59f79f530a83. 另一种返回工作时间集合的方法是指定服务 Identity，然后包含 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 上的所有工作时间集合。然后，将此数据通过管道传递到 Where-Object cmdlet，后者会仅选择满足以下两个条件之一的项：SundayTimeRange1 属性不等于空值，和/或 SundayTimeRange2 属性不等于空值。如果时间范围属性不为空，则意味着已将该时间段配置为工作时间。
-------------------------- 示例 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:00 的所有工作时间集合。为执行此操作，该命令首先使用 Get-CsRgsHoursOfBusiness 从 atl-cs-001.litwareinc.com 返回所有工作时间集合。然后，将此数据通过管道传递到 Where-Object cmdlet，后者会仅选择 MondayTimeRange1.OpenTime 属性的值小于或等于上午 8:00 (08:00:00) 的集合。
-------------------------- 示例 6 --------------------------
Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Where-Object {$_.Custom -eq $False}
示例 6 中显示的命令返回所有公共工作时间集合（即可以在工作流中共享的集合）。为执行此操作，该命令首先使用 Get-CsRgsHoursOfBusiness 返回 atl-cs-001.litwareinc.com 上的所有工作时间集合。然后，将此数据通过管道传递到 Where-Object cmdlet，后者会仅挑选 Custom 属性等于 False 的集合。