Set-CsVoiceTestConfiguration
トピックの最終更新日: 2012-03-27
指定のルートおよびルールで電話番号をテストする際のテスト シナリオを変更します。
構文
Set-CsVoiceTestConfiguration [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-DialedNumber <String>] [-ExpectedRoute <String>] [-ExpectedTranslatedNumber <String>] [-ExpectedUsage <String>] [-Force <SwitchParameter>] [-TargetDialplan <String>] [-TargetVoicePolicy <String>] [-WhatIf [<SwitchParameter>]]
Set-CsVoiceTestConfiguration [-Confirm [<SwitchParameter>]] [-DialedNumber <String>] [-ExpectedRoute <String>] [-ExpectedTranslatedNumber <String>] [-ExpectedUsage <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-TargetDialplan <String>] [-TargetVoicePolicy <String>] [-WhatIf [<SwitchParameter>]]
解説
ボイス ルートと音声ポリシーを実装する前に、複数の電話番号でテストして予想通りに動作するかどうか確認することをお勧めします。このコマンドレットを使用してテスト シナリオを変更することで、この確認を行うことができます。
Set-CsVoiceTestConfiguration コマンドレットを実行すると、指定の電話番号をテストするボイス ルート、使用法、ダイヤル プラン、および音声ポリシーが変更されます。この情報はすべて、他のコマンドレットを使用して定義、取得できます。これについては、このトピックのパラメーター説明で示されています。
このコマンドレットを使用して変更した構成は、Test-CsVoiceTestConfiguration コマンドレットを使用してテストします。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが Set-CsVoiceTestConfiguration コマンドレットをローカルで実行することを承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsVoiceTestConfiguration"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
省略可能 |
文字列 |
変更するテスト シナリオを一意に識別する文字列です。 このパラメーターの値にはスコープは含まれません。このオブジェクトがグローバル スコープでのみ作成できるためです。したがって、名前のみが必要です。 |
Instance |
省略可能 |
TestConfiguration |
既存の音声テスト構成に変更点を加えた構成が含まれる Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration 型のオブジェクトです。この型のオブジェクトは、Get-CsVoiceTestConfiguraton コマンドレットを呼び出すと取得できます。 |
DialedNumber |
省略可能 |
文字列 |
ポリシー、使用法などのテストに使用する電話番号です。 512 文字以下にする必要があります。 |
ExpectedRoute |
省略可能 |
文字列 |
構成テスト中に使用されることが予想されるボイス ルートの名前です。対象のダイヤル プランと音声ポリシーに基づいて異なるルートが使用されると、テストは失敗します。Get-CsVoiceRoute コマンドレットを呼び出すことで、使用可能なボイス ルートを取得できます。 256 文字以下にする必要があります。 |
ExpectedTranslatedNumber |
省略可能 |
文字列 |
変換後の表示形式の電話番号です。これは、正規化後の DialedNumber パラメーター値です。Test-CsVoiceTestConfiguration を実行した結果、DialedNumber が ExpectedTranslatedNumber の値にならない場合、テストは失敗とレポートされます。 512 文字以下にする必要があります。 |
ExpectedUsage |
省略可能 |
文字列 |
構成テスト時に使用予定の PSTN 使用法の名前です。対象のダイヤル プランと音声ポリシーに基づいて異なる PSTN 使用法が使用されると、テストは失敗します。Get-CsPstnUsage を呼び出すことで使用可能な使用法を取得できます。 256 文字以下にする必要があります。 |
TargetDialplan |
省略可能 |
文字列 |
このテストで使用するダイヤル プランの Identity です。ダイヤル プランは、Get-CsDialPlan コマンドレットを呼び出すことで取得できます。 40 文字以下にする必要があります。 |
TargetVoicePolicy |
省略可能 |
文字列 |
このテストを実行する対象の音声ポリシーの Identity です。音声ポリシーは、Get-CsVoicePolicy を呼び出すことで取得できます。 40 文字以下にする必要があります。 |
Force |
省略可能 |
SwitchParameter |
変更を行う前に表示されるように設定されているすべての確認メッセージを表示しないようにします。 |
WhatIf |
省略可能 |
SwitchParameter |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
SwitchParameter |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration オブジェクト。パイプライン処理された音声テスト構成オブジェクトの入力を受け入れます。
戻り値の種類
このコマンドレットを実行すると、Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration 型のオブジェクトが戻されます。
例
-------------------------- 例 1 --------------------------
Set-CsVoiceTestConfiguration -Identity TestConfig1 -DialedNumber 14255551212
この例では、TestConfig1 の音声テスト構成のダイヤル番号を 14255551212 に設定しています。この番号で音声ポリシーとボイス ルートをチェックし、正規化が問題なく行われていることと、正しいルートとダイヤル プランが適用されていることを確認します。
-------------------------- 例 2 --------------------------
Set-CsVoiceTestConfiguration -Identity TestConfig1 -TargetDialplan site:Redmond1 -ExpectedTranslatedNumber "+912065551212"
この例では、TestConfig1 という音声テスト構成の設定を変更しています。このコマンドは、TargetDialplan を site:Redmond1 のダイヤル プランに設定します。ダイヤル プランの変更によって正規化ルールが変更された可能性があるため、ExpectedTranslationNumber も変更したダイヤル プランの正規化ルールの内容を反映して変更されています。