New-CsRgsHoliday
上次修改主題的時間： 2012-03-23
建立新的回應群組假日。在 回應群組應用程式 中，假日表示指派給佇列的專員不上班，而且不會接聽來電的日子 (專員一般會在該日工作)。例如，如果要讓美國的員工在感恩節放假，則假日會設為 2011 年 11 月 24 日。
語法
New-CsRgsHoliday -EndDate <Nullable> -StartDate <Nullable> [-Name <String>]
詳細描述
回應群組應用程式 使用營業時間集合，來表示專員一般會在一星期的哪幾天和哪些時段接聽電話。例如，假設您的服務台通常是每個星期一的 7:00 A.M. 到 7:00 P.M. 有人。在此情況下，您可以為服務台建立一個營業時間集合，然後設定開始時間為一般星期一的 7:00 A.M.，而結束時間為 7:00 P.M.。
但是服務台人員編制為每星期一的 7:00 A.M. 到 7:00 P.M. 的這項規則可能會有例外的時候。例如在美國 7 月 4 日是假日，因此服務台人員在 7 月 4 日不會工作。為了表示服務台在 2011 年 7 月 4 日星期一不會工作，您必須為這天建立一個假日，然後將這個假日新增到服務台假日集中。
若要建立假日，您必須使用 New-CsRgsHoliday 指令程式。(注意，「假日」不一定要與慶典或節日有關，假日只是專員不用接聽電話的日子)。New-CsRgsHoliday 不會直接將假日新增到假日集中，但指令程式會建立新的假日，新假日只存在於記憶體中。因此，您必須建立一個物件參考 (例如 $x)，這個參考會指向在記憶體中的這個執行個體。當系統已在記憶體中建立假日後，您可以使用 Get-CsRgsHolidaySet 指令程式擷取適當的假日集，並使用 Set-CsRgsHolidaySet 指令程式將新的假日新增到該假日集中。
雖然假日集能夠 (通常也會) 包含多個假日，但將這些假日新增至假日集時，每次只能新增一個。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsRgsHoliday Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins、RTCUniversalReadOnlyAdmins。由於此 Cmdlet 會在記憶體內建立物件，而其本身亦不會變更系統，因此任何人皆可執行。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsRgsHoliday\b"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Name |
必要 |
字串 |
用於區分不同假日的唯一名稱。 |
EndDate |
必要 |
DateTime |
假日的結束日期。結束日期的格式取決於您的 [地區及語言選項]。例如，在美國 2011 年 7 月 4 日的結束日期，其格式會設定如下：-EndDate "7/5/2011 12:00 AM"，這表示假日會在 2011 年 7 月 5 日的 12:00 A.M. 結束。 |
StartDate |
必要 |
DateTime |
假日的開始日期。開始日期的格式取決於您的 [地區及語言選項]。例如，在美國 2011 年 7 月 4 日的開始日期，其格式會設定如下：-StartDate "7/4/2011 12:00 AM"，這表示假日會在 2011 年 7 月 4 日的 12:00 A.M. 開始。 |
輸入類型
無。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 指令程式建立新的假日，這是一個只存在於記憶體中的「虛擬」假日，之後會儲存在 $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 使用新增的方法將新的假日 ($christmasDay) 新增到假日集 ($y) 的虛擬複本中。接著最後一個命令會呼叫 Set-CsRgsHolidaySet 將變更 (也就是新增假日) 寫入到 ApplicationServer:atl-cs-001.litwareinc.com 服務。