Test-CsGroupIM

구문

Test-CsGroupIM -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-ReceiverSipAddress <String>] [-RegistrarPort <Nullable>] [-SenderSipAddress <String>]

Test-CsGroupIM [-TargetFqdn <String>] -ReceiverCredential <PSCredential> -ReceiverSipAddress <String> -SenderCredential <PSCredential> -SenderSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]

자세한 정보

Test-CsGroupIM은 Lync Server 2010 가상 트랜잭션의 한 예입니다. 가상 트랜잭션은 Lync Server에서 사용자가 시스템 로그온, 인스턴트 메시지 교환 또는 PSTN(공중 전화망)의 전화로 전화 걸기와 같은 일반적인 작업을 성공적으로 수행할 수 있는지 확인하는 데 사용됩니다. 이러한 테스트는 관리자가 "수동으로" 수행하거나 Microsoft System Center Operations Manager(이전 Microsoft Operations Manager)와 같은 응용 프로그램에 의해 자동으로 실행될 수 있습니다.

가상 트랜잭션은 일반적으로 두 가지 방법으로 수행됩니다. 많은 관리자가 CsHealthMonitoringConfiguration cmdlet을 사용하여 각 등록자 풀의 테스트 사용자를 설정합니다. 이러한 테스트 사용자는 가상 트랜잭션에 사용하도록 미리 구성된 사용자 쌍입니다. 일반적으로 이는 테스트 계정이며 실제 사용자에게 속한 계정이 아닙니다. 풀에 테스트 사용자가 구성되면 관리자는 테스트에 참여한 사용자 계정의 ID 및 자격 증명을 지정하지 않고도 해당 풀에 대해 가상 트랜잭션을 실행할 수 있습니다.

또는 실제 사용자 계정을 사용하여 가상 트랜잭션을 실행할 수 있습니다. 예를 들어 두 사용자가 인스턴트 메시지를 교환할 수 없는 경우 관리자는 이 두 사용자 계정(테스트 계정 쌍이 아님)을 사용하여 가상 트랜잭션을 실행한 다음 문제를 진단 및 해결할 수 있습니다. 실제 사용자 계정을 사용하여 가상 트랜잭션을 수행하도록 결정한 경우 각 사용자에 대한 자격 증명을 제공해야 합니다.

Test-CsGroupIM cmdlet을 사용하면 조직의 사용자가 전화 회의를 수행할 수 있는지 확인할 수 있습니다. Test-CsGroupIM에서 테스트를 수행하려면 두 개의 사용자 계정이 필요합니다. 테스트를 수행할 풀에 대해 테스트 사용자를 설정한 경우에는 이러한 계정을 지정할 필요가 없습니다. 대신, Test-CsGroupIM에서 풀에 할당된 테스트 계정을 자동으로 사용합니다. 자세한 내용은 New-CsHealthMonitoringConfiguration 도움말 항목을 참조하십시오. 또는 등록자에 할당된 계정 이외의 계정을 사용하여 테스트할 수 있습니다. 이렇게 하면 풀에 대해 테스트 사용자를 구성하지 않은 경우에도 테스트를 실행할 수 있습니다. 두 명의 특정 사용자가 전화 회의를 수행할 수 있는지도 테스트할 수 있습니다. 이 방법을 사용하려면 두 사용자의 사용자 이름과 암호를 제공해야 합니다.

Test-CsGroupIM을 실행하면 cmdlet에서 두 명의 테스트 사용자를 모두 Lync Server에 로그온하려고 합니다. 성공하면 Test-CsGroupIM에서 첫 번째 테스트 사용자를 사용하여 새 전화 회의를 만든 다음 두 번째 사용자를 전화 회의에 참가하도록 초대합니다. 메시지를 교환한 후 두 사용자의 시스템 연결이 모두 끊어집니다. 이 작업은 모두 사용자 상호 작용 없이, 실제 사용자에게 영향을 미치지 않고 수행됩니다. 예를 들어 테스트 계정 sip:kenmyer@litwareinc.com이 실제 Lync Server 계정을 가진 실제 사용자에 해당한다고 가정해 보겠습니다. 이 경우 실제 Ken Myer를 방해하지 않고 테스트가 수행됩니다. 예를 들어 Ken Myer 테스트 계정이 시스템에서 로그오프된 경우에도 실제 Ken Myer는 계속 로그온되어 있습니다. 마찬가지로, 실제 Ken Myer는 전화 회의에 참가하라는 초대를 받지 않습니다. 이 초대는 테스트 계정에 전송되고 해당 계정에 의해 수락됩니다.

Verbose 매개 변수를 추가하면 Test-CsGroupIM에서 테스트를 완료하기 위해 수행하는 모든 작업에 대한 자세한 설명을 볼 수 있습니다.

이 cmdlet을 실행할 수 있는 사용자: 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.

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

매개 변수

입력 형식

없음. Test-CsGroupIM은 파이프라인된 입력을 허용하지 않습니다.

반환 형식

Test-CsGroupIM은 Microsoft.Rtc.SyntheticTransactions.TaskOutput 개체의 인스턴스를 반환합니다.

예제

-------------------------- 예제 1 --------------------------

Test-CsGroupIm -TargetFqdn atl-cs-001.litwareinc.com

위 예제는 미리 구성된 한 쌍의 테스트 사용자가 atl-cs-001.litwareinc.com 풀에 로그온한 다음 IM 전화 회의에 참가할 수 있는지 확인합니다. 이 명령은 atl-cs-001.litwareinc.com 풀에 대해 테스트 사용자가 정의된 경우에만 작동합니다. 정의되어 있는 경우 이 명령은 두 명의 테스트 사용자가 시스템에 로그온할 수 있는지 확인한 다음 이러한 사용자가 인스턴트 메시징 전화 회의에 참가할 수 있는지 확인합니다.

테스트 사용자가 정의되어 있지 않으면 테스트를 수행할 때 이용할 사용자를 알 수 없으므로 명령이 실패합니다. 풀에 대해 테스트 사용자를 정의하지 않은 경우 SenderSipAddress 및 ReceiverSipAddress 매개 변수와 인스턴트 메시징 세션에 참가한 사용자의 자격 증명을 포함해야 합니다. 그러면 Test-CsGroupIM에서 지정된 두 사용자를 사용하여 검사를 수행합니다.

-------------------------- 예제 2 --------------------------

$cred1 = Get-Credential "litwareinc\pilar"
$cred2 = Get-Credential "litwareinc\kenmyer"

Test-CsGroupIm -TargetFqdn atl-cs-001.litwareinc.com -SenderSipAddress "sip:pilar@litwareinc.com" -SenderCredential $cred1 -ReceiverSipAddress "sip:kenmyer@litwareinc.com" -ReceiverCredential $cred2

예제 2에 표시된 명령은 한 쌍의 사용자(litwareinc\pilar 및 litwareinc\kenmyer)가 Lync Server에 로그온한 다음 인스턴트 메시징 전화 회의에 참가할 수 있는지 테스트합니다. 이 작업을 수행하기 위해 이 예제의 첫 번째 명령은 Get-Credential cmdlet을 사용하여 사용자 Pilar Ackerman의 이름 및 암호를 포함하는 Windows PowerShell 자격 증명 개체를 만듭니다. 로그온 이름 litwareinc\pilar는 매개 변수로 포함되었으므로 관리자는 결과 Windows PowerShell 자격 증명 요청 대화 상자에 Pilar Ackerman 계정의 암호만 입력하면 됩니다. 그러면 결과 자격 증명 개체가 $cred1이라는 변수에 저장됩니다. 두 번째 명령도 같은 작업을 수행하지만 이번에는 Ken Myer 계정의 자격 증명 개체를 반환합니다.

두 개의 자격 증명 개체가 준비되면 예제의 세 번째 명령에서 두 사용자가 Lync Server에 로그온하여 인스턴트 메시징 전화 회의에 참가할 수 있는지 확인합니다. 이 작업을 수행하기 위해 Test-CsGroupIM을 TargetFqdn(등록자 풀의 FQDN), SenderSipAddress(첫 번째 사용자의 SIP 주소), SenderCredential(첫 번째 사용자의 사용자 자격 증명), ReceiverSipAddress(두 번째 사용자의 SIP 주소) 및 ReceiverCredential(두 번째 사용자의 사용자 자격 증명) 매개 변수와 함께 호출합니다.

참고 항목

기타 리소스

Test-CsIM