Get-CsRgsHoursOfBusiness
上次修改主題的時間： 2012-03-23
擷取設定用於組織的回應群組營業時間集合相關資訊。營業時間集合用於指出回應群組專員一般會在一星期的哪幾天和哪些時段接聽來電。
語法
Get-CsRgsHoursOfBusiness [-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.)。
Get-CsRgsHoursOfBusiness 指令程式能讓您擷取設定用於組織的營業時間集合相關資訊。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsRgsHoursOfBusiness Cmdlet：RTCUniversalServerAdmins、RTCUniversalReadOnlyAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsRgsHoursOfBusiness"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
Rgs 識別 |
表示主控營業時間集合的服務識別，或是集合本身的完整識別。如果您有指定服務識別 (例如 service:ApplicationServer:atl-cs-001.litwareinc.com)，將會傳回位於該服務的所有營業時間集合。如果您有指定集合的識別，則只會傳回指定的營業時間集合。請注意，營業時間集合的識別是由服務識別後面加上全域唯一識別碼 (GUID) 所組成，例如：service:ApplicationServer-1/1987d3c2-4544-489d-bbe3-59f79f530a83. 還有另一種方法可傳回單一營業時間集合，就是指定服務識別，然後再加上 Name 參數和集合名稱。這可讓您不必知道指派給集合的 GUID 為何，就能擷取特定的營業時間集合。 如果不使用任何參數呼叫，Get-CsRgsHoursOfBusiness 會傳回設定用於組織的所有營業時間集合。 |
Name |
選用 |
字串 |
建立營業時間集合時指定給該集合的唯一名稱。 |
輸入類型
無。Get-CsRgsHoursOfBusiness 不接受管線傳送的輸入。
傳回類型
傳回 Microsoft.Rtc.Rgs.Management.WritableSettings.BusinessHours 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Get-CsRgsHoursOfBusiness
範例 1 傳回已設定用於組織的所有營業時間集合的相關資訊。作法是呼叫 Get-CsRgsHoursOfBusiness 且不加上任何參數。
-------------------------- 範例 2 ------------------------
Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com"
範例 2 所示的命令傳回已設定用於 atl-cs-001.litwareinc.com 的所有營業時間集合。
-------------------------- 範例 3 ------------------------
Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "Help Desk Business Hours"
上述命令從 atl-cs-001.litwareinc.com 傳回營業時間的單一集合：Name 為 "Help Desk Business Hours" 的集合。
-------------------------- 範例 4 ------------------------
Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Where-Object {$_.SundayTimeRange1 -ne $Null -or $_.SundayTimeRange2 -ne $Null}
上述命令會傳回所有營業時間設定為星期天的營業時間集合。為了執行這項作業，命令會先呼叫 Get-CsRgsHoursOfBusiness，傳回在 atl-cs-001.litwareinc.com 上找到的所有營業時間集合。此資料接著傳送到 Where-Object 指令程式，此指令程式只選取符合下列兩個準則之一的項目：SundayTimeRange1 屬性不等於 Null 值和/或 SundayTimeRange2 屬性不等於 Null 值如果時間範圍屬性不是 Null，即表示已為該時段設定營業時間。
-------------------------- 範例 5 ------------------------
Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Where-Object {$_.MondayTimeRange1.OpenTime -le "08:00:00"}
範例 5 所示的命令會從 atl-cs-001.litwareinc.com 傳回所有營業時間集合，其中 MondayTimeRange1 內容的開啟時間等於 (或早於) 8:00 A.M。為此，命令先使用 Get-CsRgsHoursOfBusiness，從 atl-cs-001.litwareinc.com 傳回所有營業時間集合。接著，此資料傳送到 Where-Object 指令程式，此指令程式只選取 MondayTimeRange1.OpenTime 內容的值小於或等於 8:00 A.M. (08:00:00) 的集合。
-------------------------- 範例 6 ------------------------
Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Where-Object {$_.Custom -eq $False}
範例 6 所示的命令會傳回所有公用的營業時間集合，亦即可以在工作流程之間共用的集合。為達成此目的，命令先使用 Get-CsRgsHoursOfBusiness 傳回 atl-cs-001.litwareinc.com 上找到的所有營業時間集合。然後，此資料便會傳送到 Where-Object 指令程式，此指令程式只挑選出 Custom 內容等於 False 的集合。