Get-CsVoiceTestConfiguration
トピックの最終更新日: 2012-03-23
指定のルートとルールに対して電話番号をテストするために使用できるテスト シナリオを取得します。
構文
Get-CsVoiceTestConfiguration [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsVoiceTestConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
解説
このコマンドレットは、指定した電話番号をテストするボイス ルート、使用法、ダイヤル プラン、および音声ポリシーを取得します。ボイス ルートと音声ポリシーを実装する前に、複数の電話番号でテストして予想通りに動作するかどうか確認することをお勧めします。このテストを行うには、このコマンドレットでテスト構成を取得し、次に、このシナリオを Test-CsVoiceConfiguration コマンドレットで実行します。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが、Get-CsVoiceTestConfiguration コマンドレットのローカル実行を承認されています。RTCUniversalUserAdmins、RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsVoiceTestConfiguration"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
省略可能 |
XdsGlobalRelativeIdentity |
取得するテスト構成を一意に識別する文字列です。 |
Filter |
省略可能 |
文字列 |
このパラメーターにより、定義済みの音声テスト構成のワイルドカード検索を実行できます (詳細については、このトピックの例を参照してください)。 |
LocalStore |
省略可能 |
SwitchParameter |
中央管理ストア 自体ではなく、中央管理ストア のローカル レプリカから音声テスト構成を取得します。 |
入力の種類
なし。
戻り値の種類
Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration 型の 1 つ以上のオブジェクトを戻します。
例
-------------------------- 例 1 --------------------------
Get-CsVoiceTestConfiguration
すべての音声テスト構成設定を取得します。
-------------------------- 例 2 --------------------------
Get-CsVoiceTestConfiguration | Select-Object Identity, DialedNumber, ExpectedTranslatedNumber
この例では、すべての音声テスト構成設定を取得し、それぞれ Identity、DialedNumber、および ExpectedTranslatedNumber パラメーターのみを表示します。Get-CsVoiceTestConfiguration によって戻された設定は、Select-Object コマンドレットにパイプ処理されます。ここで、出力は Identity、DialedNumber、および ExpectedTranslatedNumber プロパティに絞り込まれます。
-------------------------- 例 3 --------------------------
Get-CsVoiceTestConfiguration -Filter *test*
この例では Filter パラメーターを使用して、文字列 "test" を含んだ ID を持つすべての音声テスト構成設定を取得します。フィルター値の先頭と末尾にあるワイルドカード文字 (*) は、文字列 "test" を Identity 内の位置や前後の文字に関わらず特定できることを意味します。たとえば、このコマンドでは、TestConfig、VoiceNumberTest、および VoiceTest1 などの名前の音声テスト構成を戻します。