New-CsVoiceRoute
上次修改主題的時間： 2012-03-26
建立新的語音路由。語音路由包含一些指示，告知 Microsoft Lync Server 2010 如何將 Enterprise Voice 使用者的來電轉接至公用交換電話網路 (PSTN) 或專用交換機 (PBX) 上的電話號碼。
語法
New-CsVoiceRoute -Identity <XdsGlobalRelativeIdentity> [-AlternateCallerId <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-NumberPattern <String>] [-Priority <Int32>] [-PstnGatewayList <PSListModifier>] [-PstnUsages <PSListModifier>] [-SuppressCallerId <Nullable>] [-WhatIf [<SwitchParameter>]]
New-CsVoiceRoute -Name <String> [-AlternateCallerId <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-NumberPattern <String>] [-Priority <Int32>] [-PstnGatewayList <PSListModifier>] [-PstnUsages <PSListModifier>] [-SuppressCallerId <Nullable>] [-WhatIf [<SwitchParameter>]]
詳細描述
使用此指令程式來建立新的語音路由。所有語音路由都是在全域範圍上建立。不過，可以定義多個通用語音路由。作法是透過 Identity 參數，此參數需要唯一路由名稱。
語音路由透過 PSTN 使用方式與語音原則產生關聯。語音路由包含規則運算式，可識別將經由指定的語音路由來轉接的電話號碼：符合規則運算式的電話號碼會經由此路由來轉接。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsVoiceRoute Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsVoiceRoute"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
XdsIdentity |
可唯一識別語音路由的名稱。語音路由只能在全域範圍上定義，所以 Identity 只是您要提供給路由的名稱(路由名稱中可以包含空格，例如 Test Route，但是在呼叫 New-CsVoiceRoute 時，必須以雙引號括住整個字串)。 如果已指定 Identity，Name 必須保留空白。Identity 的值會指派給 Name。 |
Name |
必要 |
字串 |
語音路由的唯一名稱。如果設定此參數，值會自動套用至語音路由 Identity。您不能同時指定 Identity 和 Name。 |
AlternateCallerId |
選用 |
字串 |
如果 SuppressCallerId 參數設為 True，則會顯示 AlternateCallerId 參數的值以接收各通話方，而非來電者的實際號碼。此號碼應該為有效號碼，且可用來代表組織內的部門，例如「支援」或「人力資源」。 如果 SuppressCallerId 參數設為 False，則會忽略 AlternateCallerId 參數。 此值必須符合規則運算式 (\+)?[1-9]\d*(;ext=[1-9]\d*)?。換言之，值的開頭可以是加號 (+)，但不一定必須是加號；必須由任何數目的數字組成；後面可以接著以 ;ext= 開頭的分機，最後再接著任何數目的數字(請注意，如果加入分機，則必須以雙引號括住字串)。 |
Description |
選用 |
字串 |
此語音路由用途的描述。 |
NumberPattern |
選用 |
字串 |
指定套用此路由之電話號碼的規則運算式。符合此模式的號碼將根據其餘路由設定來轉接。 預設值：[0-9]{10} |
Priority |
選用 |
Int32 |
數字可解析至多個語音路由。如果有多個路由，則優先順序可決定套用路由的順序。 |
PstnGatewayList |
選用 |
PSListModifier |
在 Lync Server 2010 中，一個 中繼伺服器 可以與多個閘道產生關聯。此參數包含與此語音路由相關聯的閘道清單。此清單的每一個成員必須是 PSTN 閘道或 中繼伺服器 的服務識別碼。唯有在針對 Microsoft Office Communications Server 2007 或 Microsoft Office Communications Server 2007 R2 設定中繼伺服器後，此值才能參照中繼伺服器。對於 Lync Server 2010，PSTN 閘道是必須要使用的項目。Identity 服務是 <ServiceRole>:<FQDN> 格式的字串，其中 ServiceRole 為服務角色 (PSTNGateway) 的名稱，FQDN 是集區的完整網域名稱 (FQDN)，或該伺服器的 IP 位址。例如，PSTNGateway:redmondpool.litwareinc.com. Service 識別可透過呼叫 Get-CsService | Select-Object Identity 命令來擷取。 此清單預設為空白。但如果您在建立新語音路由時將此參數保留空白，則會收到警告訊息。 |
PstnUsages |
選用 |
PSListModifier |
可套用至此語音路由的 PSTN 使用方式 (例如 Local 或 Long Distance 等)。PSTN 使用方式必須是現有的使用方式(您可以呼叫 Get-CsPstnUsage 指令程式來擷取 PSTN使用方式)。 此清單預設為空白。但如果您在建立新語音路由時將此參數保留空白，則會收到警告訊息。 |
SuppressCallerId |
選用 |
布林值 |
決定是否在撥出電話上顯示來電者的識別碼。如果此參數設為 True，則會隱藏來電者識別碼。將會顯示 AlternateCallerId 的值，而非實際識別碼。當 SuppressCallerId 設為 True 時，必須提供 AlternateCallerId 的值。 |
Force |
選用 |
切換參數 |
隱藏任何會在進行變更之前顯示的確認提示。 |
InMemory |
選用 |
SwitchParmeter |
建立物件參照，但而不實際將物件認可為永久變更。若將此參數所呼叫的 Cmdlet 輸出指派給變數，將可變更物件參照的屬性，然後呼叫此 Cmdlet 的對應 Set- Cmdlet 認可這些變更。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
字串 |
執行命令前先要求您確認。 |
輸入類型
無。
傳回類型
建立 Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route 類型的物件。
範例
-------------------------- 範例 1 --------------------------
New-CsVoiceRoute -Identity Route1
此範例中的命令會建立 Identity 為 Route1 的新語音路由。其他所有屬性會設為預設值。
-------------------------- 範例 2 --------------------------
New-CsVoiceRoute -Identity Route1 -PstnUsages @{add="Long Distance"} -PstnGatewayList @{add="PstnGateway:redmondpool.litwareinc.com"}
此範例中的命令會建立 Identity 為 Route1 的新語音路由。它也會將為 Long Distance 的 PSTN 使用方式新增至使用方式清單，將 PstnGateway:redmondpool.litwareinc.com 服務 ID 新增至 PSTN 閘道清單。
-------------------------- 範例 3 --------------------------
$x = (Get-CsPstnUsage).Usage
New-CsVoiceRoute -Identity Route1 -PstnUsages @{add=$x}
此範例會建立名為 Route1 的新語音路由，並在路由的 PSTN 使用方式清單中填入組織的所有現有使用方式。此範例的第一個命令會擷取通用 PSTN 使用方式的清單。請注意，Get-CsPstnUsage 的呼叫會以括弧括住，表示我們先擷取包含 PSTN 使用方式資訊的物件(因為只有一個通用 PSTN 使用方式，只會擷取一個物件)。命令接著擷取此物件的 Usage 屬性。該屬性 (包含使用方式清單) 會指派給 $x 變數。在此範例的第二行中，會呼叫 New-CsVoiceRoute 以建立新的語音路由。此語音路由的識別為 Route1。請注意傳遞給 PstnUsages 參數的值：@{add=$x}。此值表示將 $x 的內容 (包含在線路 1 中擷取的電話使用方式清單) 新增到此路由的 PSTN 使用方式清單。