New-CsRgsHolidaySet
上次修改主題的時間： 2012-03-23
建立新的回應群組假日集。回應群組假日集是假日的集合。例如，您可以擁有一個美國佇列的假日集 (集合中可將美國獨立紀念日包含為假日)，以及另一個法國佇列的假日集。後者佇列可定義法國革命紀念日為假日，而非美國獨立紀念日。
語法
New-CsRgsHolidaySet -Parent <RgsIdentity> -HolidayList <Collection> -Name <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
為了提供給來電者最佳的服務經驗，回應群組應用程式 讓您可以清楚定義回應群組專員何時可接聽電話，何時無法接聽電話。透過 回應群組應用程式，您可以定義營業時間，這些營業時間指出專員在一星期的哪幾天和哪些時段可接聽來電。例如，如果您組織的營業時間是星期一到星期五的 9:00 A.M. 到 5:00 P.M.，那麼您可以設定營業時間中顯示專員會在星期一到星期五的 9:00 A.M. 到 5:00 P.M. 接聽來電 (以及該分機專員無法接聽來電的時間，例如星期四 8:00 P.M. 或星期天 2:30 P.M.)。
不過，許多組織也有例外的典型工作週；例如，美商組織可能選在聖誕節或感恩節放假。為了顧及非典型的公休日，回應群組應用程式 可讓您將某幾天指定為假日：也就是當組織通常應該營業，但因任何原因而沒有營業的日子。將使用 New-CsRgsHoliday 指令程式建立的個別假日收集在假日集中；例如，美國的假日可收集在名為 US_Holidays 的假日集中，而日本的假日可收集在名為 Japanese_Holidays 的假日集中。一旦收集完成，便可以將假日和對應的假日集指派至回應群組工作流程。
New-CsRgsHolidaySet 指令程式提供讓您設定用於組織之新假日集的方法。請注意，當您建立新的假日集時，必須至少包含一個假日；您必須使用 New-CsRgsHoliday 指令程式來建立個別的假日。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsRgsHolidaySet Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsRgsHolidaySet"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
HolidayList |
必要 |
假日物件集合 |
要新增至假日集的一或多個假日。您必須使用 New-CsRgsHoliday 指令程式來建立假日，並儲存在物件參考中。然後，這些物件參考會傳遞至 Holidays 參數，以便將假日新增至假日集。例如，此命令會建立名為 “新年”的假日，並將產生的值儲存在名為 $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-CsRgsHoliday，以針對新年建立假日。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)