New-WSManInstance
관리 리소스의 새 인스턴스를 만듭니다.
구문
New-WSManInstance [-ApplicationName <string>] [-ComputerName <string>] [-Credential <PSCredential>] [-Port <int>] [-UseSSL] [-SelectorSet] <hashtable> -ResourceURI <Uri> [-AuthenticationMechanism <AuthenticationMechanism>] [-SessionOption <hashtable>] [-ValueSet <hashtable>] [<CommonParameters>]
New-WSManInstance [-ConnectionURI <Uri>] [-SelectorSet] <hashtable> -ResourceURI <Uri> [-AuthenticationMechanism <AuthenticationMechanism>] [-SessionOption <hashtable>] [-ValueSet <hashtable>] [<CommonParameters>]
설명
New-WSManInstance cmdlet은 관리 리소스의 새 인스턴스를 만듭니다. 이 cmdlet은 리소스 URI 및 값 집합이나 입력 파일을 사용하여 새로운 관리 리소스 인스턴스를 만듭니다.
이 cmdlet은 WinRM 연결/전송 계층을 사용하여 관리 리소스 인스턴스를 만듭니다.
매개 변수
-ApplicationName <string>
연결의 응용 프로그램 이름을 지정합니다. ApplicationName 매개 변수의 기본값은 "WSMAN"입니다. 원격 끝점에 대한 전체 식별자는 다음 형식을 사용합니다.
<transport>://<server>:<port>/<ApplicationName>
예를 들면 다음과 같습니다.
http://server01:8080/WSMAN
세션을 호스트하는 IIS(인터넷 정보 서비스)는 이 끝점이 있는 요청을 지정된 응용 프로그램으로 전달합니다. 대부분의 경우 이 "WSMAN" 기본 설정을 사용하면 됩니다. 이 매개 변수는 많은 컴퓨터가 Windows PowerShell을 실행하는 한 컴퓨터로 원격 연결을 설정하는 경우에 사용하도록 설계되었습니다. 이 경우 효율성을 위해 IIS는 WS-Management(Web Services for Management)를 호스트합니다.
필수 여부 |
false |
위치 |
named |
기본값 |
wsman |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-AuthenticationMechanism <AuthenticationMechanism>
서버에서 사용할 인증 메커니즘을 지정합니다. 사용할 수 있는 값:
- Basic: Basic은 사용자 이름 및 암호를 서버 또는 프록시에 일반 텍스트로 보내는 체계입니다.
- Default: WS-Management 프로토콜에서 구현하는 인증 방법을 사용합니다. 기본값입니다.
- Digest: Digest는 시도에 대해 서버 지정 데이터 문자열을 사용하는 시도-응답 체계입니다.
- Kerberos: 클라이언트 컴퓨터와 서버가 Kerberos 인증서를 사용하여 상호 인증합니다.
- Negotiate: Negotiate는 서버 또는 프록시와 협상하여 인증에 사용할 체계를 결정하는 시도-응답 체계입니다. 예를 들어 이 매개 변수 값은 협상을 통해 Kerberos 프로토콜 또는 NTLM 중 어느 것을 사용할지 결정할 수 있도록 허용합니다.
- CredSSP: 사용자가 자격 증명을 위임할 수 있는 CredSSP(자격 증명 보안 서비스 공급자) 인증을 사용합니다. 이 옵션은 한 원격 컴퓨터에서 실행되지만 다른 원격 컴퓨터에서 데이터를 수집하거나 추가 명령을 실행하는 명령에 사용하도록 설계되었습니다.
주의: CredSSP는 사용자의 자격 증명을 로컬 컴퓨터에서 원격 컴퓨터로 위임합니다. 이렇게 하면 원격 작업의 보안 위험이 높아집니다. 원격 컴퓨터가 손상된 경우 자격 증명이 이 컴퓨터로 전달되면 이 자격 증명을 사용하여 네트워크 세션을 제어할 수 있습니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-ComputerName <string>
관리 작업을 실행할 컴퓨터를 지정합니다. 값은 정규화된 도메인 이름, NetBIOS 이름 또는 IP 주소일 수 있습니다. 로컬 컴퓨터 이름, localhost 또는 점(.)을 사용하여 로컬 컴퓨터를 지정합니다. 기본값은 로컬 컴퓨터입니다. 원격 컴퓨터가 사용자와 다른 도메인에 있는 경우 정규화된 도메인 이름을 사용해야 합니다. 이 매개 변수의 값을 cmdlet으로 파이프할 수 있습니다.
필수 여부 |
false |
위치 |
named |
기본값 |
localhost |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-ConnectionURI <Uri>
연결 끝점을 지정합니다. 이 문자열의 형식은 다음과 같습니다.
<Transport>://<Server>:<Port>/<ApplicationName>
다음 문자열은 형식이 제대로 지정된 이 매개 변수의 값입니다.
http://Server01:8080/WSMAN
URI는 정규화된 URI여야 합니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-Credential <PSCredential>
이 작업을 수행할 수 있는 권한을 가진 사용자 계정을 지정합니다. 기본값은 현재 사용자입니다. "User01", "Domain01\User01" 또는 "User@Domain.com"과 같은 사용자 이름을 입력합니다. 또는 Get-Credential cmdlet에서 반환된 개체와 같은 PSCredential 개체를 입력합니다. 사용자 이름을 입력하면 암호를 묻는 메시지가 표시됩니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-File <File>
관리 리소스를 만드는 데 사용되는 파일의 경로를 지정합니다. ResourceURI 매개 변수 및 SelectorSet 매개 변수를 사용하여 관리 리소스를 지정합니다. 예를 들어 다음 명령은 File 매개 변수를 사용합니다.
invoke-wsmanaction -action stopservice -resourceuri wmicimv2/Win32_Service -SelectorSet @{Name="spooler"} -File c:\input.xml -authentication default
이 명령은 파일의 입력을 사용하여 스풀러 서비스에서 StopService 메서드 [descriptor]를 호출합니다. Input.xml 파일에는 다음과 같은 내용이 포함되어 있습니다.
<p:StopService_INPUT xmlns:p="https://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service"/>
필수 여부 |
|
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-OptionSet <hashtable>
요청의 특징을 수정하거나 구체화하기 위해 서비스로 스위치 집합을 전달합니다. 이러한 스위치는 서비스에 따라 달라진다는 점에서 명령줄 셸에 사용되는 스위치와 유사합니다. 원하는 개수만큼 옵션을 지정할 수 있습니다.
다음 예에서는 a, b 및 c 매개 변수에 값 1, 2 및 3을 전달하는 구문을 보여 줍니다.
-OptionSet @{a=1;b=2;c=3}
필수 여부 |
|
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-Port <int>
클라이언트가 WinRM 서비스에 연결할 때 사용할 포트를 지정합니다. 전송이 HTTP인 경우 기본 포트는 80입니다. 전송이 HTTPS인 경우 기본 포트는 443입니다. 전송으로 HTTPS를 사용하는 경우 ComputerName 매개 변수 값이 서버의 인증서 CN(일반 이름)과 일치해야 합니다. 하지만 SkipCNCheck 매개 변수가 SessionOption 매개 변수의 일부로 지정된 경우에는 서버의 인증서 일반 이름이 서버의 호스트 이름과 일치하지 않아도 됩니다. SkipCNCheck 매개 변수는 신뢰할 수 있는 컴퓨터에 대해서만 사용해야 합니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-ResourceURI <Uri>
리소스 클래스 또는 인스턴스의 URI(Uniform Resource Identifier)를 포함합니다. URI는 컴퓨터에서 디스크 또는 프로세스와 같은 특정 리소스 유형을 식별하는 데 사용됩니다.
URI는 접두사와 리소스에 대한 경로로 구성됩니다. 예를 들면 다음과 같습니다.
https://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32\_LogicalDisk
http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM\_NumericSensor
필수 여부 |
true |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-SelectorSet <hashtable>
특정 관리 리소스 인스턴스를 선택하는 데 사용되는 값 쌍의 집합을 지정합니다. SelectorSet 매개 변수는 리소스의 인스턴스가 두 개 이상 있을 때 사용됩니다. SelectorSet 매개 변수 값은 해시 테이블이어야 합니다.
다음 예에서는 이 매개 변수의 값을 입력하는 방법을 보여 줍니다.
-SelectorSet @{Name="WinRM";ID="yyy"}
필수 여부 |
true |
위치 |
2 |
기본값 |
|
파이프라인 입력 적용 여부 |
true (ByValue) |
와일드카드 문자 적용 여부 |
false |
-SessionOption <hashtable>
WS-Management 세션에 대한 확장 옵션 집합을 정의합니다. New-WSManSessionOption cmdlet을 사용하여 만든 SessionOption 개체를 입력합니다. 사용할 수 있는 옵션에 대한 자세한 내용은 New-WSManSessionOption을 참조하십시오.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-UseSSL
SSL(Secure Sockets Layer) 프로토콜을 사용하여 원격 컴퓨터에 연결해야 하도록 지정합니다. 기본적으로 SSL은 사용되지 않습니다.
WS-Management는 네트워크로 전송되는 모든 Windows PowerShell 콘텐츠를 암호화합니다. UseSSL 매개 변수를 사용하면 HTTP 대신 HTTPS의 추가적인 보호 기능을 지정할 수 있습니다. 연결에 사용되는 포트에서 SSL을 사용할 수 없는 경우 이 매개 변수를 지정하면 명령이 실패합니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-ValueSet <hashtable>
관리 리소스 수정에 도움을 주는 해시 테이블을 지정합니다. ResourceURI 매개 변수 및 SelectorSet 매개 변수를 사용하여 관리 리소스를 지정합니다. ValueSet 매개 변수 값은 해시 테이블이어야 합니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
<CommonParameters>
이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_commonparameters.
입력 및 출력
입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.
입력 |
없음 이 cmdlet은 어떠한 입력도 받지 않습니다. |
출력 |
없음 이 cmdlet은 어떠한 출력도 생성하지 않습니다. |
참고
Set-WmiInstance cmdlet인 WMI(Windows Management Instrumentation) cmdlet도 이와 유사합니다. Set-WmiInstance는 DCOM 연결/전송 계층을 사용하여 WMI 인스턴스를 만들거나 업데이트합니다.
예 1
C:\PS>New-WSManInstance winrm/config/Listener -SelectorSet @{Transport=HTTPS} -ValueSet @{Hostname="HOST";CertificateThumbprint="XXXXXXXXXX"}
설명
-----------
이 명령은 모든 IP 주소에 WS-Management HTTPS 수신기 인스턴스를 만듭니다.
참고 항목
개념
Connect-WSMan
Disable-WSManCredSSP
Disconnect-WSMan
Enable-WSManCredSSP
Get-WSManCredSSP
Get-WSManInstance
Invoke-WSManAction
New-WSManSessionOption
Remove-WSManInstance
Set-WSManInstance
Set-WSManQuickConfig
Test-WSMan