Lync Server 2013 で2人のユーザー間の IM のテスト機能Testing ability to IM between two users in Lync Server 2013


トピックの最終更新日: 2014-06-05Topic Last Modified: 2014-06-05

検証スケジュールVerification schedule


テストツールTesting tool

Windows PowerShellWindows PowerShell

必要なアクセス許可Permissions required

Lync Server 管理シェルを使用してローカルに実行する場合、ユーザーは RTCUniversalServerAdmins セキュリティグループのメンバーである必要があります。When run locally using the Lync Server Management Shell, users must be members of the RTCUniversalServerAdmins security group.

Windows PowerShell のリモートインスタンスを使用して実行する場合、ユーザーには Test-CsIM コマンドレットを実行するためのアクセス許可を持つ RBAC の役割が割り当てられている必要があります。When run using a remote instance of Windows PowerShell, users must be assigned an RBAC role that has permission to run the Test-CsIM cmdlet. このコマンドレットを使用できるすべての RBAC の役割の一覧を表示するには、Windows PowerShell プロンプトから次のコマンドを実行します。To see a list of all RBAC roles that can use this cmdlet, run the following command from the Windows PowerShell prompt:

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


Test-CsIM コマンドレットは、テストユーザーのペアがインスタントメッセージを交換できるかどうかを確認します。The Test-CsIM cmdlet verifies that a pair of test users can exchange instant messages. 呼び出された場合、Test-CsIM コマンドレットは、一連のテストユーザーを Lync Server にログオンすることで開始します。When called, the Test-CsIM cmdlet starts off by trying to log on a pair of test users to Lync Server. 2回のログオンが成功すると、コマンドレットは2つのテストユーザー間で IM セッションを開始します。Assuming the two logons are successful, the cmdlet then starts an IM session between the two test users. (ユーザー1がユーザー2を IM セッションに招待し、ユーザー2が招待を受け入れます)。2人のユーザーの間でメッセージを交換できることを確認した後 Test-CsIM、IM セッションを終了し、両方のユーザーをシステムからログオフします。(User 1 invites User 2 to an IM session, and User 2 accepts the invitation.) After verifying that messages can be exchanged between the two users, Test-CsIM then ends the IM session and logs both users off the system.

詳細については、「 Test-CsIM コマンドレットのヘルプドキュメント」を参照してください。For more information, see the Help documentation for the Test-CsIM cmdlet.

テストの実行Running the Test

Test-CsIM コマンドレットを実行するには、事前に構成された一連のテストアカウントを使用します (「Lync Server テストを実行するためのテストアカウントをセットアップする」を参照してください)。または、Lync Server が有効になっている2人のユーザーのアカウント。The Test-CsIM cmdlet can be run using either a pair of preconfigured test accounts (see Setting Up Test Accounts for Running Lync Server Tests) or the accounts of any two users who are enabled for Lync Server. このチェックをテストアカウントを使用して実行するには、テストする Lync Server プールの FQDN を指定するだけで済みます。To run this check using test accounts, you just have to specify the FQDN of the Lync Server pool being tested. 以下に例を示します。For example:

Test-CsIM -TargetFqdn ""

実際のユーザーアカウントを使用してこのチェックを実行するには、2つの Windows PowerShell credentials オブジェクト (アカウント名とパスワードを含むオブジェクト) を各アカウントに作成する必要があります。To run this check using actual user accounts, you must create two Windows PowerShell credentials objects (objects that contain the account name and password) for each account. 次に、テスト-CsIM を呼び出すときに、これらの資格情報オブジェクトと2つのアカウントの SIP アドレスを含める必要があります。You must then include those credentials objects and the SIP addresses of the two accounts when you call Test-CsIM:

$credential1 = Get-Credential "litwareinc\kenmyer"
$credential2 = Get-Credential "litwareinc\davidlongmire"
Test-CsIm -TargetFqdn "" -SenderSipAddress "" -SenderCredential $credential1 -ReceiverSipAddress "" -ReceiverCredential $credential2

詳細については、「 Test-CsIM コマンドレットのヘルプドキュメント」を参照してください。For more information, see the Help documentation for the Test-CsIM cmdlet.

成功または失敗を判断するDetermining Success or Failure

2人のユーザーがインスタントメッセージングセッションを完了できる場合は、次のような出力が得られます。 Result プロパティは Success としてマークされてい ます。If the two users can complete an instant messaging session, you'll receive output similar to this, with the Result property marked as Success:

TargetFqdn: atl-cs-001.litwareinc.comTargetFqdn :

結果: 成功Result : Success

待機時間:00:00: 06.6630911Latency : 00:00:06.6630911

エラーError :

分析Diagnosis :

テストユーザーがセッションを完了できない場合は、結果がエラーとして表示され、追加情報が Error および診断プロパティに記録されます。If the test users can't complete the session, the Result will be shown as Failure, and additional information will be recorded in the Error and Diagnosis properties:

TargetFqdn: atl-cs-001.litwareinc.comTargetFqdn :

結果: エラーResult : Failure

待機時間: 00:00:00Latency : 00:00:00

エラー: 504、サーバーのタイムアウトError : 504, Server time-out

診断: ErrorCode = 2, Source = litwareinc, Reason = 「」を参照Diagnosis : ErrorCode=2,,Reason=See

応答コードと理由の語句。response code and reason phrase.

DiagnosticHeader ()Microsoft.Rtc.Signaling.DiagnosticHeader

たとえば、指定されたユーザーが見つからないため、テストが失敗したことが前の出力に示されます。For example, the previous output states that the test failed because the specified user couldn't be found. 次のコマンドを実行することにより、SIP アドレスが有効かどうか (およびその SIP アドレスを割り当てられたユーザーが Lync Server を使用したかどうか) を判断できます。You can determine whether a SIP address is valid (and whether the user assigned that SIP address was enabled for Lync Server) by running this command:

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

Test-CsIM が失敗した場合は、次のようにして、Verbose パラメーターを含むテストを再実行することをお勧めします。If Test-CsIM fails, then you might want to rerun the test, this time including the Verbose parameter:

Test-CsIM -TargetFqdn "" -Verbose

Verbose パラメーターが指定されている場合、Test-CsIM は、2つのテストユーザーが IM セッションに参加できるかどうかを確認したときに実行された各アクションのステップバイステップのアカウントを返します。When the Verbose parameter is included, Test-CsIM will return a step-by-step account of each action it tried when it checked the ability of the two test users to take part in an IM session. たとえば、次のサンプル出力は、誤ったユーザー資格情報のセット (この場合は間違ったパスワード) がテスト用に提供されたときに発生します。For example, here’s sample output that occurs when an incorrect set of user credentials (in this case, an incorrect password) is supplied to Test-CsIM:

登録要求の送信:Sending Registration request :

ターゲット Fqdn = atl-cs-011.litwareinc.comTarget Fqdn =

ユーザー Sip アドレス = sip:kenmyer@litwareinc.comUser Sip Address =

レジストラーポート = 5061Registrar Port = 5061

認証の種類 ' IWA ' が選択されています。Auth Type 'IWA' is selected.

Sip/atl-ws-01 に対する登録ヒット。 litwareincRegistration hit against sip/

' Register ' アクティビティは、' 0.0601795 ' 秒で完了しました。'Register' activity completed in '0.0601795' secs.

例外 ' ログオンが拒否されました。An exception 'The log on was denied. 正しい資格情報が使用されており、アカウントがアクティブであることを確認してください。Check that the correct credentials are being used and the account is active.' ワークフローの実行中に発生した。occurred during the Workflow.

テストが失敗した理由Reasons Why the Test Might Have Failed

Test-CsIM が失敗する可能性のある一般的な理由を次に示します。Here are some common reasons why Test-CsIM might fail:

  • 無効なユーザーアカウントが指定されました。You specified a user account that is not valid. ユーザーアカウントが存在することを確認するには、次のようなコマンドを実行します。You can verify that a user account exists by running a command similar to this:

    Get-CsUser ""
  • ユーザーアカウントは有効ですが、アカウントは現在 Lync Server に対して有効になっていません。The user account is valid, but the account is currently not enabled for Lync Server. ユーザーアカウントが Lync Server に対して有効になっていることを確認するには、次のようなコマンドを実行します。To verify that a user account is enabled for Lync Server, run a command similar to the following:

    Get-CsUser "" | Select-Object Enabled

    Enabled プロパティが False に設定されている場合は、ユーザーが Lync Server に対して有効になっていないことを意味します。If the Enabled property is set to False that means that the user is currently not enabled for Lync Server.

  • インスタントメッセージングサービスを利用できない可能性があります。The instant messaging service might not be available. Lync Server を使用すると、アーカイブデータベースにアクセスできない場合に IM を使用できないようにシステムを構成できます。With Lync Server, you can configure the system so that IM is not available if the archiving database cannot be accessed. これを確認するには、次のようなコマンドを実行します。You can verify that by running a command similar to the following:

    Get-CsArchivingConfiguration -Identity "" | Select-Object BlockOnArchiveFailure

    Blockonアーカイブエラーが True に設定されている場合は、アーカイブデータベースが使用可能かどうかを判断する必要があります。If BlockOnArchiveFailure is set to True, then you should determine whether or not the archiving database is available. 次のコマンドを使用して、アーカイブデータベースの場所を返すことができます。You can return the locations of your archiving databases by using the following command:

    Get-CsService -ArchivingDatabase
  • アーカイブサーバーが使用できない可能性があります。The Archiving server might not be available. 次のコマンドを使用して、アーカイブサーバーの FQDN を取得できます。You can retrieve the FQDN of your Archiving servers by using this command:

    Get-CsService -ArchivingServer

    その後、適切なサーバーに ping を実行して、そのサーバーが使用可能であることを確認できます。You can then ping the appropriate server to verify that it is available. 次に例を示します。For example: