Lync Server 2013 でグループ IM を実行するためのテスト機能Testing ability to do group IM in Lync Server 2013

 

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

検証スケジュールVerification schedule

毎日Daily

テストツール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-CsGroupIM コマンドレットを実行するためのアクセス許可を持つ RBAC の役割が割り当てられている必要があります。When run using a remote instance of Windows PowerShell, users must be assigned an RBAC role that has permission to run the Test-CsGroupIM 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-CsGroupIM"}

説明Description

Test-CsGroupIM コマンドレットは、組織内のユーザーがグループのインスタントメッセージングセッションを実行できるかどうかを確認します。The Test-CsGroupIM cmdlet verifies that users in your organization can conduct group instant messaging sessions. Test-CsGroupIM を実行すると、コマンドレットはテストユーザーのペアを Lync Server にサインインしようとします。When you run Test-CsGroupIM, the cmdlet attempts to sign in a pair of test users to Lync Server. 成功すると、Test-CsGroupIM は、最初のテスト ユーザーを使用して新しい会議を作成し、2 番目のユーザーを会議に招待します。If successful, Test-CsGroupIM creates a new conference using the first test user, then invites the second user to join the conference. メッセージの交換後、両方のユーザーはシステムから切断されます。After an exchange of messages, both users are then disconnected from the system. すべてのユーザーが操作を行わなくても、実際のユーザーに影響を与えることなく、すべてが行われることに注意してください。Note that all of this happens without any user interaction, and without affecting any actual users. たとえば、テストアカウント sip:kenmyer@litwareinc.com が実際の Lync Server アカウントを持つ実際のユーザーに対応しているとします。For example, suppose that the test account sip:kenmyer@litwareinc.com corresponds to a real user who has a real Lync Server account. この場合、テストは、実際の Ken Myer の業務を中断することなく実行されます。In that case, the test will be conducted without any disruption to the real Ken Myer. たとえば、Ken Myer のテスト アカウントがシステムからログオフした場合でも、Ken Myer 本人はログオン状態が保持されます。For example, even when the Ken Myer test account logs off from the system, Ken Myer the person will remain logged on. 同様に、実際の Ken Myer は会議に参加するための招待を受信しません。Likewise, the real Ken Myer won't receive an invitation to join the conference. その招待は、テスト アカウントに対して送信されて、テスト アカウントによって承諾されます。That invitation will be sent to, and accepted by, the test account.

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

テストの実行Running the test

Test-CsGroupIM コマンドレットを実行するには、事前に構成された一連のテストアカウントを使用します (「Lync Server テストを実行するためのテストアカウントをセットアップする」を参照してください)。または、Lync Server が有効になっている2人のユーザーのアカウント。The Test-CsGroupIM 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-CsGroupIM -TargetFqdn "atl-cs-001.litwareinc.com"

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

$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 コマンドレットのヘルプドキュメント」を参照してください。For more information, see the Help documentation for the Test-CsGroupIM cmdlet.

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

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

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

結果: 成功Result : Success

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

エラーError :

分析Diagnosis :

2人のユーザーがインスタントメッセージングセッションを完了できない場合、結果は失敗として表示され、エラーと診断のプロパティに追加情報が記録されます。If the two users can't able to complete the instant messaging session, then 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 : atl-cs-001.litwareinc.com

結果: エラーResult : Failure

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

エラー: 404、見つかりませんError : 404, Not Found

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

Reason = 宛先 URI が SIP に対して有効になっていないか、または使用されていませんReason=Destination URI either not enabled for SIP or does not

ない.exist.

DiagnosticHeader ()Microsoft.Rtc.Signaling.DiagnosticHeader

以前の出力には、少なくとも1つのテストアカウントが有効でないためにテストが失敗したことが示されます。これは、アカウントが存在しないか、ユーザーが Lync Server に対して有効になっていないためです。The previous output states that the test failed because at least one of the test accounts was not valid, either because the account does not exist or because the user has not been enabled for Lync Server. アカウントが存在することと、次のようなコマンドを実行することによって、アカウントが次のように有効になっているかどうかを確認できます。You can verify the account exists, and whether or not the account has been enabled for nm-ocs-14-3rd by running a command similar to this:

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

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

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

Verbose パラメーターが含まれている場合、Test-CsGroupIM は、指定されたユーザーがグループのインスタントメッセージングセッションに参加できるかどうかを確認したときに実行された各操作のステップバイステップのアカウントを返します。When the Verbose parameter is included, Test-CsGroupIM will return a step-by-step account of each action it tried when it checked the ability of the specified users to participate in a group instant messaging sessions. たとえば、テストが失敗し、1つ以上のユーザーアカウントが有効でないと通知された場合は、Verbose パラメーターを使用してテストを再実行し、無効なユーザーアカウントを特定します。For example, if your test fails and you are told that one or more of the user accounts is not valid, you can rerun the test using the Verbose parameter and determine which user account is not valid:

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

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

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

 Register Port = 5061Register Port    = 5061

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

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

この例では、SIP アドレス sip:kenmyer@litwareinc.com を持つユーザーがログオンできなかったことを示しています。As you can see, in this example the user who has the SIP address sip:kenmyer@litwareinc.com was not able to log on.

テストが失敗した理由Reasons why the test might have failed

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

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

    Get-CsUser "sip:kenmyer@litwareinc.com"
    
  • ユーザーアカウントは有効ですが、アカウントは現在 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 was enabled for Lync Server, run a command similar to the following:

    Get-CsUser "sip:kenmyer@litwareinc.com" |Select-Object 有効Get-CsUser "sip:kenmyer@litwareinc.com" | 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 を使用すると、アーカイブデータベースにアクセスできない場合に、インスタントメッセージングを使用できないようにシステムを構成できます。With Lync Server, you can configure the system so that instant messaging 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 "atl-cs-001.litwareinc.com" | 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:

    ping atl-archiving-001.litwareinc.com