Test-CsExUMConnectivity

Skype for Business Server 2015
 

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

테스트 사용자가 Exchange 통합 메시징에 연결할 수 있는지를 확인합니다. 이 cmdlet은 Lync Server 2013에서 도입되었습니다.

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

Test-CsExUMConnectivity -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-CsExUMConnectivity [-Authentication <TrustedServer | Negotiate | ClientCertificate | LiveID | OAuth>] <COMMON PARAMETERS>

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

위 예제에서는 atl-cs-001.litwareinc.com 풀에 대한 Exchange 통합 메시징 연결을 테스트합니다. 이 명령은 atl-cs-001.litwareinc.com 풀에 대해 테스트 사용자가 정의된 경우에만 작동합니다. 사용자가 정의된 경우 첫 번째 테스트 사용자가 통합 메시징에 연결할 수 있는지 여부를 확인합니다. 풀에 대해 테스트 사용자가 구성되지 않은 경우에는 명령이 실패합니다.

Test-CsExUMConnectivity -TargetFqdn "atl-cs-001.litwareinc.com"

예제 2에 표시된 명령은 사용자 litwareinc\kenmyer의 Exchange 통합 메시징 연결을 확인합니다. 이 작업을 수행하기 위해 예제의 첫 번째 명령은 Get-Credential cmdlet을 사용하여 사용자 litwareinc\kenmyer에 대해 Windows PowerShell 명령줄 인터페이스 자격 증명 개체를 만듭니다. 유효한 자격 증명 개체를 만들고 Test-CsExUMConnectivity cmdlet이 확인을 수행할 수 있도록 하려면 이 계정의 암호를 입력해야 합니다.

예제의 두 번째 명령은 제공된 자격 증명 개체($x) 및 사용자 litwareinc\kenmyer의 SIP 주소를 사용하여 이 사용자가 Exchange 통합 메시징에 연결할 수 있는지를 확인합니다.

$credential = Get-Credential "litwareinc\kenmyer"

Test-CsExUMConnectivity -TargetFqdn "atl-cs-001.litwareinc.com" -UserSipAddress "sip:kenmyer@litwareinc.com" -UserCredential $credential

예제 3에 표시된 명령은 예제 2에 표시된 명령의 변형이지만 이 예제에서는 Test-CsExUMConnectivity cmdlet이 수행하는 모든 단계 및 각 단계의 성공/실패 여부에 대해 자세한 로그를 생성하기 위해 OutLoggerVariable 매개 변수가 포함됩니다. 이를 위해 매개 변수 값이 ExumText인 OutLoggerVariable 매개 변수를 추가합니다. 그러면 자세한 로깅 정보가 $ExumTest 변수에 저장됩니다. 예제의 마지막 명령에서는 ToXML() 메서드를 사용하여 로그 정보를 XML 형식으로 변환합니다. 해당 XML 데이터는 Out-File cmdlet을 사용하여 C:\Logs\ExumTest.xml 파일에 기록됩니다.

$credential = Get-Credential "litwareinc\kenmyer"

Test-CsExUMConnectivity -TargetFqdn "atl-cs-001.litwareinc.com" -UserSipAddress "sip:kenmyer@litwareinc.com" -UserCredential $credential -OutLoggerVariable ExumTest

$ExumTest.ToXML() | Out-File C:\Logs\ExumTest.xml

Test-CsExUMConnectivity cmdlet은 지정한 사용자가 Exchange 통합 메시징 서비스에 연결할 수 있는지를 확인합니다. 이 cmdlet은 서비스에 연결할 수 있는지만을 확인하며 서비스 자체는 테스트하지 않습니다. 사용자 사서함에 실제로 음성 메일 메시지를 남기는 가상 트랜잭션 cmdlet을 사용하여 통합 메시징 서비스를 테스트하려면 Test-CsExUMVoiceMail cmdlet을 사용하세요.

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

 

매개 변수 필수 유형 설명

TargetFqdn

필수

System.String

Exchange 통합 메시징 연결을 테스트하는 풀의 정규화된 도메인 이름입니다.

UserCredential

필수

System.Management.Automation.PSCredential

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

$x = Get-Credential "litwareinc\kenmyer"

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

CsHealthMonitoringConfiguration cmdlet을 통해 구성된 테스트 사용자를 사용하여 테스트를 실행하는 경우에는 이 매개 변수가 필요 없습니다.

Authentication

선택

Microsoft.Rtc.Management.SyntheticTransactions.SipSyntheticTransaction+AuthenticationMechanism

테스트 실행 시 사용되는 인증 유형입니다. 사용 가능한 값은 다음과 같습니다.

TrustedServer

Negotiate

ClientCertificate

LiveID

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"

CsHealthMonitoringConfiguration cmdlet을 통해 구성된 테스트 사용자를 사용하여 테스트를 실행하는 경우에는 이 매개 변수가 필요 없습니다.

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

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

 
표시: