Get-CsRgsHolidaySet
上次修改主題的時間： 2012-03-23
傳回設定用於組織的回應群組假日集相關資訊。回應群組假日集是假日的集合。例如，您可以擁有一個美國佇列的假日集 (集合中可將美國獨立紀念日包含為假日)，以及另一個法國佇列的假日集。後者佇列可定義法國革命紀念日為假日，而非美國獨立紀念日。
語法
Get-CsRgsHolidaySet [-Identity <RgsIdentity>] [-Name <String>]
詳細描述
為了提供給來電者最佳的服務經驗，回應群組應用程式讓您可以清楚定義回應群組專員何時可接聽電話，何時無法接聽電話。透過回應群組應用程式，您可以定義營業時間，這些時間指出專員在一星期的哪幾天和那些時段可接聽來電。例如，如果您組織的營業時間是星期一到星期五的 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 的假日集中。收集完成後，假日集便可以指派至回應群組工作流程。
Get-CsRgsHolidaySet 提供方法讓您傳回設定用於組織的回應群組假日集的相關資訊。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsRgsHolidaySet Cmdlet：RTCUniversalServerAdmins、RTCUniversalReadOnlyAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsRgsHolidaySet"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
Rgs 識別 |
表示在主控假日集之服務的 Identity，或是假日集的完整 Identity。如果您指定服務識別 (例如，service:ApplicationServer:atl-cs-001.litwareinc.com)，則會傳回該服務託管的所有假日集。如果您指定假日集的識別，則只會傳回指定的假日集。請注意，假日集的識別由服務識別組成，後面加上全域唯一識別碼 (GUID)；例如：service:ApplicationServer:atl-cs-001.litwareinc.com/1987d3c2-4544-489d-bbe3-59f79f530a83. 還有另一種方法可傳回單一假日集，就是指定服務識別，然後再包含後面加上假日集名稱的 Name 參數。這可讓您不必知道指派給該集的 GUID 為何，就能擷取特定的假日集。 如果不使用任何參數呼叫，Get-CsRgsHolidaySet 會傳回設定用於組織的所有假日集。 |
Name |
選用 |
字串 |
建立集時給予假日集的唯一名稱。 |
輸入類型
無。Get-CsRgsHolidaySet 不接受管線傳送的輸入。
傳回類型
Get-CsRgsHolidaySet 會傳回 Microsoft.Rtc.Rgs.Management.WritableSettings.HolidaySet 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Get-CsRgsHolidaySet
上述命令傳回已設定在組織中使用的所有假日集的相關資訊。
-------------------------- 範例 2 ------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com"
範例 2 所示的命令會傳回為 ApplicationServer:atl-cs-001.litwareinc.com 服務設定的所有假日集。
-------------------------- 範例 3 ------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "2010 Holidays"
在範例 3 中，會傳回 ApplicationServer:atl-cs-001.litwareinc.com 服務的單一假日集：Name 為 "2010 Holidays" 的假日集。因為每個服務的名稱必須是唯一的，所以這個命令永遠不會傳回多個項目。
-------------------------- 範例 4 ------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "2010 Holidays"| Select-Object -ExpandProperty HolidayList
範例 4 會顯示在 "2010 Holidays" 假日集 (位於 ApplicationServer:atl-cs-001.litwareinc.com 服務) 中的假日集詳細資訊。為了執行這項作業，命令會先使用 Get-CsRgsHolidaySet 擷取指定的假日集。此假日集接著傳送至 Select-Object 指令程式，此指令程式使用 ExpandProperty 參數來顯示此集合中每個假日的詳細資訊。
-------------------------- 範例 5 ------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Select-Object Identity -ExpandProperty HolidayList | Where-Object {$_.Name -eq "Christmas Day"} | ForEach-Object {Get-CsRgsHolidaySet -Identity $_.Identity}
範例 5 所示的命令會報告 ApplicationServer:atl-cs-001.litwareinc.com 上每個包含名為 Christmas Day 之假日的假日集識別。為了執行這項作業，命令會先呼叫 Get-CsRgsHolidaySet，傳回在 ApplicationServer:atl-cs-001.litwareinc.com 上找到的所有假日集集合。此集合接著會被傳送至 Select-Object，這會執行兩件事情：第一是選取 Identity 屬性，第二則是展開 HolidayList 屬性。
這兩項資訊 (Identity 和 HolidayList 內容的展開值) 接著傳送至 Where-Object 指令程式；接著，Where-Object 會挑出假日 Name 等於 Christmas Day 的項目。最後，篩選後的集合會傳送到 ForEach-Object 指令程式。此指令程式會取得集合中的每個識別，然後一個接一個的使用 Get-CsRgsHolidaySet 來擷取對應的假日集。整體效果是顯示所有包含名為 Christmas Day 之假日的假日集。