Test-CsVoicePolicy
上次修改主題的時間： 2012-03-26
測試電話號碼的語音原則，並判斷針對該號碼的該原則會使用哪一個語音路由。
語法
Test-CsVoicePolicy -TargetNumber <PhoneNumber> -VoicePolicy <VoicePolicy> [-Force <SwitchParameter>] [-RouteSettings <PstnRoutingSettings>]
詳細描述
語音原則透過公用交換電話網路 (PSTN) 使用方式而與語音路由產生關聯。已被指派特定語音原則之使用者所撥打的電話，只能透過具有符合該原則之使用方式的 PSTN 使用方式的路由，以及符合所撥出號碼的號碼模式來傳送。呼叫 Test-CsVoicePolicy Cmdlet 來判斷哪一個路由 (如果有的話) 會用來路由傳送擁有特定語音原則之使用者的來電，並判斷將原則繫結至路由的電話使用方式。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Test-CsVoicePolicy Cmdlet：RTCUniversalServerAdmins。若要傳回指派給該指令程式的所有角色型存取控制 (RBAC) 角色清單 (包括您自己建立的任何自訂 RBAC 角色)，請在 Windows PowerShell 提示中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsVoicePolicy"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
TargetNumber |
必要 |
電話號碼 |
據以執行測試的電話號碼。此號碼應該採用 E.164 格式 (例如 +14255551212)。 完整資料類型：Microsoft.Rtc.Management.Voice.PhoneNumber |
VoicePolicy |
必要 |
語音原則 |
要針對其執行測試之語音原則物件的參考。您可以呼叫 Get-CsVoicePolicy 指令程式來擷取語音原則物件。 完整資料類型：Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoicePolicy |
RouteSettings |
選用 |
PSTN 路由設定 |
據以執行測試的路由設定。您可以透過呼叫 Get-CsRoutingConfiguration 指令程式來擷取路由設定。 完整資料類型：Microsoft.Rtc.Management.WritableConfig.Policy.Voice.PstnRoutingSettings |
Force |
選用 |
切換參數 |
隱藏當執行 Cmdlet 時可能發生的任何確認提示或非嚴重錯誤訊息。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoicePolicy 物件。接受管線傳送的語音原則物件輸入。
傳回類型
傳回 Microsoft.Rtc.Management.Voice.VoicePolicyTestResult 類型的物件。
範例
-------------------------- 範例 1 --------------------------
Get-CsVoicePolicy -Identity site:Redmond | Test-CsVoicePolicy -TargetNumber "+14255559999"
此範例會針對 Identity 為 site:Redmond 的語音原則執行語音原則測試。首先會執行 Get-CsVoicePolicy 指令程式擷取 Identity 為 site:Redmond 的原則。接著，該原則物件會傳送到 Test-CsVoicePolicy 指令程式，以電話號碼 +14255559999 來測試該原則。其輸出將會是具有符合 TargetNumber 值之電話模式，並具有符合原則中電話使用方式之電話使用方式的第一個語音路由 (根據路由的 Priority 屬性)。如果找不到符合的路由 (例如，如果號碼模式符合 11 位數模式，而您提供的是 7 位數號碼)，則會傳回 Null 值。
-------------------------- 範例 2 --------------------------
$a = Get-CsVoicePolicy -Identity site:Redmond
Test-CsVoicePolicy -TargetNumber "+14255559999" -VoicePolicy $a
範例 2 與範例 1 相同，只除了它不是直接將 Get 作業的結果傳送至 Test 指令程式，而是物件會先以變數 $a 儲存，然後以值的形式傳遞到 VoicePolicy 參數，用來做為執行測試所依據的原則。
-------------------------- 範例 3 --------------------------
Get-CsVoicePolicy | Test-CsVoicePolicy -TargetNumber "+12065559999"
此範例會針對 Lync Server 2010 部署中定義的所有語音原則執行語音原則測試。首先會執行 Get-CsVoicePolicy 指令程式 (不含任何參數) 以擷取所有語音原則。接著，傳回的原則集合會傳送到 Test-CsVoicePolicy 指令程式，根據所提供的目標電話號碼 (+12065559999) 及電話使用方式，檢查集合中每個原則的符合路由。其輸出將會是符合路由的清單，加上符合的電話使用方式。