Set-CsDialPlan
上次修改主題的時間： 2012-03-27
修改現有的撥號對應表。
語法
Set-CsDialPlan [-Identity <XdsIdentity>] [-City <String>] [-Confirm [<SwitchParameter>]] [-CountryCode <String>] [-Description <String>] [-DialinConferencingRegion <String>] [-ExternalAccessPrefix <String>] [-Force <SwitchParameter>] [-NormalizationRules <PSListModifier>] [-OptimizeDeviceDialing <$true | $false>] [-SimpleName <String>] [-State <String>] [-WhatIf [<SwitchParameter>]]
Set-CsDialPlan [-City <String>] [-Confirm [<SwitchParameter>]] [-CountryCode <String>] [-Description <String>] [-DialinConferencingRegion <String>] [-ExternalAccessPrefix <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-NormalizationRules <PSListModifier>] [-OptimizeDeviceDialing <$true | $false>] [-SimpleName <String>] [-State <String>] [-WhatIf [<SwitchParameter>]]
詳細描述
此指令程式會修改現有的撥號對應表 (又稱為位置設定檔)。撥號對應表提供可讓 Enterprise Voice 使用者撥打電話所需的資訊。會議服務員應用程式 也使用撥號對應表來進行撥入式會議。撥號對應表會決定套用哪些正規化規則，以及撥打外線時是否必須撥首碼。
附註：雖然可以使用這個指令程式來修改撥號對應表的正規化規則，不過建議您改用 New-CsVoiceNormalizationRule、Set-CsVoiceNormalizationRule 或 Remove-CsVoiceNormalizationRule 指令程式。使用那些指令程式所進行的變更會反映在對應的撥號對應表中。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsDialPlan Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsDialPlan"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
字串 |
指定範圍，或指定各使用者對應表名稱之唯一識別碼，以識別您要修改的撥號對應表。例如，站台 Identity 是以 site:<sitename> 格式輸入，其中 sitename 是站台的名稱。在服務範圍的撥號對應表將是登錄器服務或 PSTN 閘道服務，其中的 Identity 值格式如下：Registrar:Redmond.litwareinc.com。個別使用者 Identity 將是唯一的字串值。 |
Instance |
選用 |
LocationProfile |
允許您將物件參照傳遞給 Cmdlet，而不設定個別參數值。您可以呼叫 Get-CsDialPlan 指令程式，來擷取此物件參考。 |
Description |
選用 |
字串 |
此撥號對應表的描述：用途、適用的使用者類型，或有助於識別撥號對應表用途的其他任何資訊。 字元數上限：512 |
DialinConferencingRegion |
選用 |
字串 |
與此撥號對應表相關聯的區域名稱。如果撥號對應表要用於電話撥入式會議，請指定此參數的值。如此可在會議召集人設定會議時讓系統指派正確的存取號碼。您可以呼叫 Get-CsNetworkRegion 指令程式來擷取可用的區域。 字元數上限：512 |
ExternalAccessPrefix |
選用 |
字串 |
一個號碼 (或一組號碼)，指定組織外部的電話(例如，若要撥外線，請先按 9)。正規化規則會忽略此首碼，但這些規則會套用至號碼的其餘部分。 OptimizeDeviceDialing 參數必須設為 True，此值才會生效。 此參數的值必須符合規則運算式 [0-9]{1,4}。這表示它必須是長度為一至四位數的值，每個數字必須是 0 至 9 的數字。 |
NormalizationRules |
選用 |
PSListModifier |
套用至此撥號對應表的正規化規則清單。 雖然可以直接使用此指令程式來修改此清單和這些規則，但建議您使用 New-CsVoiceNormalizationRule 指令程式來建立正規化規則，這樣會建立規則並將它指派給指定的撥號對應表，並利用 Set-CsVoiceNormalizationRule 指令程式來修改他們。 |
OptimizeDeviceDialing |
選用 |
布林值 |
將此參數設為 True 可將 ExternalAccessPrefix 參數中的前置字元套用至從組織外撥打的電話。唯有在已指定 ExternalAccessPrefix 參數值的情況下才能將這個值設為 True。 |
SimpleName |
選用 |
字串 |
撥號對應表的易記名稱。撥號對應表名稱在 Microsoft Lync Server 2010 部署內的所有撥號對應表之間必須是唯一的。 這個字串最長可為 256 個字元。有效字元是字母或數值字元、連字號 (-)、點 (.)、加號 (+)、底線 (_) 和括弧 (())。 |
State |
選用 |
字串 |
此參數不會搭配這個指令程式使用。 |
City |
選用 |
字串 |
此參數不會搭配這個指令程式使用。 |
CountryCode |
選用 |
字串 |
此參數不會搭配這個指令程式使用。 |
Force |
選用 |
切換參數 |
隱藏進行變更前的任何確認提示。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile 物件。接受撥號對應表物件管線傳送的輸入。
傳回類型
Set-CsDialPlan 不會傳回值或物件。而是指令程式會設定 Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Set-CsDialPlan -Identity RedmondDialPlan -Description "This plan is for Redmond-based users only."
在範例 1 中，Set-CsDialPlan 可用來修改 Identity 為 RedmondDialPlan 的撥號對應表。在此例中，唯一修改的屬性是 Description；修改方式是指定 Description 參數，後面加上新描述的文字。
-------------------------- 範例 2 --------------------------
Get-CsDialPlan | Set-CsDialPlan -ExternalAccessPrefix 8
在這個範例中，使用了 Set-CsDialPlan 變更設定用於組織之所有撥號對應表的 ExternalAccessPrefix 屬性值。為了執行這項作業，命令會先使用 Get-CsDialPlan 傳回組織中所有撥號對應表的集合。然後將該集合傳送至 Set-CsDialPlan，它會為集合中每個設定檔的 ExternalAccessPrefix 屬性指定值 8。