Test-CsXmppIM

Skype for Business Server 2015
 

마지막으로 수정된 항목: 2017-03-28

XMPP(Extensible Messaging and Presence Protocol) 게이트웨이를 통해 메신저 대화를 보낼 수 있는지를 확인합니다. 비즈니스용 Skype 서버 2015 사용자는 XMPP 게이트웨이를 통해 XMPP를 사용하는 메신저 및 현재 상태 공급자에 속하는 사용자와 메신저 대화 및 현재 상태 정보를 교환할 수 있습니다. 이 cmdlet은 Lync Server 2013에서 도입되었습니다.

Test-CsXmppIM -TargetFqdn <String> [-Authentication <TrustedServer | Negotiate | ClientCertificate | LiveID | OAuth>] [-RegistrarPort <Int32>] [-UserSipAddress <String>] <COMMON PARAMETERS>

Test-CsXmppIM -UserCredential <PSCredential> -UserSipAddress <String> [-Authentication <TrustedServer | Negotiate | ClientCertificate | LiveID | OAuth>] [-HybridOnlineUserAuthentication <LiveID | OAuth>] [-HybridOnlineUserCredential <PSCredential>] [-IsHybridOnlineUser <$true | $false>] [-RegistrarPort <Int32>] [-TargetFqdn <String>] <COMMON PARAMETERS>

Test-CsXmppIM [-Authentication <TrustedServer | Negotiate | ClientCertificate | LiveID | OAuth>] <COMMON PARAMETERS>

COMMON PARAMETERS: -Receiver <String> [-Force <SwitchParameter>] [-OutLoggerVariable <String>] [-OutVerboseVariable <String>]

위 예제에서는 atl-cs-001.litwareinc.com 풀에 대해 XMPP 메신저 기능을 테스트합니다. 이 명령은 atl-cs-001.litwareinc.com 풀에 대해 테스트 사용자가 정의된 경우에만 작동합니다. 사용자가 정의된 경우 명령은 첫 번째 테스트 사용자가 SIP 주소가 adelaney@contoso.com인 사용자에게 XMPP 메신저 대화를 보낼 수 있는지를 확인합니다.

테스트 사용자가 정의되지 않은 경우 어떤 사용자로 로그온할지를 알 수 없기 때문에 명령이 실패합니다. 풀에 대한 테스트 사용자를 정의하지 않은 경우에는 UserSipAddress 매개 변수와 함께 로그온 시도 시 명령이 사용해야 하는 사용자의 자격 증명을 포함해야 합니다.

Test-CsXmppIM -TargetFqdn "atl-cs-001.litwareinc.com" -Receiver "adelany@contoso.com"

예제 2에 표시된 명령은 특정 사용자(litwareinc\pilar)가 로그온하여 사용자 adelaney@contoso.com에게 XMPP 메신저 대화를 보낼 수 있는지 테스트합니다. 이 작업을 수행하기 위해 이 예제의 첫 번째 명령은 Get-Credential cmdlet을 사용하여 사용자 Pilar Ackerman의 이름 및 암호를 포함하는 Windows PowerShell 명령줄 인터페이스 자격 증명 개체를 만듭니다. 로그온 이름 litwareinc\pilar는 매개 변수로 포함되었으므로 관리자는 Windows PowerShell 자격 증명 요청 대화 상자에 Pilar Ackerman 계정의 암호만 입력하면 됩니다. 이렇게 만들어진 자격 증명 개체는 $cred1이라는 변수에 저장됩니다.

두 번째 명령은 이 사용자가 atl-cs-001.litwareinc.com 풀에 로그온하여 XMPP 메신저 대화를 보낼 수 있는지 확인합니다. 이 작업을 수행하기 위해 Test-CsXmppIm cmdlet을 4개의 매개 변수, 즉 TargetFqdn(등록자 풀의 FQDN), Receiver(메시지를 보낼 주소로 지정된 사용자의 SIP 주소), UserCredential(Pilar Ackerman의 사용자 자격 증명이 포함된 Windows PowerShell 개체) 및 UserSipAddress(제공된 사용자 자격 증명에 해당하는 SIP 주소)와 함께 호출합니다.

$credential = Get-Credential "litwareinc\kenmyer"

Test-CsXmppIM -TargetFqdn "atl-cs-001.litwareinc.com" -Receiver "adelany@contoso.com" -UserSipAddress "sip:kenmyer@litwareinc.com" -UserCredential $credential

XMPP(Extensible Messaging and Presence Protocol)는 인터넷에서 메시지를 보내는 데 사용되는 XML 기반 표준 통신 프로토콜입니다. XMPP(이전 이름은 Jabber)는 Google Talk, Facebook 채팅을 비롯한 여러 인터넷 메시징 및 통신 응용 프로그램에서 지원됩니다. Test-CsXmppIM cmdlet은 사용자가 XMPP 네트워크의 사용자와 메신저 대화를 교환할 수 있는지 확인합니다. 이 테스트가 성공하려면 XMPP 사용자에 대한 유효한 SIP 주소가 있어야 하며 해당 SIP 주소는 허용 XMPP 파트너로 구성된 네트워크에 있어야 합니다.

비즈니스용 Skype 서버 제어판: Test-CsXmppIM cmdlet에 의해 수행되는 기능은 비즈니스용 Skype 서버 제어판에서 사용할 수 없습니다.

 

매개 변수 필수 유형 설명

Receiver

필수

System.String

테스트 메시지의 주소로 지정된 사용자의 SIP 주소입니다.

TargetFqdn

필수

System.String

테스트할 풀의 정규화된 도메인 이름입니다.

UserCredential

필수

System.Management.Automation.PSCredential

테스트할 사용자 계정의 사용자 자격 증명 개체입니다. UserCredential에 전달되는 값은 Get-Credential cmdlet을 사용하여 가져온 개체 참조여야 합니다. 예를 들어 이 코드는 사용자 litwareinc\kenmyer에 대한 자격 증명 개체를 반환하고 해당 개체를 $x:$x = Get-Credential "litwareinc\kenmyer" 변수에 저장합니다.

이 명령을 실행할 때는 사용자 암호를 제공해야 합니다.

상태 모니터링 구성 설정을 사용하여 테스트를 수행하는 경우 이 매개 변수가 필요하지 않습니다.

Authentication

선택

Microsoft.Rtc.Management.SyntheticTransactions.SipSyntheticTransaction+AuthenticationMechanism

테스트할 계정의 사용자 자격 증명 개체입니다. UserCredential에 전달되는 값은 Get-Credential cmdlet을 사용하여 가져온 개체 참조여야 합니다. 예를 들어, 이 코드는 사용자 litwareinc\kenmyer에 대한 자격 증명 개체를 반환하고 해당 개체를 변수

$x = Get-Credential "litwareinc\kenmyer"

이 명령을 실행할 때는 사용자 암호를 제공해야 합니다. 풀의 상태 모니터링 구성 설정에 따라 테스트를 실행하는 경우에는 이 매개 변수가 필요하지 않습니다.

Force

선택

System.Management.Automation.SwitchParameter

명령을 실행할 때 발생할 수 있는 심각하지 않은 오류 메시지를 표시하지 않습니다.

HybridOnlineUserAuthentication

선택

Microsoft.Rtc.Management.SyntheticTransactions.SipSyntheticTransaction+HybridOnlineAuthenticationMechanism

PARAMVALUE: LiveID | OAuth

HybridOnlineUserCredential

선택

System.Management.Automation.PSCredential

PARAMVALUE: PSCredential

IsHybridOnlineUser

선택

System.Boolean

PARAMVALUE: $true | $false

OutLoggerVariable

선택

System.String

이 매개 변수가 있으면 cmdlet을 실행하여 얻은 자세한 출력이 지정된 변수에 저장됩니다. 이 변수에 포함된 메서드 쌍(ToHTML 및 ToXML)은 이러한 출력을 HTML 또는 XML 파일에 저장하는 데 사용할 수 있습니다.

출력을 $TestOutput이라는 로거 변수에 저장하려면 다음과 같은 구문을 사용합니다.

-OutLoggerVariable TestOutput

참고: 변수 이름을 지정할 때 $ 문자를 추가해서는 안 됩니다.

로거 변수에 저장된 정보를 HTML 파일에 저장하려면 다음 명령을 사용합니다.

$TestOutput.ToHTML() > C:\Logs\TestOutput.html

로거 변수에 저장된 정보를 XML 파일에 저장하려면 다음 명령을 사용합니다.

$TestOutput.ToXML() > C:\Logs\TestOutput.xml

OutVerboseVariable

선택

System.String

이 매개 변수가 있으면 cmdlet을 실행하여 얻은 자세한 출력이 지정된 변수에 저장됩니다. 예를 들어 출력을 $TestOutput이라는 변수에 저장하려면 다음과 같은 구문을 사용합니다.

-OutVerboseVariable TestOutput

변수 이름을 지정할 때 $ 문자를 추가해서는 안 됩니다.

RegistrarPort

선택

System.Int32

등록자 서비스에서 사용하는 SIP 포트입니다. 등록자에서 기본 포트 5061을 사용하는 경우에는 이 매개 변수가 필요하지 않습니다.

UserSipAddress

선택

System.String

테스트할 사용자 계정의 SIP 주소입니다. 예를 들면 다음과 같습니다.

-UserSipAddress "sip:kenmyer@litwareinc.com"

UserSipAddress 매개 변수는 UserCredential과 같은 사용자 계정을 참조해야 합니다. 풀의 상태 모니터링 구성 설정에 따라 테스트를 실행하는 경우에는 이 매개 변수가 필요하지 않습니다.

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

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

 
표시: