Lync Server 2013 で音声ルール、ルート、ポリシーをテストする
トピックの最終更新日: 2014-05-20
確認スケジュール |
毎月 |
テスト ツール |
Windows PowerShell |
必要なアクセス許可 |
Lync Server Management Shell を使用してローカルで実行する場合、ユーザーは RTCUniversalServerAdmins セキュリティ グループのメンバーである必要があります。 Windows PowerShellのリモート インスタンスを使用して実行する場合、ユーザーには、Test-CsVoiceUser コマンドレットを実行するアクセス許可を持つ RBAC ロールが割り当てられている必要があります。 このコマンドレットを使用できるすべての RBAC ロールの一覧を表示するには、Windows PowerShell プロンプトから次のコマンドを実行します。
|
説明
ユーザーが電話を発信すると、そのユーザーに割り当てられているポリシーとダイヤル プランの両方に応じて、通話が宛先に到達するためにかかったルートが異なります。 ユーザーの SIP アドレスと電話番号を指定すると、Test-CsVoiceUser コマンドレットは、該当するユーザーがその番号の呼び出しを完了できるかどうかを確認します。 テストが成功した場合、Test-CsVoiceUserは次を返します。
E.164 形式に変換された番号 (ユーザーのダイヤル プランに基づく)
その変換を指定した正規化規則
(ルートの優先順位に基づいて) 使用される音声ルート。
ユーザーの音声ポリシーを音声ルートにリンクした電話の使用状況。
Test-CsVoiceUserを使用すると、特定の電話番号が想定どおりにルーティングおよび変換されるかどうかを判断でき、個々のユーザーが発生した通話関連の問題のトラブルシューティングに役立ちます。
テストの実行
Test-CsVoiceUser コマンドレットを実行する場合は、ダイヤルされる番号 (DialedNumber) とテスト対象のユーザー アカウントの ID の 2 つの情報を指定する必要があります。 たとえば、次のコマンドは、SIP アドレス SIPkenmyer@litwareinc.com を持つユーザーの機能をテストします。電話番号 +12065555-1219 を呼び出します。
Test-CsVoiceUser -DialedNumber "12065551219" -SipUri "sip:kenmyer@litwareinc.com"
電話番号は、ダイヤルされる予定の方法で書式設定する必要があります。 たとえば、ユーザーが通常、長距離通話を発信する前に 1 をダイヤルしない場合は、次の形式を使用する必要があります。
-DialedNumber "2065551219"
もちろん、この場合、2065551219番号を Lync Server で使用される E.164 電話形式に正しく変換できる正規化ルールがない場合、テストは失敗します。 詳細については、コマンドレットNew-CsVoiceNormalizationRuleヘルプ トピックを参照してください。
各ユーザー アカウントに対して同じテストを実行する場合は、次のようなコマンドを使用できます。
Get-CsUser | ForEach-Object {$_.DisplayName; Test-CsVoiceUser -DialedNumber "+12065551219" -SipUri $_.SipAddress} | Format-List
詳細については、Test-CsVoiceUser コマンドレットのヘルプ ドキュメントを参照してください。
成功または失敗の決定
テストが正常に完了した場合 (つまり、ユーザーが指定した番号に電話をかけることができる場合)、出力には、変換された電話番号や一致する正規化ルール、音声ルートなどの情報が表示されます。
TranslatedNumber MatchingRule FirstMatchingRoute MatchingUsage
---------------- ------------ ------------------ -------------
+12065551219 Descripti...LocalRoute Local
Windows PowerShell画面の制限のため、少なくとも一部の情報 (一致する正規化規則の完全な説明) が画面に表示されない場合があります。 テストの成功または失敗にのみ関心がある場合は、これは重要ではない可能性があります。 返されたデータの完全な詳細を表示する場合は、テストの実行時に出力をFormat-Listコマンドレットにパイプします。
Test-CsVoiceUser -DialedNumber "+12065551219" -SipUri "sip:kenmyer@litwareinc.com" -Verbose | Format-List
出力がリーダーフレンドリな形式で表示されます。
TranslatedNumber : +12065551219
MatchingRule : Description=;Pattern=^(\d{11})$;Translation=+$1;
Name=Prefix All;IsInternalExtension=False
FirsMatchingRoute : LocalRoute
MatchingUsage : Local
テストが失敗した場合、Test-CsVoiceUserは空のプロパティ値のセットを返します。
TranslatedNumber MatchingRule FirstMatchingRoute MatchingUsage
---------------- ------------ ------------------ -------------
テストが失敗した可能性がある理由
Test-CsVoiceUser コマンドレットが失敗する理由はいくつもあります。指定した電話番号を変換できる正規化ルールがない可能性があります。 音声ルートに問題がある可能性があります。 問題のユーザーに割り当てられているダイヤル プランに構成の問題が発生する可能性があります。 そのため、Test-CsVoiceUser コマンドレットを実行するときに Verbose パラメーターを含める必要があります。
Test-CsVoiceUser -DialedNumber "+12065551219" -SipUri "sip:kenmyer@litwareinc.com" -Verbose
Verbose コマンドレットが含まれている場合、Test-CsVoiceUserはチェックを実行するときに実行されるすべての手順の詳細なアカウントを発行します。 たとえば、次のような手順が表示される場合があります。
VERBOSE: ID "sip:kenmyer@litwareinc.com" を使用してユーザーを特定する
VERBOSE: ダイヤル プランの読み込み: "RedmondDialPlan"
この追加情報は、失敗の原因を特定するために実行できる手順に関するヒントを提供できます。 たとえば、次に示す詳細な出力は、テスト対象のユーザーにダイヤル プラン RedmondDialPlan が割り当てられていることを示しています。 テストに失敗した場合、次の論理的な手順の 1 つは、RedmondDialPlan が指定された電話番号を変換できることを確認することです。
関連項目