New-CsDialPlan
上次修改主題的時間: 2012-03-27
建立新的撥號對應表。
語法
New-CsDialPlan -Identity <XdsIdentity> [-City <String>] [-Confirm [<SwitchParameter>]] [-CountryCode <String>] [-Description <String>] [-DialinConferencingRegion <String>] [-ExternalAccessPrefix <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-NormalizationRules <PSListModifier>] [-OptimizeDeviceDialing <$true | $false>] [-SimpleName <String>] [-State <String>] [-WhatIf [<SwitchParameter>]]
詳細描述
此指令程式會建立新的撥號對應表 (又稱為位置設定檔)。撥號對應表提供可讓 Enterprise Voice 使用者撥打電話所需的資訊。會議服務員應用程式 也使用撥號對應表來進行撥入式會議。撥號對應表會決定套用哪些正規化規則,以及撥打外線時是否必須撥首碼。
建立撥號對應表時也會自動建立預設的語音正規化規則。您可以呼叫 Set-CsVoiceNormalizationRule 指令程式來修改語音正規化規則,也可以呼叫 New-CsVoiceNormalizationRule 指令程式將新的正規化規則新增至撥號對應表。
誰可以執行此 Cmdlet:下列群組的成員預設會獲授權可以在本機上執行 New-CsDialPlan Cmdlet:RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色),請在 Windows PowerShell 提示字元中執行下列命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsDialPlan"}
參數
參數 | 必要 | 類型 | 描述 |
---|---|---|---|
Identity |
必要 |
XdsIdentity |
指定用來識別撥號對應表之範圍和名稱 (站台)、服務角色和 FQDN 或名稱 (每個使用者) 的唯一識別碼。例如,站台 Identity 是以 site:<sitename> 格式輸入,其中 sitename 是站台的名稱。在服務範圍的撥號對應表必須是登錄器服務或 PSTN 閘道服務,其中的 Identity 值格式如下:Registrar:Redmond.litwareinc.com。個別使用者 Identity 只要以唯一字串值的形式輸入即可。 |
Description |
選用 |
字串 |
此撥號對應表的描述:用途、適用的使用者類型,或有助於識別撥號對應表用途的其他任何資訊。 字元數上限:512 |
DialinConferencingRegion |
選用 |
字串 |
與此撥號對應表相關聯的區域名稱。如果撥號對應表要用於電話撥入式會議,請指定此參數的值。如此可在會議召集人設定會議時讓系統指派正確的存取號碼。您可以呼叫 Get-CsNetworkRegion 指令程式來擷取可用的區域。 字元數上限:512 |
ExternalAccessPrefix |
選用 |
字串 |
一個號碼 (或一組號碼),指定組織外部的電話(例如,若要撥外線,請先按 9)。正規化規則會忽略此首碼,但這些規則會套用至號碼的其餘部分。 OptimizeDeviceDialing 參數必須設為 True,此值才會生效。 此參數必須符合規則運算式 [0-9]{1,4}。這表示它必須是 0 至 9 的值,長度為一至四位數。 預設值:9 |
NormalizationRules |
選用 |
PSListModifier |
套用至此撥號對應表的正規化規則清單。 雖然可以直接使用此 Cmdlet 來建立此清單和這些規則,但建議您使用 New-CsVoiceNormalizationRule Cmdlet 來建立正規化規則,這樣會建立規則並將它指派給指定的撥號對應表。 每次建立新的撥號對應表時,系統會對該站台、服務或個別使用者撥號對應表,建立具有預設設定的新語音正規則化規則。新語音正規化規則的 Identity 預設為撥號對應表的 Identity,後面加上斜線,再加上名稱 Prefix All。例如 site:Redmond/Prefix All。 預設值:{Description=;Pattern=^(\d11)$;Translation=+$1;Name=Prefix All;IsInternalExtension=False } 注意:此預設值只是預留位置。若要讓撥號對應表的實用性高,您應修改撥號對應表建立的正規化規則,或為站台、服務或使用者建立新的規則。您可以呼叫 New-CsVoiceNormalizationRule 指令程式來建立新的正規化規則,呼叫 Set-CsVoiceNormalizationRule 來修改正規化規則。 |
OptimizeDeviceDialing |
選用 |
布林值 |
將此參數設為 True 可將 ExternalAccessPrefix 參數中的前置字元套用至從組織外撥打的電話。唯有在已指定 ExternalAccessPrefix 參數值的情況下才能將這個值設為 True。 預設值:False |
SimpleName |
選用 |
字串 |
撥號對應表的顯示名稱。此名稱在 Lync Server 部署內的所有撥號對應表之間必須是唯一的。 這個字串最長可為 256 個字元。有效字元是字母或數值字元、連字號 (-)、點 (.)、加號 (+)、底線 (_) 和括弧 (())。 此參數必須包含值。然而,如果您未在呼叫 New-CsDialPlan 時提供值,則會提供預設值。通用撥號對應表的預設值是 Prefix All。站台層級撥號對應表的預設值是站台的名稱。服務的預設值是服務 (登錄器服務或 PSTN 閘道服務) 的名稱,後面加上底線,然後再加上服務完整網域名稱 (FQDN)。例如 Registrar_pool0.litwareinc.com。個別使用者撥號對應表的預設值是撥號對應表的 Identity。 |
State |
選用 |
字串 |
此參數不會搭配這個指令程式使用。 |
City |
選用 |
字串 |
此參數不會搭配這個指令程式使用。 |
CountryCode |
選用 |
字串 |
此參數不會搭配這個指令程式使用。 |
Force |
選用 |
切換參數 |
隱藏進行變更前的任何確認提示。 |
InMemory |
選用 |
切換參數 |
建立物件參照,但而不實際將物件認可為永久變更。若將此參數所呼叫的 Cmdlet 輸出指派給變數,將可變更物件參照的屬性,然後呼叫此 Cmdlet 的對應 Set- Cmdlet 認可這些變更。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果,但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。
傳回類型
此指令程式會建立 Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile 類型的物件。
範例
-------------------------- 範例 1 --------------------------
New-CsDialPlan -Identity RedmondDialPlan
範例 1 所示的命令會建立 Identity 為 RedmondDialPlan 的新撥號對應表(如果 Identity 值中缺少範圍,則表示這是個別使用者原則。個別使用者範圍中建立的撥號對應表可以直接指派給使用者和群組)。撥號對應表的所有其他屬性會指派預設值。
-------------------------- 範例 2 --------------------------
New-CsDialPlan -Identity site:Redmond -SimpleName RedmondSiteDialPlan
New-CsVoiceNormalizationRule -Identity "site:Redmond/SeattlePrefix" -Pattern "^9(\d*){1,5}$" -Translation "+1206$1"
範例 2 所示的命令會建立其 Identity 為 site:Redmond 的新撥號對應表 (這表示撥號對應表會套用到 Redmond 站台上未指派有個別使用者或服務層級撥號對應表的所有使用者) 與 SimpleName RedmondSiteDialPlan。範例中的下一行接著會建立與該對應表相關聯的新正規化規則。儘管已針對撥號對應表建立預設的正規化規則,但在大部分的情況下這都是為預留位置而建立的 - 值的用途有限。因此,在呼叫 New-CsDialPlan 指令程式來建立新的撥號對應表之後,您應該呼叫 New-CsVoiceNormalizationRule 以建立適用於組織的具名規則。這就是此範例第 2 行的確實用途:呼叫 New-CsVoiceNormalizationRule 為 Redmond 站台建立名為 SeattlePrefix 的規則,並指定規則的 Pattern 和 Translation 內容。不需要採取其他步驟來修改撥號對應表;對正規化規則所進行的變更會自動套用至識別符合正規化規則的撥號對應表(Identity 的 site:Redmond 部分符合撥號對應表 Identity;SeattlePrefix 是正規化規則的名稱。多個正規化規則可以套用至一個撥號對應表,因此每一個正規化規則在指定的範圍內都需要唯一的名稱)。
-------------------------- 範例 3 --------------------------
New-CsDialPlan -Identity RedmondDialPlan -Description "Dial plan for Redmond users"
範例 3 所示的命令會建立 Identity 為 RedmondDialPlan 的新撥號對應表,並指定 Description 來說明撥號對應表的用途為何(個別使用者範圍中建立的撥號對應表可以直接指派給使用者和群組)。其他所有參數中會指派預設值。