トピック最終更新日: 2014-11-03
検証スケジュール |
[毎日] |
テスト ツール |
Windows PowerShell |
必要なアクセス許可 |
Lync Server 管理シェルを使用してローカルで実行する場合、ユーザーは RTCUniversalServerAdmins セキュリティ グループのメンバーである必要があります。 Windows PowerShellのリモート インスタンスを使用して実行する場合、ユーザーには Test-CsXmppIM コマンドレットを実行するアクセス許可を持つ RBAC ロールが割り当てられている必要があります。 このコマンドレットを使用できるすべての RBAC ロールの一覧を表示するには、Windows PowerShell プロンプトから次のコマンドを実行します。 |
説明
拡張メッセージングおよびプレゼンス プロトコル (XMPP) は、インターネット経由でメッセージを送信するために使用される標準通信プロトコル (XML に基づく) です。 XMPP はもともと Jabber という名前で、Google Talk や Facebook Chat などの複数のインターネット メッセージングおよび通信アプリケーションでサポートされています。 Test-CsXmppIM コマンドレットは、ユーザーが XMPP ネットワーク上のユーザーとインスタント メッセージを交換できることを確認します。 このテストを成功させるには、XMPP ユーザーの有効な SIP アドレスが必要であり、その SIP アドレスは許可された XMPP パートナーとして構成されたネットワーク上にある必要があることに注意してください。
テストの実行
次の例では、プール atl-cs-001.litwareinc.com の XMPP インスタント メッセージング機能を確認します。 このコマンドは、テスト ユーザーがプール atl-cs-001.litwareinc.com に対して定義されている場合にのみ機能します。 ある場合、コマンドは、最初のテスト ユーザーが SIP アドレス を持つユーザーに XMPP インスタント メッセージを送信できるかどうかを判断します adelaney@contoso.com。
テスト ユーザーが定義されていない場合、ログオンするユーザーが認識されないため、コマンドは失敗します。 プールのテスト ユーザーを定義していない場合は、UserSipAddress パラメーターと、ログオン時にコマンドを使用するユーザーの資格情報を含める必要があります。
Test-CsXmppIM -TargetFqdn "atl-cs-001.litwareinc.com" -Receiver "adelany@contoso.com"
次の例で示すコマンドは、特定のユーザー (litwareinc\pilar) がログオンして XMPP インスタント メッセージをユーザーに送信する機能をテストします adelaney@contoso.com。 これを行うには、この例の最初のコマンドで Get-Credential コマンドレットを使用して、ユーザー Pilar Ackerman の名前とパスワードを含むWindows PowerShell コマンド ライン インターフェイス資格情報オブジェクトを作成します。 (ログオン名 litwareinc\pilar がパラメーターとして含まれていたため、Windows PowerShell資格情報要求ダイアログ ボックスでは、管理者が Pilar Ackerman アカウントのパスワードを入力するだけで済みます)。結果として得られる資格情報オブジェクトは、$cred 1 という名前の変数に格納されます。
次に、2 番目のコマンドは、このユーザーがプール atl-cs-001.litwareinc.com にログオンして XMPP インスタント メッセージを送信できるかどうかを確認します。 このタスクを実行するために、Test-CsXmppIm コマンドレットが、TargetFqdn (レジストラー プールの FQDN) という 4 つのパラメーターと共に呼び出されます。受信側 (メッセージがアドレス指定されているユーザーの SIP アドレス)。UserCredential (Pilar Ackerman のユーザー資格情報を含むWindows PowerShell オブジェクト)、UserSipAddress (指定されたユーザー資格情報に対応する SIP アドレス)。
$credential = Get-Credential "litwareinc\kenmyer"
Test-CsXmppIM -TargetFqdn "atl-cs-001.litwareinc.com" -Receiver "adelany@contoso.com" -UserSipAddress "sip:kenmyer@litwareinc.com" -UserCredential $credential
成功または失敗の判断
XMPP インスタント メッセージングが正しく構成されている場合は、Result プロパティが Success とマークされた、次のような出力を受け取ります。
ターゲット Fqdn : atl-cs-001.litwareinc.com
結果: 成功
待機時間: 00:00:02.5361946
エラー メッセージ:
診断：
指定したユーザーが XMPP インスタント メッセージングを使用できない場合、結果は [失敗] として表示され、追加情報は Error プロパティと Diagnosis プロパティに記録されます。
警告: 指定された完全修飾のレジストラー ポート番号の読み取りに失敗しました
ドメイン名 (FQDN)。 既定のレジストラー ポート番号を使用する。 例外：
System.InvalidOperationException: トポロジに一致するクラスターが見つかりません。
で
Microsoft.Rtc.Management.SyntheticTransactions.SipSyntheticTransaction.TryRetri
eveRegistrarPortFromTopology(Int32& registrarPortNumber)
ターゲット Fqdn : atl-cs-001.litwareinc.com
結果: エラー
待機時間: 00:00:00
エラー メッセージ: 10060、接続されたパーティが原因で接続が失敗しました
一定期間後に適切に応答しなかったか、または
確立された接続に失敗しました。
10.188.116.96:5061 に応答できませんでした
内部例外:接続が失敗しました。
接続されたパーティーが一定期間後に適切に応答しなかった
接続されたホストが原因で、時間、または確立された接続が失敗しました
応答に失敗しました 10.188.116.96:5061
診断：
テストが失敗した理由
Test-CsXmppIM が失敗する一般的な理由を次に示します。
正しくないパラメーター値が指定されました。 使用する場合は、省略可能なパラメーターを正しく構成する必要があります。テストは失敗します。 省略可能なパラメーターを指定せずにコマンドを再実行し、成功したかどうかを確認します。
XMPP ゲートウェイ構成が正しく構成されていないか、まだデプロイされていない場合、このコマンドは失敗します。