Get-CsDialPlan
上次修改主題的時間： 2012-03-23
傳回組織所使用的撥號對應表相關資訊。
語法
Get-CsDialPlan [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsDialPlan [-Filter <String>] [-LocalStore <SwitchParameter>]
詳細描述
這個指令程式會傳回組織中一或多個撥號對應表 (也稱為位置設定檔) 的相關資訊。撥號對應表提供可讓 Enterprise Voice 使用者撥打電話所需的資訊。會議服務員應用程式 也使用撥號對應表來進行撥入式會議。撥號對應表會決定套用哪些正規化規則，以及撥打外線時是否必須撥首碼。
附註：您可以使用 Get-CsDialPlan 來擷取有關撥號對應表之正規化規則的特定資訊，但如果這是您唯一需要的撥號對應表資訊，也可以使用 Get-CsVoiceNormalizationRule 指令程式。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsDialPlan Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsDialPlan"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
XdsIdentity |
指定範圍的唯一識別碼，以及針對個別使用者範圍指定名稱，以識別您要擷取的撥號對應表。 |
Filter |
選用 |
字串 |
執行萬用字元搜尋，它允許您將結果縮減為只有 Identity 符合指定萬用字元字串的撥號對應表。 |
LocalStore |
選用 |
切換參數 |
從 中央管理存放區 的本機複本擷取撥號對應表資訊，而非從 中央管理存放區 本身擷取。 |
輸入類型
無。
傳回類型
此指令程式會傳回 Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Get-CsDialPlan
範例 1 會傳回設定來供組織使用的所有撥號對應表集合，方法是呼叫 Get-CsDialPlan 且不指定任何其他參數。
-------------------------- 範例 2 --------------------------
Get-CsDialPlan -Identity RedmondDialPlan
在範例 2 中，會使用 Identity 參數，將擷取的資料限制為擁有 Identity 為 RedmondDialPlan 之個別使用者撥號對應表的撥號對應表。由於識別身分必須是唯一的，所以此命令只會傳回指定的撥號對應表。
-------------------------- 範例 3 --------------------------
Get-CsDialPlan -Identity site:Redmond
範例 3 與範例 2 相同，但有個例外：我們不會擷取個別使用者撥號對應表，而是會擷取指派給站台的撥號對應表。我們藉由指定 site: 值，後面加上要擷取之站台的站台名稱 (在此例中為 Redmond)，來完成此動作。
-------------------------- 範例 4 --------------------------
Get-CsDialPlan -Filter tag:*
本例使用 Filter 參數來傳回已在個別使用者範圍上設定之所有撥號對應表的集合 (設定於個別使用者 (或標籤) 範圍上的設定，可直接指派給使用者和群組)。萬用字元字串 tag:* 會指示指令程式只傳回其識別身分開頭為字串值 tag: 的撥號對應表，這會將撥號對應表識別為個別使用者撥號對應表。
-------------------------- 範例 5 --------------------------
Get-CsDialPlan | Select-Object -ExpandProperty NormalizationRules
本範例會顯示已設定為供組織使用之撥號對應表所使用的正規化規則。由於 NormalizationRules 屬性會包含物件的陣列，所以螢幕上通常不會顯示一組完整的正規化規則。為了看到所有這類規則，此範例命令會先使用 Get-CsDialPlan 來擷取所有撥號對應表的集合。然後將該集合傳送到 Select-Object 指令程式；接著，使用 Select-Object 的 ExpandProperty 參數來「展開」在 NormalizationRules 屬性中找到的值。展開值只是表示所有正規化規則都會單獨列於螢幕上，如果當初呼叫 Get-CsVoiceNormalizationRule，使用者會看到相同的輸出結果。
-------------------------- 範例 6 --------------------------
Get-CsDialPlan | Where-Object {$_.Description -match "Redmond"}
在範例 6 中，Get-CsDialPlan 和 Where-Object 可用來擷取描述中包含 Redmond 這個字的所有撥號對應表集合。為達成此目的，命令會先使用 Get-CsDialPlan 擷取所有撥號對應表。該集合便會傳送至 Where-Object，它會套用篩選器，將傳回的資料限制為 Description 中包含 Redmond 這個字的設定檔。