Test-WSMan
WinRM 서비스가 로컬 컴퓨터에서 실행되고 있는지 또는 원격 컴퓨터에서 실행되고 있는지를 테스트합니다.
구문
Test-WSMan
[[-ComputerName] <String>]
[-Authentication <AuthenticationMechanism>]
[-Port <Int32>]
[-UseSSL]
[-ApplicationName <String>]
[-Credential <PSCredential>]
[-CertificateThumbprint <String>]
[<CommonParameters>]Description
이 cmdlet은 Windows 플랫폼에서만 사용할 수 있습니다.
cmdlet은 Test-WSMan WinRM 서비스가 로컬 또는 원격 컴퓨터에서 실행 중인지 여부를 결정하는 ID 요청을 제출합니다. 테스트된 컴퓨터가 서비스를 실행하는 경우 cmdlet은 WS-Management ID 스키마, 프로토콜 버전, 제품 공급업체 및 테스트된 서비스의 제품 버전을 표시합니다.
예제
예제 1: WinRM 서비스의 상태 확인
Test-WSMan이 명령은 WinRM 서비스가 로컬 컴퓨터 또는 원격 컴퓨터에서 실행 중인지 여부를 결정합니다.
예제 2: 원격 컴퓨터에서 WinRM 서비스의 상태 확인
Test-WSMan -ComputerName "server01"이 명령은 WinRM 서비스가 server01 컴퓨터에서 실행 중인지 여부를 결정합니다.
예제 3: WinRM 서비스 및 운영 체제 버전의 상태 확인
Test-WSMan -Authentication default이 명령은 인증 매개 변수를 사용하여 WinRM(WS-Management) 서비스가 로컬 컴퓨터에서 실행되고 있는지 여부를 테스트합니다.
인증 매개 변수를 사용하면 운영 체제 버전을 반환할 수 Test-WSMan 있습니다.
예제 4: 원격 컴퓨터에서 WinRM 서비스 및 OS 버전의 상태 확인
Test-WSMan -ComputerName "server01" -Authentication default이 명령은 인증 매개 변수를 사용하여 Server01이라는 컴퓨터에서 WS-Management(WinRM) 서비스가 실행되고 있는지 여부를 테스트합니다.
인증 매개 변수를 사용하면 운영 체제 버전을 반환할 수 Test-WSMan 있습니다.
매개 변수
-ApplicationName
연결의 애플리케이션 이름을 지정합니다. ApplicationName 매개 변수의 기본값은 WSMAN입니다. 원격 엔드포인트의 전체 식별자는 다음과 같은 형식입니다.
<Transport>://<Server>:<Port>/<ApplicationName>
예: http://server01:8080/WSMAN
세션을 호스트하는 IIS(인터넷 정보 서비스)는 이 엔드포인트가 있는 요청을 지정된 애플리케이션에 전달합니다. WSMAN의 이 기본 설정은 대부분의 용도에 적합합니다. 이 매개 변수는 많은 컴퓨터가 Windows PowerShell을 실행하는 한 컴퓨터에 원격 연결을 설정하는 경우에 사용하도록 설계되었습니다. 이 경우 IIS는 효율성을 위해 WS-Management(Web Services for Management)를 호스트합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Authentication
서버에서 사용할 인증 메커니즘을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.
Basic- 기본은 사용자 이름과 암호가 서버 또는 프록시에 명확한 텍스트로 전송되는 체계입니다.Default- WS-Management 프로토콜에 의해 구현된 인증 방법을 사용합니다. 기본값입니다.- 1 - 다이제스트는 챌린지에 서버 지정 데이터 문자열을 사용하는 챌린지-응답 체계입니다.
Kerberos- 클라이언트 컴퓨터와 서버는 Kerberos 인증서를 사용하여 상호 인증합니다.Negotiate- 협상은 인증에 사용할 체계를 결정하기 위해 서버 또는 프록시와 협상하는 챌린지 응답 체계입니다. 예를 들어 이 매개 변수 값을 사용하면 협상을 통해 Kerberos 프로토콜 또는 NTLM이 사용되는지 여부를 확인할 수 있습니다.CredSSP- 사용자가 자격 증명을 위임할 수 있는 CredSSP(자격 증명 보안 지원 공급자) 인증을 사용합니다. 이 옵션은 한 원격 컴퓨터에서 실행되지만 다른 원격 컴퓨터에서 데이터를 수집하거나 다른 원격 컴퓨터에서 추가 명령을 실행하는 명령을 위해 설계되었습니다.
주의
CredSSP는 로컬 컴퓨터에서 원격 컴퓨터로 사용자 자격 증명을 위임합니다. 이렇게 하면 원격 작업의 보안 위험이 증가합니다. 원격 컴퓨터가 손상된 경우 자격 증명이 원격 컴퓨터에 전달되면 자격 증명이 네트워크 세션을 제어하는 데 사용될 수 있습니다.
Important
인증 매개 변수 Test-WSMan 를 지정하지 않으면 인증을 사용하지 않고 익명으로 원격 컴퓨터로 요청이 전송됩니다. 요청이 익명으로 이루어지면 운영 체제 버전과 관련된 정보가 반환되지 않습니다. 대신 이 cmdlet은 운영 체제 버전 및 서비스 팩 수준에 대한 null 값을 표시합니다(OS: 0.0.0 SP: 0.0).
| 형식: | AuthenticationMechanism |
| 별칭: | auth, am |
| 허용되는 값: | None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-CertificateThumbprint
이 작업을 수행할 수 있는 권한이 있는 사용자 계정의 디지털 공개 키 인증서(X509)를 지정합니다. 인증서의 인증서 지문을 입력합니다.
인증서는 클라이언트 인증서 기반 인증에 사용됩니다. 로컬 사용자 계정에만 매핑할 수 있습니다. 도메인 계정에서 작동하지 않습니다.
인증서 지문을 가져오려면 Windows PowerShell 인증서: 드라이브에서 Get-Item 또는 Get-ChildItem 명령을 사용합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ComputerName
관리 작업을 실행할 컴퓨터를 지정합니다. 값은 정규화된 도메인 이름, NetBIOS 이름 또는 IP 주소일 수 있습니다. 로컬 컴퓨터 이름을 사용하거나 localhost를 사용하거나 점(.)을 사용하여 로컬 컴퓨터를 지정합니다. 로컬 컴퓨터가 기본값입니다. 원격 컴퓨터가 사용자와 다른 도메인에 있는 경우 정규화된 도메인 이름을 사용해야 합니다. 이 매개 변수의 값을 cmdlet으로 파이프할 수 있습니다.
| 형식: | String |
| 별칭: | cn |
| Position: | 0 |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Credential
이 작업을 수행할 권한이 있는 사용자 계정을 지정합니다. 기본값은 현재 사용자입니다. 사용자 이름(예: User01, Domain01\User01 또는 User@Domain.com.)을 입력합니다. 또는 cmdlet에서 반환한 개체와 같은 PSCredential 개체를 Get-Credential 입력합니다. 사용자 이름을 입력하면 이 cmdlet에서 암호를 묻는 메시지를 표시합니다.
| 형식: | PSCredential |
| 별칭: | cred, c |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Port
클라이언트가 WinRM 서비스에 연결할 때 사용할 포트를 지정합니다. 전송이 HTTP인 경우 기본 포트는 80입니다. 전송이 HTTPS인 경우 기본 포트는 443입니다.
HTTPS를 전송으로 사용하는 경우 ComputerName 매개 변수 값이 서버의 CN(인증서 일반 이름)과 일치해야 합니다.
| 형식: | Int32 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-UseSSL
SSL(Secure Sockets Layer) 프로토콜을 사용하여 원격 컴퓨터에 대한 연결을 설정하도록 지정합니다. 기본적으로 SSL은 사용되지 않습니다.
WS-Management는 네트워크를 통해 전송되는 모든 Windows PowerShell 내용을 암호화합니다. UseSSL 매개 변수를 사용하면 HTTP 대신 HTTPS의 추가 보호를 지정할 수 있습니다. 연결에 사용되는 포트에서 SSL을 사용할 수 없는 경우 이 매개 변수를 지정하면 명령이 실패합니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
입력
None
개체를 이 cmdlet으로 파이프할 수 없습니다.
출력
이 cmdlet은 테스트 결과를 나타내는 XmlElement 개체를 반환합니다.
참고
기본적으로 cmdlet은 Test-WSMan 인증을 사용하지 않고 WinRM 서비스를 쿼리하고 운영 체제 버전과 관련된 정보를 반환하지 않습니다. 대신 운영 체제 버전 및 서비스 팩 수준에 대한 null 값을 표시합니다(OS: 0.0.0 SP: 0.0).
관련 링크
PowerShell