New-CsVoiceTestConfiguration
上次修改主題的時間： 2012-03-27
建立測試案例，您可以用此案例對指定的路由和規則測試電話號碼。
語法
New-CsVoiceTestConfiguration -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-DialedNumber <String>] [-ExpectedRoute <String>] [-ExpectedTranslatedNumber <String>] [-ExpectedUsage <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-TargetDialplan <String>] [-TargetVoicePolicy <String>] [-WhatIf [<SwitchParameter>]]
New-CsVoiceTestConfiguration -Name <String> [-Confirm [<SwitchParameter>]] [-DialedNumber <String>] [-ExpectedRoute <String>] [-ExpectedTranslatedNumber <String>] [-ExpectedUsage <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-TargetDialplan <String>] [-TargetVoicePolicy <String>] [-WhatIf [<SwitchParameter>]]
詳細描述
在實作語音路由和語音原則之前，最好先以不同的電話號碼來測試，以確保結果符合您的預期。可以使用這個指令程式建立測試案例以執行此測試。
New-CsVoiceTestConfiguration 指令程式會定義語音路由、使用方式、撥號對應表和據以測試指定之電話號碼的語音原則。此資訊的所有相關資訊都可使用其他指令程式來定義和擷取；請參閱本主題的參數描述，以取得詳細資訊。
使用此指令程式所建立的設定可透過 Test-CsVoiceTestConfiguration 指令程式來測試。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsVoiceTestConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsVoiceTestConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
XdsGlobalRelativeIdentity |
唯一識別此一測試案例的字串。 這個字串最多可以有 32 個字元，並可包含任何英數字元，加上反斜線 (\)、句點 (.) 或底線 (_)。 此參數的值不含範圍，因為此物件只能在全域範圍上建立。因此，只需要唯一名稱。 |
Name |
必要 |
字串 |
這個參數包含與 Identity 相同的值。如果指定了 Identity 參數，則不能在命令中包含 Name 參數。同樣地，如果指定了 Name 參數，則不能指定 Identity。 |
DialedNumber |
選用 |
字串 |
您要用來測試原則、使用方式等的電話號碼。 必須是 512 個或更少的字元。 預設值：1234 |
ExpectedRoute |
選用 |
字串 |
預期在設定測試期間使用的語音路由名稱。如果使用不同的路由，根據目標撥號對應表和語音原則，測試將會失敗。您可以呼叫 Get-CsVoiceRoute 指令程式來擷取可用的語音路由。 必須是 256 個或更少的字元。 |
ExpectedTranslatedNumber |
選用 |
字串 |
以您預期在轉換之後的格式所呈現的電話號碼。這是正規化之後 DialedNumber 參數的值。如果您執行 Test-CsVoiceTestConfiguration，而 DialedNumber 並未產生 ExpectedTranslatedNumber 中的值，則測試會報告為 Fail。 必須是 512 個或更少的字元。 預設值：+1234 |
ExpectedUsage |
選用 |
字串 |
預期在設定測試期間使用的 PSTN 使用方式的名稱。如果使用不同的 PSTN 使用方式，根據目標撥號對應表和語音原則，測試將會失敗。您可以呼叫 Get-CsPstnUsage 來擷取可用的使用方式。 必須是 256 個或更少的字元。 |
TargetDialplan |
選用 |
字串 |
要用於此測試之撥號對應表的 Identity。您可以呼叫 Get-CsDialPlan 指令程式來擷取撥號對應表。 必須是 40 個或更少的字元。 預設值：全球 |
TargetVoicePolicy |
選用 |
字串 |
據以執行此測試之語音原則的 Identity。您可以呼叫 Get-CsVoicePolicy 來擷取語音原則。 必須是 40 個或更少的字元。 預設值：全球 |
Force |
選用 |
切換參數 |
隱藏任何會在進行變更之前顯示的確認提示。 |
InMemory |
選用 |
切換參數 |
建立物件參照，但而不實際將物件認可為永久變更。若將此參數所呼叫的 Cmdlet 輸出指派給變數，將可變更物件參照的屬性，然後呼叫此 Cmdlet 的對應 Set- Cmdlet 認可這些變更。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。
傳回類型
此指令程式會建立 Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration 類型的物件
範例
-------------------------- 範例 1 --------------------------
New-CsVoiceTestConfiguration -Identity TestConfig1
這個範例會以預設值建立 Identity 為 TestConfig1 的新語音測試設定。
-------------------------- 範例 2 --------------------------
New-CsVoiceTestConfiguration TestConfig1 -TargetDialplan site:Redmond1
這個範例會建立名為 TestConfig1 的新語音測試設定，並將 TargetDialplan 參數設定為 site:Redmond1。這會產生預計針對網站 Redmond1 的撥號對應表設定執行的號碼、使用方式和路由的測試。
我們在這個範例中宣告 TestConfig1，但不指定 Identity 參數。由於 Identity 是位置參數，因此指令程式會將命令中的指令程式名稱後的第一個值辨識為 Identity。
-------------------------- 範例 3 --------------------------
New-CsVoiceTestConfiguration -Identity TestConfig1 -DialedNumber 5551212 -ExpectedTranslatedNumber +5551212
這個範例會建立名為 TestConfig1 的新語音測試設定。這個設定會使用預設值測試 DialedNumber 5551212，預計的輸出 (ExpectedTranslatedNumber) 為 +5551212。此預期根據將在針對這個物件執行測試時使用的撥號對應表關聯的正規化規則為基礎。必須使用 Test-CsVoiceTestConfiguration 指令程式執行該測試。