Lync Server 2013 で 2 人のユーザー間で IM を実行するテスト機能
トピック最終更新日時: 2014-06-05
確認スケジュール |
[毎日] |
テスト ツール |
Windows PowerShell |
必要なアクセス許可 |
Lync Server Management Shell を使用してローカルで実行する場合、ユーザーは RTCUniversalServerAdmins セキュリティ グループのメンバーである必要があります。 Windows PowerShellのリモート インスタンスを使用して実行する場合、ユーザーには、Test-CsIM コマンドレットを実行するアクセス許可を持つ RBAC ロールが割り当てられている必要があります。 このコマンドレットを使用できるすべての RBAC ロールの一覧を表示するには、Windows PowerShell プロンプトから次のコマンドを実行します。
|
説明
Test-CsIM コマンドレットは、テスト ユーザーのペアがインスタント メッセージを交換できることを確認します。 呼び出されると、Test-CsIM コマンドレットは、Lync Server に対するテスト ユーザーのペアのログオンを試みることによって開始されます。 2 つのログオンが成功したと仮定すると、コマンドレットは 2 人のテスト ユーザー間で IM セッションを開始します。 (ユーザー 1 は IM セッションにユーザー 2 を招待し、ユーザー 2 は招待を受け入れます。2 人のユーザー間でメッセージを交換できることを確認した後、Test-CsIM IM セッションを終了し、両方のユーザーをシステムからログに記録します。
詳細については、 Test-CsIM コマンドレットのヘルプ ドキュメントを参照してください。
テストの実行
Test-CsIM コマンドレットは、構成済みのテスト アカウントのペア (Lync Server テストを実行するためのテスト アカウントの設定を参照) または Lync Server が有効になっている 2 人のユーザーのアカウントのいずれかを使用して実行できます。 テスト アカウントを使用してこのチェックを実行するには、テスト対象の Lync Server プールの FQDN を指定するだけで済みます。 次に例を示します。
Test-CsIM -TargetFqdn "atl-cs-001.litwareinc.com"
実際のユーザー アカウントを使用してこのチェックを実行するには、アカウントごとに 2 つのWindows PowerShell資格情報オブジェクト (アカウント名とパスワードを含むオブジェクト) を作成する必要があります。 次に、Test-CsIM を呼び出すときに、これらの資格情報オブジェクトと 2 つのアカウントの SIP アドレスを含める必要があります。
$credential1 = Get-Credential "litwareinc\kenmyer"
$credential2 = Get-Credential "litwareinc\davidlongmire"
Test-CsIm -TargetFqdn "atl-cs-001.litwareinc.com" -SenderSipAddress "sip:kenmyer@litwareinc.com" -SenderCredential $credential1 -ReceiverSipAddress "sip:davidlongmire@litwareinc.com" -ReceiverCredential $credential2
詳細については、 Test-CsIM コマンドレットのヘルプ ドキュメントを参照してください。
成功または失敗の決定
2 人のユーザーがインスタント メッセージング セッションを完了できる場合は、次のような出力を受け取り、Result プロパティは成功としてマークされます。
TargetFqdn : atl-cs-001.litwareinc.com
結果 : 成功
待機時間 : 00:00:06.6630911
エラー:
診断:
テスト ユーザーがセッションを完了できない場合、結果はエラーとして表示され、追加情報は [エラー] プロパティと [診断] プロパティに記録されます。
TargetFqdn : atl-cs-001.litwareinc.com
結果 : 失敗
待機時間: 00:00:00
エラー : 504、サーバーのタイムアウト
診断 : ErrorCode=2, Source=atl-cs-001.litwareinc.com,Reason=See
応答コードと理由フレーズ。
Microsoft.Rtc.Signaling.DiagnosticHeader
たとえば、前の出力では、指定したユーザーが見つからなかったため、テストが失敗したと示されています。 次のコマンドを実行すると、SIP アドレスが有効かどうか (およびその SIP アドレスを割り当てたユーザーが Lync Server に対して有効になっているかどうか) を確認できます。
Get-CsUser "Ken Myer" | Select-Object SipAddress, Enabled
Test-CsIM失敗した場合は、Verbose パラメーターを含めてテストを再実行できます。
Test-CsIM -TargetFqdn "atl-cs-001.litwareinc.com" -Verbose
Verbose パラメーターが含まれていると、Test-CsIMは、2 人のテスト ユーザーが IM セッションに参加する能力をチェックしたときに試行した各アクションのステップ バイ ステップ アカウントを返します。 たとえば、Test-CsIM に不適切なユーザー資格情報のセット (この場合は正しくないパスワード) が指定された場合に発生する出力の例を次に示します。
登録要求の送信:
Target Fqdn = atl-cs-011.litwareinc.com
ユーザー Sip アドレス = sip:kenmyer@litwareinc.com
レジストラー ポート = 5061
認証の種類 'IWA' が選択されています。
sip/atl-cs-001.litwareinc.com に対する登録ヒット
'Register' アクティビティは '0.0601795' 秒で完了しました。
例外 'ログオンが拒否されました。 正しい資格情報が使用されていて、アカウントがアクティブであることを確認します。 ワークフロー中に発生しました。
テストが失敗した理由
Test-CsIMが失敗する一般的な理由を次に示します。
無効なユーザー アカウントを指定しました。 ユーザー アカウントが存在することを確認するには、次のようなコマンドを実行します。
Get-CsUser "sip:kenmyer@litwareinc.com"
ユーザー アカウントは有効ですが、アカウントは現在 Lync Server で有効になっていません。 ユーザー アカウントが Lync Server に対して有効になっていることを確認するには、次のようなコマンドを実行します。
Get-CsUser "sip:kenmyer@litwareinc.com" | Select-Object Enabled
Enabled プロパティが False に設定されている場合は、ユーザーが現在 Lync Server で有効になっていないことを意味します。
インスタント メッセージング サービスは使用できない可能性があります。 Lync Server では、アーカイブ データベースにアクセスできない場合に IM を使用できないようにシステムを構成できます。 これを確認するには、次のようなコマンドを実行します。
Get-CsArchivingConfiguration -Identity "atl-cs-001.litwareinc.com" | Select-Object BlockOnArchiveFailure
BlockOnArchiveFailure が True に設定されている場合は、アーカイブ データベースを使用できるかどうかを判断する必要があります。 次のコマンドを使用して、アーカイブ データベースの場所を返すことができます。
Get-CsService -ArchivingDatabase
アーカイブ サーバーを使用できない可能性があります。 次のコマンドを使用して、アーカイブ サーバーの FQDN を取得できます。
Get-CsService -ArchivingServer
その後、適切なサーバーに ping を実行して、使用可能であることを確認できます。 次に例を示します。
ping atl-archiving-001.litwareinc.com