New-CsRgsHoliday
上一次修改主题： 2012-03-23
创建新的响应组假日。在响应组应用程序中，假日代表分配给队列的代理通常情况下应该工作但实际上不会工作，因此无法应答呼叫的日期。例如，如果美国工作者在 Thanksgiving Day 不工作，则需要将 2011 年 11 月 24 日配置为假日。
语法
New-CsRgsHoliday -EndDate <Nullable> -StartDate <Nullable> [-Name <String>]
详细说明
响应组应用程序使用工作时间集合来指示代理通常在一周中的哪几天和一天中的哪些时段可以应答电话呼叫。例如，假设您的技术支持的工作时间通常为每周一上午 7:00 至下午 7:00。在这种情况下，您应创建技术支持的工作时间集合，并将开始时间和结束时间分别配置为每周一的上午 7:00 和下午 7:00。
尽管规定技术支持的工作时间为每周一上午 7:00 至下午 7:00，但是也可能有例外。例如，在美国，7 月 4 日是假日，因此，您的技术支持人员可能在 7 月 4 日不工作。为了将技术支持在 2011 年 7 月 4 日（周一）不工作的情况考虑在内，您需要为该日期创建假日并将其添加到技术支持假日集中。
要创建假日，您需要使用 New-CsRgsHoliday cmdlet。（请注意，“假日”并不一定要涉及某些节假日，假日仅指代理无法接听电话的日期。）New-CsRgsHoliday 不会直接向假日集添加假日。该 cmdlet 会创建仅存在于内存中的新假日。因此，您必须创建指向该仅存在于内存中的实例的对象引用（如 $x）。在内存中创建假日后，使用 Get-CsRgsHolidaySet cmdlet 检索相应的假日集，并使用 Set-CsRgsHolidaySet cmdlet 将新假日添加到该假日集中。
尽管假日集可以（并且通常会）包含多个假日，但每次只能向假日集中添加一个假日。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 New-CsRgsHoliday cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins 和 RTCUniversalReadOnlyAdmins。但是，由于此 cmdlet 创建一个保存在内存中的对象，并且自身不会对系统进行任何更改，因此实质上任何人都可以运行它。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsRgsHoliday\b"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Name |
必需 |
字符串 |
用于将某个假日与其他假日区分开来的唯一名称。 |
EndDate |
必需 |
日期时间 |
假日的结束日期。结束日期的格式取决于您的“区域和语言选项”。例如，在美国，结束日期 2011 年 7 月 4 日的格式如下所示：-EndDate "7/5/2011 12:00 AM"，表示该假日结束于 2011 年 7 月 5 日零点。 |
StartDate |
必需 |
日期时间 |
假日的开始日期。开始日期的格式取决于您的“区域和语言选项”。例如，在美国，开始日期 2011 年 7 月 4 日的格式如下所示：-StartDate "7/4/2011 12:00 AM"，指示该假日开始于 2011 年 7 月 4 日零点。 |
输入类型
无。New-CsRgsHoliday 不接受通过管道传递的输入。
返回类型
New-CsRgsHoliday 创建 Microsoft.Rtc.Rgs.Management.WritableSettings.Holiday 对象的新实例。
示例
-------------------------- 示例 1 --------------------------
$christmasDay = New-CsRgsHoliday -StartDate "12/25/2010 12:00 AM" -EndDate "12/26/2010 12:00 AM" -Name "Christmas Day"
$y = Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "2010 Holidays"
$y.HolidayList.Add($christmasDay)
Set-CsRgsHolidaySet -Instance $y
示例 1 中显示的命令说明了如何创建新的假日 (Christmas Day)，然后将该假日分配给某个现有的假日集。为执行此操作，此示例中的第一个命令使用 New-CsRgsHoliday cmdlet 创建新的假日，该假日是仅存在于内存中的“虚拟”假日，并存储在变量 $christmasDay 中。New-CsRgsHoliday 使用以下三个参数：StartDate，代表假日的开始日期 (12/25/2010 12:00 AM)；EndDate，代表假日的结束日期 (12/26/2010 12:00 AM)；以及 Name，代表要赋予该假日的唯一名称。
创建新的假日之后，第二个命令使用 Get-CsRgsHolidaySet 从 ApplicationServer:atl-cs-001.litwareinc.com 服务检索假日集“2010 Holidays”。此假日集存储在变量 $y 中。
命令 3 使用 Add 方法将新假日 ($christmasDay) 添加到假日集的虚拟副本 ($y) 中。然后，最后一个命令调用 Set-CsRgsHolidaySet 将更改写入（即添加新假日）ApplicationServer:atl-cs-001.litwareinc.com 服务。