Lync Server 2013 でグループ IM を実行するテスト機能

  • [アーティクル]

 

トピック最終更新日時: 2014-06-05

確認スケジュール

[毎日]

テスト ツール

Windows PowerShell

必要なアクセス許可

Lync Server Management Shell を使用してローカルで実行する場合、ユーザーは RTCUniversalServerAdmins セキュリティ グループのメンバーである必要があります。

Windows PowerShellのリモート インスタンスを使用して実行する場合、ユーザーには、Test-CsGroupIM コマンドレットを実行するアクセス許可を持つ RBAC ロールが割り当てられている必要があります。 このコマンドレットを使用できるすべての RBAC ロールの一覧を表示するには、Windows PowerShell プロンプトから次のコマンドを実行します。

Get-CsAdminRole | Where-Object {$_.Cmdlets -match "Test-CsGroupIM"}

説明

Test-CsGroupIM コマンドレットは、組織内のユーザーがグループインスタント メッセージング セッションを実行できることを確認します。 Test-CsGroupIM を実行すると、コマンドレットは一組のテスト ユーザーを Lync Server にサインインしようとします。 成功した場合、Test-CsGroupIMは最初のテスト ユーザーを使用して新しい会議を作成し、2 番目のユーザーを招待して会議に参加させます。 メッセージの交換後、両方のユーザーがシステムから切断されます。 これはすべて、ユーザーが操作することなく、実際のユーザーに影響を与えることなく発生することに注意してください。 たとえば、テスト アカウント SIP:kenmyer@litwareinc.com 実際の Lync Server アカウントを持つ実際のユーザーに対応するとします。 その場合、実際の Ken Myer を中断することなくテストが行われます。 たとえば、Ken Myer テスト アカウントがシステムからログオフした場合でも、Ken Myer ユーザーはログオンしたままになります。 同様に、実際の Ken Myer は会議への参加の招待を受け取りません。 その招待は、テスト アカウントに送信され、受け入れられます。

詳細については、 Test-CsGroupIM コマンドレットのヘルプ ドキュメントを参照してください。

テストの実行

Test-CsGroupIM コマンドレットは、構成済みのテスト アカウントのペア (Lync Server テストを実行するためのテスト アカウントの設定を参照) または Lync Server が有効になっている 2 人のユーザーのアカウントのいずれかを使用して実行できます。 テスト アカウントを使用してこのチェックを実行するには、テスト対象の Lync Server プールの FQDN を指定するだけで済みます。 次に例を示します。

Test-CsGroupIM -TargetFqdn "atl-cs-001.litwareinc.com"

実際のユーザー アカウントを使用してこのチェックを実行するには、アカウントごとに 2 つの Lync Server Management Shell 資格情報オブジェクト (アカウント名とパスワードを含むオブジェクト) を作成する必要があります。 次に、Test-CsGroupIM を呼び出すときに、これらの資格情報オブジェクトと 2 つのアカウントの SIP アドレスを含める必要があります。

$credential1 = Get-Credential "litwareinc\kenmyer"
$credential2 = Get-Credential "litwareinc\davidlongmire"
Test-CsGroupIm -TargetFqdn "atl-cs-001.litwareinc.com" -SenderSipAddress "sip:kenmyer@litwareinc.com" -SenderCredential $credential1 -ReceiverSipAddress "sip:davidlongmire@litwareinc.com" -ReceiverCredential $credential2

詳細については、 Test-CsGroupIM コマンドレットのヘルプ ドキュメントを参照してください。

成功または失敗の決定

2 人のユーザーがグループインスタント メッセージング セッションを完了できる場合は、次のような出力が表示され、Result プロパティが Success としてマークされます。

TargetFqdn : atl-cs-001.litwareinc.com

結果 : 成功

待機時間 : 00:00:06.3812203

エラー：

診断：

2 人のユーザーがインスタント メッセージング セッションを完了できない場合、結果は失敗として表示され、追加の情報が [エラー] プロパティと [診断] プロパティに記録されます。

TargetFqdn : atl-cs-001.litwareinc.com

結果 : 失敗

待機時間: 00:00:00

エラー : 404、見つかりません

診断 : ErrorCode=4005,Source=atl-cs-001.litwareinc.com,

Reason=Destination URI は、SIP に対して有効になっていないか、または有効になっていないかのいずれかです。

存在。

Microsoft.Rtc.Signaling.DiagnosticHeader

以前の出力では、アカウントが存在しないか、またはユーザーが Lync Server で有効になっていないため、テスト アカウントの少なくとも 1 つが無効であったため、テストが失敗したことが示されています。 次のようなコマンドを実行すると、アカウントが存在し、nm-ocs-14-3rd に対してアカウントが有効になっているかどうかを確認できます。

"Ken Myer", "David Longmire" | Get-CsUser | Select-Object SipAddress, Enabled

Test-CsGroupIM失敗した場合は、Verbose パラメーターを含めてテストを再実行できます。

Test-CsGroupIM -TargetFqdn "atl-cs-001.litwareinc.com" -Verbose

Verbose パラメーターが含まれていると、指定したユーザーがグループ インスタント メッセージング セッションに参加する機能を確認したときに試行した各アクションのステップ バイ ステップ アカウントがTest-CsGroupIMから返されます。 たとえば、テストが失敗し、1 つ以上のユーザー アカウントが無効であると言われた場合は、Verbose パラメーターを使用してテストを再実行し、有効でないユーザー アカウントを特定できます。

登録要求の送信:

 Target Fqdn = atl-cs-001.litwareinc.com

 ユーザー SIP アドレス = sip:kenmyer@litwareinc.com

 Register Port = 5061

認証の種類 'IWA' が選択されています。

例外 'ログオンが拒否されました。 正しい資格情報が使用されていて、アカウントがアクティブであることを確認します。

ご覧のように、この例では、SIP アドレス sip を持つユーザーはkenmyer@litwareinc.com ログオンできませんでした。

テストが失敗した可能性がある理由

Test-CsGroupIMが失敗する一般的な理由を次に示します。

  • 正しくないユーザー アカウントを指定しました。 ユーザー アカウントが存在することを確認するには、次のようなコマンドを実行します。

    Get-CsUser "sip:kenmyer@litwareinc.com"

  • ユーザー アカウントは有効ですが、アカウントは現在 Lync Server で有効になっていません。 ユーザー アカウントが Lync Server に対して有効になっていることを確認するには、次のようなコマンドを実行します。

    Get-CsUser "sip:kenmyer@litwareinc.com" | Select-Object有効

    Enabled プロパティが False に設定されている場合は、ユーザーが Lync Server に対して現在有効になっていないことを意味します。

  • インスタント メッセージング サービスは使用できない可能性があります。 Lync Server では、アーカイブ データベースにアクセスできない場合にインスタント メッセージングを使用できないようにシステムを構成できます。 これを確認するには、次のようなコマンドを実行します。

    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