로컬 컴퓨터와 해당 도메인 간의 보안 채널을 테스트 및 복구합니다.
구문
Test-ComputerSecureChannel [-Repair] [-Server <string>] [-Confirm] [-WhatIf] [<CommonParameters>]
설명
Test-ComputerSecureChannel cmdlet은 트러스트 관계 상태를 확인하여 로컬 컴퓨터와 해당 도메인 간의 보안 채널이 올바르게 작동하는지 검사합니다. 연결이 실패하면 Repair 매개 변수를 사용하여 복원할 수 있습니다.
Test-ComputerSecureChannel은 보안 채널이 올바르게 작동하면 "True"를 반환하고 그렇지 않으면 "False"를 반환합니다. 이 결과를 통해 함수와 스크립트의 조건문에서 cmdlet을 사용할 수 있습니다. 테스트 결과에 대한 자세한 내용을 보려면 Verbose 매개 변수를 사용합니다.
이 cmdlet은 NetDom.exe와 비슷하게 작동합니다. NetDom 및 Test-ComputerSecureChannel은 NetLogon 서비스를 사용하여 작업을 수행합니다.
매개 변수
-Repair
NetLogon 서비스에서 설정한 보안 채널을 제거한 다음 다시 작성합니다. 테스트에 실패("False" 반환)한 연결을 복원하려면 이 매개 변수를 사용합니다.
이 매개 변수를 사용하려면 현재 사용자가 로컬 컴퓨터 Administrators 그룹의 멤버여야 합니다.
|
필수 여부 |
false |
|
위치 |
named |
|
기본값 |
없음 |
|
파이프라인 입력 적용 여부 |
false |
|
와일드카드 문자 적용 여부 |
false |
-Server <string>
지정된 도메인 컨트롤러를 사용하여 명령을 실행합니다. 이 매개 변수를 생략하면 Test-ComputerSecureChannel은 작업의 기본 도메인 컨트롤러를 선택합니다.
|
필수 여부 |
false |
|
위치 |
named |
|
기본값 |
없음 |
|
파이프라인 입력 적용 여부 |
false |
|
와일드카드 문자 적용 여부 |
false |
-Confirm
명령을 실행하기 전에 확인 메시지를 표시합니다.
|
필수 여부 |
false |
|
위치 |
named |
|
기본값 |
|
|
파이프라인 입력 적용 여부 |
false |
|
와일드카드 문자 적용 여부 |
false |
-WhatIf
명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다.
|
필수 여부 |
false |
|
위치 |
named |
|
기본값 |
|
|
파이프라인 입력 적용 여부 |
false |
|
와일드카드 문자 적용 여부 |
false |
<CommonParameters>
이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_Commonparameters.
입력 및 출력
입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.
|
입력 |
없음 입력을 이 cmdlet으로 파이프할 수 없습니다. |
|
출력 |
System.Boolean 이 cmdlet은 연결이 올바르게 작동하면 "True"를 반환하고 그렇지 않으면 "False"를 반환합니다. |
참고
Windows Vista 이상에서 Test-ComputerSecureChannel 명령을 실행하려면 "관리자 권한으로 실행" 옵션을 사용하여 Windows PowerShell을 엽니다.
Test-ComputerSecureChannel은 Netlogon 서비스의 다양한 면을 제어하는 I_NetLogonControl2 함수를 사용하여 구현됩니다.
예 1
C:\PS>test-computersecurechannel True 설명 ----------- 이 명령은 로컬 컴퓨터와 해당 컴퓨터가 가입된 도메인 간의 보안 채널을 테스트합니다.
예 2
C:\PS>test-computersecurechannel -server DCName.fabrikam.com True 설명 ----------- 이 명령은 테스트에 사용할 선호 도메인 컨트롤러를 지정합니다.
예 3
C:\PS>Test-ComputerSecureChannel -repair True 설명 ----------- 이 명령은 로컬 컴퓨터와 해당 도메인 간의 보안 채널을 다시 설정합니다.
예 4
C:\PS>test-computerSecureChannel -verbose VERBOSE: Performing operation "Test-ComputerSecureChannel" on Target "SERVER01". True VERBOSE: "The secure channel between 'SERVER01' and 'net.fabrikam.com' is alive and working correctly." 설명 ----------- 이 명령은 Verbose 일반 매개 변수를 사용하여 작업에 대한 자세한 정보를 가져옵니다. Verbose 매개 변수에 대한 자세한 내용은 about_CommonParameters를 참조하십시오.
예 5
C:\PS>set-alias tcsc test-computersecurechannel
if (!(tcsc))
{write-host "Connection failed. Reconnect and retry."}
else { &(.\get-servers.ps1) }
설명
-----------
이 예에서는 연결이 필요한 스크립트를 실행하기 전에 Test-ComputerSecureChannel을 사용하여 연결을 테스트하는 방법을 보여 줍니다.
첫 번째 명령은 Set-Alias cmdlet을 사용하여 cmdlet 이름의 별칭을 만들어 공간을 저장하고 입력 오류를 방지합니다.
If 문은 스크립트를 실행하기 전에 Test-ComputerSecureChannel이 반환하는 값을 검사합니다.
참고 항목