Test-CsExUMVoiceMail

Skype for Business Server 2015
 

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

사용자가 Exchange 통합 메시징에 연결하여 다른 사용자에 대해 음성 메일 메시지를 남길 수 있는지를 확인합니다. 이 cmdlet은 Lync Server 2013에서 도입되었습니다.

Test-CsExUMVoiceMail -TargetFqdn <String> [-Authentication <TrustedServer | Negotiate | ClientCertificate | LiveID | OAuth>] [-ReceiverSipAddress <String>] [-RegistrarPort <Int32>] [-SenderSipAddress <String>] [-WaveFile <String>] <COMMON PARAMETERS>

Test-CsExUMVoiceMail -ReceiverSipAddress <String> -SenderCredential <PSCredential> -SenderSipAddress <String> [-Authentication <TrustedServer | Negotiate | ClientCertificate | LiveID | OAuth>] [-HybridOnlineUserAuthentication <LiveID | OAuth>] [-IsHybridOnlineUser <$true | $false>] [-RegistrarPort <Int32>] [-TargetFqdn <String>] [-WaveFile <String>] <COMMON PARAMETERS>

Test-CsExUMVoiceMail [-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-CsExUMVoiceMail -TargetFqdn "atl-cs-001.litwareinc.com" -ReceiverSipAddress "sip:kenmyer@litwareinc.com"

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

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

$credential = Get-Credential "litwareinc\pilar"

Test-CsExUMVoiceMail -TargetFqdn "atl-cs-001.litwareinc.com" -ReceiverSipAddress "sip:kenmyer@litwareinc.com" -SenderSipAddress "sip:pilar@litwareinc.com" -SenderCredential $credential

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

Test-CsExUMVoiceMail -TargetFqdn "atl-cs-001.litwareinc.com" -ReceiverSipAddress "sip:kenmyer@litwareinc.com" -OutLoggerVariable VoicemailTest

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

관리자는 Test-CsExUMVoiceMail cmdlet을 통해 사용자가 Exchange 통합 메시징 서비스에 액세스하여 해당 서비스를 사용할 수 있는지를 확인합니다. 이 작업을 수행하기 위해 cmdlet은 통합 메시징 서비스에 연결하여 지정된 사서함에 음성 메일을 남깁니다. 이 메일은 시스템에서 제공한 음성 메일일 수도 있고 직접 녹음한 사용자 지정 .WAV 파일일 수도 있습니다.

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

 

매개 변수 필수 유형 설명

SenderCredential

필수

System.Management.Automation.PSCredential

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

$x = Get-Credential "litwareinc\kenmyer"

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

풀의 상태 모니터링 구성 설정에 따라 테스트를 실행하는 경우에는 보낸 사람 자격 증명이 필요하지 않습니다.

TargetFqdn

필수

System.String

테스트할 풀의 FQDN(정규화된 도메인 이름)입니다. 예를 들면 다음과 같습니다.

-TargetFqdn atl-cs-001.litwareinc.com

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

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

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

ReceiverSipAddress

선택

System.String

테스트 음성 메일을 받을 사용자 계정의 SIP 주소로, 보낸 사람에 대해 사용하는 SIP 주소와는 달라야 합니다. 예를 들면 다음과 같습니다.

-ReceiverSipAddress "sip:pilar@litwareinc.com"

음성 메일 받는 사람에 대해서는 자격 증명을 포함하지 않아도 됩니다.

RegistrarPort

선택

System.Int32

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

SenderSipAddress

선택

System.String

음성 메일 메시지를 남길 사용자 계정의 SIP 주소로, 받는 사람에 대해 사용하는 SIP 주소와는 달라야 합니다. 예를 들면 다음과 같습니다.

-SenderSipAddress "sip:kenmyer@litwareinc.com"

SenderSIPAddress 매개 변수는 SenderCredential과 동일한 사용자 계정을 참조해야 합니다.

풀의 상태 모니터링 구성 설정에 따라 테스트를 실행하는 경우에는 SIP 주소가 필요하지 않습니다.

WaveFile

선택

System.String

음성 메일 서비스를 테스트할 때 사용할 수 있는 .WAV 오디오 파일의 경로입니다. 이 매개 변수를 포함하면 Test-CsExUMVoiceMail cmdlet은 Exchange 음성 메일에 연결할 때 지정된 .WAV 파일을 재생합니다. 이 매개 변수를 포함하지 않으면 기본 오디오 파일이 대신 재생됩니다.

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

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

 
표시: