New-CsRgsHolidaySet
上一次修改主题： 2012-03-23
创建新的响应组假日集。响应组假日集是假日的集合。例如，您可能拥有一个代表美国假日队列的假日集（可能包含美国独立日的假日集）和另一个代表法国假日队列的假日集。后一个队列可能将法国国庆日定义为假日，而不会将美国独立日定义为假日。
语法
New-CsRgsHolidaySet -Parent <RgsIdentity> -HolidayList <Collection> -Name <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <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 的假日集中。收集假日之后，可将假日及其对应的假日集分配给响应组工作流。
New-CsRgsHolidaySet cmdlet 提供了一种配置在组织中使用的新假日集的方法。请注意，在创建新假日集时，必须至少包含一个假日；必须使用 New-CsRgsHoliday cmdlet 创建各个假日。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 New-CsRgsHolidaySet cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsRgsHolidaySet"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
HolidayList |
必需 |
假日对象集合 |
要添加到假日集的一个或多个假日。必须使用 New-CsRgsHoliday cmdlet 创建假日，并将其存储在对象引用中。然后将这些对象引用传递到 Holidays 参数以将假日添加到假日集。例如，以下命令可创建一个名为 New Year's Day 的假日，然后将生成的值存储在名为 $x 的对象引用中： $x = New-CsRgsHoliday -StartDate "1/1/2011 12:00 AM" -EndDate "1/2/2011 12:00 AM" -Name "New Year's Day" 请注意，用于指定日期和时间的格式将取决于您的“区域和语言选项”。本主题中显示的示例使用美国英语。 |
Name |
必需 |
字符串 |
要分配给假日集的唯一名称。通过组合使用 Parent 属性和 Name 属性，可以唯一地标识假日集，而无需引用该集合的全局唯一标识符 (GUID)。 |
Parent |
必需 |
Rgs 标识 |
托管新假日集的服务。例如：-Parent "service:ApplicationServer:atl-cs-001.litwareinc.com"。 |
InMemory |
可选 |
开关参数 |
创建对象引用，但并不作为永久性更改实际提交对象。如果将使用此参数调用的 cmdlet 的输出分配给一个变量，您可以更改对象引用的属性，然后通过调用与此 cmdlet 匹配的 Set- cmdlet 提交这些更改。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
输入类型
无。New-CsRgsHolidaySet 不接受通过管道传递的输入。
返回类型
New-CsRgsHolidaySet 创建 Microsoft.Rtc.Rgs.Management.WritableSettings.HolidaySet 对象的新实例。
示例
-------------------------- 示例 1 --------------------------
$x = New-CsRgsHoliday -StartDate "1/1/2011 12:00 AM" -EndDate "1/2/2011 12:00 AM" -Name "New Year's Day"
New-CsRgsHolidaySet -Parent "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "2011 Holidays" -HolidayList($x)
示例 1 中显示的命令创建名为 2011 Holidays 的新假日集，然后向其分配一个新假日 (New Year's Day)。为执行此操作，第一个命令使用 New-CsRgsHoliday 创建名为 New Year's Day 的假日。New-CsRgsHoliday 使用三个参数：StartDate 指示假日的开始日期 (1/1/2011 12:00 A.M.)；EndDate 代表假日的结束日期 (1/2/2011 12:00 A.M.)；Name 用于存储分配给假日的名称。生成的假日对象存储在变量 $x 中。
在内存中创建新的假日后，使用 New-CsRgsHolidaySet 在 ApplicationServer:atl-cs-001.litwareinc.com 服务上创建新的假日集。为该假日集赋予名称 2011 Holidays (-Name "2011 Holidays")，并向其分配存储在变量 $x 中的假日：-HolidayList ($x)。如果要将多个假日分配给假日集，只需创建新的假日，并将每个假日分配给一个唯一的变量。然后将所有这些变量名称作为参数值传递给 HolidayList：
-HolidayList($x, $y, $z)