Lync Server 2013 で音声構成をテストする
トピックの最終更新日: 2014-05-20
確認スケジュール |
毎月 |
テスト ツール |
Windows PowerShell |
必要なアクセス許可 |
Lync Server Management Shell を使用してローカルで実行する場合、ユーザーは RTCUniversalServerAdmins セキュリティ グループのメンバーである必要があります。 Windows PowerShellのリモート インスタンスを使用して実行する場合、ユーザーには、Test-CsVoiceTestConfiguration コマンドレットを実行するアクセス許可を持つ RBAC ロールが割り当てられている必要があります。 このコマンドレットを使用できるすべての RBAC ロールの一覧を表示するには、Windows PowerShell プロンプトから次のコマンドを実行します。
|
説明
Lync Server には、エンタープライズ VoIP インフラストラクチャ (音声ルート、音声ポリシー、SIP トランク) の個々の部分が想定どおりに動作していることを確認できるいくつかのWindows PowerShellコマンドレット (Test-CsVoiceRoute、Test-CsVoicePolicy、Test-CsTrunkConfiguration など) が含まれています。
すべての個々の部分が機能するエンタープライズ VoIPでは重要ですが、有効な音声ルート、有効な音声ポリシー、有効な SIP トランクを持つことができますが、ユーザーが電話を発信または受信することはできません。 そのため、Lync Server には音声テスト構成を作成する機能も用意されています。 音声テスト構成は、一般的なエンタープライズ VoIPシナリオを表します。音声ルート、音声ポリシー、ダイヤル プランなどを指定し、それらの個々のアイテムが連携して電話サービスを提供できることを確認できます。 また、特定のシナリオで期待値を検証することもできます。 たとえば、ダイヤル プラン A と音声ポリシー B の組み合わせにより、通話が音声ルート C 経由でルーティングされると想定しているとします。音声ルート C は ExpectedRoute として入力できます。 テストを実行すると、音声ルート C が使用されていない場合、テストは失敗したとマークされます。
テストの実行
Windows PowerShellを使用して Voice 構成コレクションをテストする前に、まずGet-CsVoiceTestConfiguration コマンドレットを使用して、これらの構成設定のインスタンスを取得する必要があります。 その後、そのインスタンスを Test-CsVoiceTestConfiguration にパイプする必要があります。 次に例を示します。
Get-CsVoiceTestConfiguration -Identity "RedmondVoiceTestConfiguration" | Test-CsVoiceTestConfiguration
すべての音声テスト構成設定を同時に検証するには、代わりに次のコマンドを使用します。
Get-CsVoiceTestConfiguration | Test-CsVoiceTestConfiguration
詳細については、Test-CsVoiceTestConfiguration コマンドレットのヘルプ ドキュメントを参照してください。
成功または失敗の決定
Test-CsVoiceTestConfiguration コマンドレットは、テストが失敗したか成功したかを報告し、成功した各テストに関する追加情報 (翻訳ルール、音声ルート、タスクの完了に使用される PSTN 使用法など) を提供します。
結果: 成功
TranslatedNumber: +15551234
MatchingRule: Description=;Pattern=^(\d{4})$;Translation=+1\d;Name=Test;IsInternalExtension=False
FirstMatchingRoute: site:Redmond
MatchingUsage: Local
テストが失敗した場合、結果は Fail として報告されます。
結果: 失敗
TranslatedNumber:
FirstMatchingRoute:
MatchingUsage:
テストが失敗した可能性がある理由
音声テストの構成テストでは、音声ポリシー、ダイヤル プラン、音声ルートなど、さまざまな項目がテストされるため、テストに失敗する可能性があるさまざまな要因がいくつかあります。 テストが失敗した場合、最初の手順は、Get-CsVoiceTestConfiguration コマンドレットを使用して構成設定自体を確認することです。
Get-CsVoiceTestConfiguration -Identity "RedmondVoiceTestConfiguration"
設定が正しく構成されているように見える場合は、Verbose パラメーターを含め、テストを再実行します。
Get-CsVoiceTestConfiguration -Identity "RedmondVoiceTestConfiguration" | Test-CsVoiceTestConfiguration
Verbose パラメーターは、次の例に示すように、Test-CsVoiceTestConfigurationによって実行される各アクションの詳細なアカウントを提供します。
VERBOSE: ダイヤル プランの読み込み: "Global"
VERBOSE: 音声ポリシーの読み込み: "RedmondDialPlan"
このステップ バイ ステップ アカウントは、テストが実際に失敗した場所に関する有用な手がかりを提供する場合があります。 そうでない場合は、他のWindows PowerShellコマンドレット (Test-CsVoicePolicy など) を使用し、音声テスト構成設定に含まれる個々のコンポーネントの検証をメソッドで開始できます。
それに加えて、テストで呼び出しをルーティングでき、まだエラーとしてマークされる可能性があることに注意してください。ExpectedRoute、ExpectedTranslatedNumber、ExpectedUsage に値を入力した場合に発生する可能性があり、それらの期待値のいずれかが満たされていない場合に発生します。 たとえば、音声ルート C を想定した音声ルートとして入力したが、実際に音声ルート D を使用してテストが完了したとします。その場合、想定される音声ルートが使用されなかったため、テストは失敗とマークされます。 テストが失敗した場合は、ExpectedRoute、ExpectedTranslatedNumber、ExpectedUsage の値を削除し、テストを再実行できます。 これは、呼び出しが完了できなかったために失敗したのかどうか、または 1 つのことを想定して実際に別のものを受け取ったために発生したかどうかを判断するのに役立ちます。