Test-CsUnifiedContactStore

Skype for Business Server 2015
 

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

통합 연락처 저장소를 통해 사용자 연락처에 액세스할 수 있는지 여부를 확인합니다. 사용자는 통합 연락처 저장소를 통해 비즈니스용 Skype, Outlook 및/또는 Outlook Web App을 사용하여 액세스할 수 있는 단일 연락처 집합을 유지 관리할 수 있습니다. 이 cmdlet은 Lync Server 2013에 도입되었습니다.

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

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

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

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

예제의 두 번째 명령은 제공된 자격 증명 개체($x) 및 사용자 litwareinc\kenmyer의 SIP 주소를 사용하여 이 사용자의 연락처를 통합 연락처 저장소에서 찾을 수 있는지를 확인합니다.

$credential = Get-Credential "litwareinc\kenmyer"

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

Lync Server 2013에서 도입된 통합 연락처 저장소를 통해 관리자는 비즈니스용 Skype 서버 2015가 아닌 Exchange에서 사용자 연락처를 저장할 수 있습니다. 그러면 사용자가 비즈니스용 Skype에서는 물론 Outlook과 Outlook Web Access에서도 같은 연락처 집합에 액세스할 수 있습니다. 계속 비즈니스용 Skype 서버 2015에서 연락처를 저장할 수도 있는데, 이 경우 사용자는 서로 다른 두 연락처 집합(Outlook 및 Outlook Web App에서 사용할 연락처 집합과 비즈니스용 Skype에서 사용할 연락처 집합)을 유지 관리해야 합니다.

Test-CsUnifiedContactStore cmdlet을 실행하면 사용자의 연락처가 통합 연락처 저장소로 이동되었는지를 확인할 수 있습니다. Test-CsUnifiedContactStore cmdlet은 지정된 사용자 계정을 가져와서 통합 연락처 저장소에 연결한 다음 해당 사용자의 연락처 검색을 시도합니다. 연락처를 검색할 수 없으면 명령이 실패하고 "사용자의 대화 상대를 받지 못했습니다. 사용자의 대화 상대가 있는지 확인하세요."라는 메시지가 표시됩니다.

사용자가 통합 연락처 저장소로 마이그레이션되었지만 대화 상대 목록에 연락처가 없으면 Test-CsUnifiedContactStore cmdlet은 실패합니다. 지정한 사용자에게 연락처가 한 명 이상 있어야 Test-CsUnifiedContactStore cmdlet이 정상적으로 완료됩니다.

Lync Server 제어판: Test-csUnifiedContactStore cmdlet에 의해 수행되는 기능은 Lync Server 제어판에서는 사용할 수 없습니다.

 

매개 변수 필수 형식 설명

TargetFqdn

필수

System.String

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

UserCredential

필수

System.Management.Automation.PSCredential

테스트에서 사용할 사용자 계정의 사용자 자격 증명 개체입니다. UserCredential에 전달되는 값은 et-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-CsUnifiedContactStore cmdlet은 파이프라인된 입력을 허용하지 않습니다.

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

 
표시: