Lync Server 2013에서 두 사용자 간의 IM 기능 테스트Testing ability to IM between two users 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-CsIM cmdlet을 실행 하는 권한이 있는 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. 이 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"}

설명Description

Test-CsIM cmdlet은 테스트 사용자 쌍이 인스턴트 메시지를 교환할 수 있는지 확인 합니다.The Test-CsIM cmdlet verifies that a pair of test users can exchange instant messages. 호출 되 면 test users 쌍을 Lync Server에 로그온 하 여 Test-CsIM cmdlet이 시작 되지 않습니다.When called, the Test-CsIM cmdlet starts off by trying to log on a pair of test users to Lync Server. 두 로그온이 성공 했다고 가정 하면 cmdlet은 두 테스트 사용자 간에 IM 세션을 시작 합니다.Assuming the two logons are successful, the cmdlet then starts an IM session between the two test users. (사용자 1이 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.

자세한 내용은 CsIM cmdlet에 대 한 도움말 설명서를 참조 하십시오.For more information, see the Help documentation for the Test-CsIM cmdlet.

테스트 실행Running the Test

Test-CsIM cmdlet은 미리 구성 된 테스트 계정 쌍 (Lync Server 테스트 실행을 위한 테스트 계정 설정 참조) 또는 Lync Server를 사용 하도록 설정 된 두 사용자의 계정 중 하나를 사용 하 여 실행할 수 있습니다.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 "atl-cs-001.litwareinc.com"

실제 사용자 계정을 사용 하 여이 검사를 실행 하려면 각 계정에 대해 두 개의 Windows PowerShell 자격 증명 개체 (계정 이름과 암호가 포함 된 개체)를 만들어야 합니다.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. 그런 다음 Test-CsIM을 호출할 때 이러한 자격 증명 개체와 두 계정의 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 "atl-cs-001.litwareinc.com" -SenderSipAddress "sip:kenmyer@litwareinc.com" -SenderCredential $credential1 -ReceiverSipAddress "sip:davidlongmire@litwareinc.com" -ReceiverCredential $credential2

자세한 내용은 CsIM cmdlet에 대 한 도움말 설명서를 참조 하십시오.For more information, see the Help documentation for the Test-CsIM cmdlet.

성공 또는 실패 확인Determining Success or Failure

두 사용자가 인스턴트 메시징 세션을 완료할 수 있으면 결과 속성이 성공으로 표시 된 것과 비슷한 출력을 받게 됩니다 .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 : atl-cs-001.litwareinc.com

결과: 성공Result : Success

대기 시간: 00:00:06.6630911Latency : 00:00:06.6630911

오류Error :

진단을Diagnosis :

테스트 사용자가 세션을 완료할 수 없으면 결과가 실패로 표시 되 고 오류 및 진단 속성에 추가 정보가 기록 됩니다.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 : atl-cs-001.litwareinc.com

결과: 실패Result : Failure

대기 시간: 00:00:00Latency : 00:00:00

오류: 504, 서버 제한 시간Error : 504, Server time-out

진단: ErrorCode = 2, Source = atl-cs-litwareinc, Reason = 참고Diagnosis : ErrorCode=2, Source=atl-cs-001.litwareinc.com,Reason=See

응답 코드 및 이유 구입니다.response code and reason phrase.

Microsoft DiagnosticHeaderMicrosoft.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 "atl-cs-001.litwareinc.com" -Verbose

Verbose 매개 변수를 포함 하면 Test-CsIM는 두 테스트 사용자가 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. 예를 들어, 다음은 Test-CsIM에 잘못 된 사용자 자격 증명 집합 (이 경우 잘못 된 암호)을 제공 했을 때 발생 하는 예제 출력입니다.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 = atl-cs-011.litwareinc.com

사용자 Sip 주소 = sip:kenmyer@litwareinc.comUser Sip Address = sip:kenmyer@litwareinc.com

등록자 포트 = 5061Registrar Port = 5061

인증 유형 ' IWA '이 선택 됩니다.Auth Type 'IWA' is selected.

Sip/atl-litwareinc에 대 한 등록 적중Registration hit against sip/atl-cs-001.litwareinc.com

' 등록 ' 활동이 완료 되었습니다 (' 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 "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 is enabled for Lync Server, run a command similar to the following:

    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에서는 보관 데이터베이스에 액세스할 수 없는 경우 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 "atl-cs-001.litwareinc.com" | Select-Object BlockOnArchiveFailure
    

    BlockOnArchiveFailure이 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