Test-CsClientAuth
마지막으로 수정된 항목: 2012-03-26
사용자가 인증서 프로비전 서비스에서 다운로드한 인증서를 사용하여 Microsoft Lync Server 2010에 로그온할 수 있는지 여부를 확인합니다.
구문
Test-CsClientAuth [-TargetFqdn <String>] -UserCredential <PSCredential> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-TargetUri <String>]
자세한 정보
클라이언트 인증서는 Lync Server 2010에서 사용자를 인증하는 대체 방법을 제공합니다. 사용자가 클라이언트 인증서를 사용하여 시스템에 로그온할 수 있는지 여부를 확인하려면 Test-CsClientAuth cmdlet을 실행할 수 있습니다. 이 Test-CsClientAuth를 실행할 경우 테스트되는 사용자 계정의 등록자 풀 및 SIP 주소를 지정해야 합니다. 또한 사용자의 로그온 이름 및 암호를 제공할 수 있어야 합니다. Test-CsClientAuth를 호출하면 이 cmdlet은 인증서 프로비전 서비스에 연결하여 지정된 사용자의 클라이언트 인증서 복사본을 다운로드합니다. 그런 다음 Test-CsClientAuth는 클라이언트 인증서를 찾아서 다운로드할 수 있는 경우 해당 인증서를 사용하여 로그온을 시도합니다. 로그온에 성공하면 Test-CsClientAuth가 로그오프되고 테스트 성공을 보고합니다.
인증서를 찾거나 다운로드할 수 없거나 해당 인증서를 사용하여 로그온할 수 없는 경우 Test-CsClientAuth는 테스트 실패를 보고합니다.
이 cmdlet을 실행할 수 있는 사용자: 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsClientAuth"}
매개 변수
| 매개 변수 | 필수 | 유형 | 설명 |
|---|---|---|---|
UserCredential |
필수 |
PS 자격 증명 개체 |
테스트에서 사용할 사용자 계정의 사용자 자격 증명 개체입니다 UserCredential에 전달되는 값은 Get-Credential cmdlet을 사용하여 가져온 개체 참조여야 합니다. 예를 들어 다음 코드는 사용자 litwareinc\kenmyer의 자격 증명 개체를 반환하고 이 개체를 $x라는 변수에 저장합니다. $x = Get-Credential "litwareinc\kenmyer" 이 명령을 실행할 때는 사용자 암호를 제공해야 합니다. |
UserSipAddress |
필수 |
SIP 주소 |
테스트에서 사용할 사용자의 SIP 주소입니다(예: -UserSipAddress sip:kenmyer@litwareinc.com). |
RegistrarPort |
선택 |
정수 |
등록자 서비스에서 사용하는 SIP 포트입니다. 등록자에서 기본 포트 5061을 사용하는 경우에는 이 매개 변수가 필요하지 않습니다. |
TargetUri |
선택 |
문자열 |
인증서 프로비전 서비스의 URL입니다. 이 매개 변수를 포함하지 않으면 Test-CsClientAuth는 등록자 풀에 대해 구성된 인증서 프로비전 서비스를 사용합니다. |
TargetFqdn |
선택 |
문자열 |
클라이언트 인증을 테스트할 등록자 풀의 FQDN(정규화된 도메인 이름)입니다(예: -TargetFqdn "atl-cs-001.litwareinc.com"). |
OutVerboseVariable |
선택 |
문자열 |
이 매개 변수가 있으면 cmdlet을 실행하여 얻은 자세한 출력이 지정된 변수에 저장됩니다. 예를 들어 출력을 $TestOutput이라는 변수에 저장하려면 다음과 같은 구문을 사용합니다. -OutVerboseVariable TestOutput 변수 이름을 지정할 때 $ 문자를 추가해서는 안 됩니다. |
Force |
선택 |
스위치 매개 변수 |
명령을 실행할 때 발생할 수 있는 심각하지 않은 오류 메시지를 표시하지 않습니다. |
Verbose |
선택 |
스위치 매개 변수 |
cmdlet이 실행될 때 자세한 작업을 화면에 보고합니다. |
입력 형식
없음.
반환 형식
Test-CsClientAuth는 Microsoft.Rtc.SyntheticTransactions.TaskOutput 개체의 인스턴스를 반환합니다.
예제
-------------------------- 예제 1 --------------------------
$cred1 = Get-Credential "litwareinc\kenmyer"
Test-CsClientAuth -TargetFqdn atl-cs-001.litwareinc.com -UserSipAddress "sip:kenmyer@litwareinc.com" -UserCredential $cred1
예제 1에 표시된 명령은 사용자 litwareinc\kenmyer가 클라이언트 인증서를 사용하여 등록자 풀 atl-cs-001.litwareinc.com에 로그온할 수 있는지를 테스트합니다. 이 작업을 수행하기 위해 예제의 첫 번째 명령은 Get-Credential을 사용하여 해당 사용자에 대한 자격 증명 개체를 만듭니다. 사용자에 대한 암호 입력을 요구하는 결과 자격 증명 개체는 변수 $cred1에 저장됩니다.
두 번째 명령은 Test-CsClientAuth를 호출하여 등록자 풀의 FQDN(TargetFqdn), 사용자의 SIP 주소(UserSipAddress) 및 초기 명령에서 생성된 자격 증명 개체(UserCredential)를 지정합니다.