Test-WSMan
WinRM 서비스가 로컬 또는 원격 컴퓨터에서 실행 중인지 테스트합니다.
구문
Test-WSMan
[[-ComputerName] <String>]
[-Authentication <AuthenticationMechanism>]
[-Port <Int32>]
[-UseSSL]
[-ApplicationName <String>]
[-Credential <PSCredential>]
[-CertificateThumbprint <String>]
[<CommonParameters>]Description
Test-WSMan cmdlet은 WinRM 서비스가 로컬 또는 원격 컴퓨터에서 실행 중인지 여부를 결정하는 식별 요청을 제출합니다. 테스트된 컴퓨터가 서비스를 실행하는 경우 cmdlet은 WS-Management ID 스키마, 프로토콜 버전, 제품 공급업체 및 테스트된 서비스의 제품 버전을 표시합니다.
예제
예제 1: WinRM 서비스의 상태 확인
PS C:\> Test-WSMan
wsmid : http://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity.xsd
ProtocolVersion : http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd
ProductVendor : Microsoft Corporation
ProductVersion : OS: 0.0.0 SP: 0.0 Stack: 2.0이 명령은 WinRM 서비스가 로컬 컴퓨터 또는 원격 컴퓨터에서 실행 중인지 여부를 결정합니다.
예제 2: 원격 컴퓨터에서 WinRM 서비스의 상태 확인
PS C:\> Test-WSMan -ComputerName "server01"
wsmid : http://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity.xsd
ProtocolVersion : http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd
ProductVendor : Microsoft Corporation
ProductVersion : OS: 0.0.0 SP: 0.0 Stack: 2.0이 명령은 WinRM 서비스가 server01 컴퓨터에서 실행 중인지 여부를 결정합니다.
예제 3: WinRM 서비스 및 운영 체제 버전의 상태 확인
PS C:\> Test-WSMan -Authentication default
wsmid : http://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity.xsd
ProtocolVersion : http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd
ProductVendor : Microsoft Corporation
ProductVersion : OS: 6.0.6001 SP: 1.0 Stack: 2.0이 명령은 인증 매개 변수를 사용하여 WinRM(WS-Management) 서비스가 로컬 컴퓨터에서 실행되고 있는지 여부를 테스트합니다.
인증 매개 변수를 사용하면 Test-WSMan 운영 체제 버전을 반환할 수 있습니다.
예제 4: 원격 컴퓨터에서 WinRM 서비스 및 운영 체제 버전의 상태 확인
PS C:\> Test-WSMan -ComputerName "server01" -Authentication default
wsmid : http://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity.xsd
ProtocolVersion : http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd
ProductVendor : Microsoft Corporation
ProductVersion : OS: 6.1.7021 SP: 0.0 Stack: 2.0이 명령은 인증 매개 변수를 사용하여 server01이라는 컴퓨터에서 winRM(WS-Management) 서비스가 실행되고 있는지 여부를 테스트합니다.
인증 매개 변수를 사용하면 Test-WSMan 운영 체제 버전을 반환할 수 있습니다.
매개 변수
-ApplicationName
연결에서 애플리케이션 이름을 지정합니다. ApplicationName 매개 변수의 기본값은 WSMAN입니다. 원격 엔드포인트의 전체 식별자는 다음과 같은 형식입니다.
<전송>://<서버>:<포트>/<ApplicationName>
예: http://server01:8080/WSMAN
세션을 호스트하는 IIS(인터넷 정보 서비스)는 이 엔드포인트가 있는 요청을 지정된 애플리케이션에 전달합니다. WSMAN의 이 기본 설정은 대부분의 용도에 적합합니다. 이 매개 변수는 많은 컴퓨터가 Windows PowerShell을 실행하는 한 컴퓨터에 원격 연결을 설정하는 경우에 사용하도록 설계되었습니다. 이 경우 IIS는 효율성을 위해 관리용 웹 서비스(WS-Management)를 호스트합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Authentication
서버에서 사용할 인증 메커니즘을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.
- 기초의. 기본은 사용자 이름과 암호가 서버 또는 프록시에 명확한 텍스트로 전송되는 체계입니다.
- 기본값. WS-Management 프로토콜에 의해 구현된 인증 방법을 사용합니다. 기본값입니다.
- 소화하다. 다이제스트는 챌린지에 서버 지정 데이터 문자열을 사용하는 챌린지-응답 체계입니다.
- Kerberos. 클라이언트 컴퓨터와 서버는 Kerberos 인증서를 사용하여 상호 인증합니다.
- 교섭하다. 협상은 인증에 사용할 체계를 결정하기 위해 서버 또는 프록시와 협상하는 챌린지 응답 체계입니다. 예를 들어 이 매개 변수 값을 사용하면 협상을 통해 Kerberos 프로토콜 또는 NTLM이 사용되는지 여부를 확인할 수 있습니다.
- CredSSP. 사용자가 자격 증명을 위임할 수 있는 CredSSP(자격 증명 보안 지원 공급자) 인증을 사용합니다. 이 옵션은 한 원격 컴퓨터에서 실행되지만 다른 원격 컴퓨터에서 데이터를 수집하거나 다른 원격 컴퓨터에서 추가 명령을 실행하는 명령을 위해 설계되었습니다.
주의: CredSSP는 사용자 자격 증명을 로컬 컴퓨터에서 원격 컴퓨터로 위임합니다. 이렇게 하면 원격 작업의 보안 위험이 증가합니다. 원격 컴퓨터가 손상된 경우 자격 증명이 전달되면 자격 증명을 사용하여 네트워크 세션을 제어할 수 있습니다.
중요: 인증 매개 변수를 지정하지 않으면 인증을 사용하지 않고 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: | Localhost |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Credential
이 작업을 수행할 수 있는 권한이 있는 사용자 계정을 지정합니다. 기본값은 현재 사용자입니다. User01, Domain01\User01 또는 User@Domain.com같은 사용자 이름을 입력합니다. 또는 Get-Credential cmdlet에서 반환된 개체와 같은 PSCredential 개체를 입력합니다. 사용자 이름을 입력하면 이 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은 입력을 허용하지 않습니다.
출력
None
이 cmdlet은 출력 개체를 생성하지 않습니다.
참고
기본적으로 Test-WSMan cmdlet은 인증을 사용하지 않고 WinRM 서비스를 쿼리하며 운영 체제 버전과 관련된 정보를 반환하지 않습니다. 대신 운영 체제 버전 및 서비스 팩 수준에 대한 null 값을 표시합니다(OS: 0.0.0 SP: 0.0).