Connect-WSMan

Connect-WSMan [-ApplicationName <string>] [-ComputerName <string>] [-Port <int>] [-UseSSL] [-Authentication <Authentication>] [-ComputerName <string>] [-Credential <PSCredential>] [-Port <int>] [-SessionOption <hashtable>] [<CommonParameters>]

Connect-WSMan [-ConnectionURI <Uri>] [-Authentication <Authentication>] [-ComputerName <string>] [-Credential <PSCredential>] [-Port <int>] [-SessionOption <hashtable>] [<CommonParameters>]

Connect-WSMan cmdlet은 원격 컴퓨터의 WinRM 서비스에 연결하고 원격 컴퓨터에 대한 영구 연결을 설정합니다. WS-Management 공급자 컨텍스트 내에서 이 cmdlet을 사용하여 원격 컴퓨터의 WinRM 서비스에 연결할 수 있습니다. 그러나 WS-Management 공급자로 변경하기 전에 이 cmdlet을 사용하여 원격 컴퓨터의 WinRM 서비스에 연결할 수도 있습니다. 원격 컴퓨터는 WS-Management 공급자의 루트 디렉터리에 나타납니다.

원격 컴퓨터의 WinRM 서비스에서 연결을 끊는 방법에 대한 자세한 내용은 Disconnect-WSMan을 참조하십시오.

-ApplicationName <string>

연결의 응용 프로그램 이름을 지정합니다. ApplicationName 매개 변수의 기본값은 "WSMAN"입니다. 원격 끝점에 대한 전체 식별자는 다음 형식을 사용합니다.

예를 들면 다음과 같습니다.

http://server01:8080/WSMAN

세션을 호스트하는 IIS(인터넷 정보 서비스)는 이 끝점이 있는 요청을 지정된 응용 프로그램으로 전달합니다. 대부분의 경우 이 "WSMAN" 기본 설정을 사용하면 됩니다. 이 매개 변수는 많은 컴퓨터가 Windows PowerShell을 실행하는 한 컴퓨터로 원격 연결을 설정하는 경우에 사용하도록 설계되었습니다. 이 경우 효율성을 위해 IIS는 WS-Management(Web Services for Management)를 호스팅합니다.

필수 여부	false
위치	named
기본값	wsman
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

-Authentication <Authentication>

서버에서 사용할 인증 메커니즘을 지정합니다. 사용할 수 있는 값:

- Basic: Basic은 사용자 이름 및 암호를 서버 또는 프록시에 일반 텍스트로 보내는 체계입니다.

- Default: WS-Management 프로토콜에서 구현하는 인증 방법을 사용합니다. 기본값입니다.

- Digest: Digest는 시도에 대해 서버 지정 데이터 문자열을 사용하는 시도-응답 체계입니다.

- Kerberos: 클라이언트 컴퓨터와 서버가 Kerberos 인증서를 사용하여 상호 인증합니다.

- Negotiate: Negotiate는 서버 또는 프록시와 협상하여 인증에 사용할 체계를 결정하는 시도-응답 체계입니다. 예를 들어 이 매개 변수 값은 협상을 통해 Kerberos 프로토콜 또는 NTLM 중 어느 것을 사용할지 결정할 수 있도록 허용합니다.

- CredSSP: 사용자가 자격 증명을 위임할 수 있는 CredSSP(자격 증명 보안 서비스 공급자) 인증을 사용합니다. 이 옵션은 한 원격 컴퓨터에서 실행되지만 다른 원격 컴퓨터에서 데이터를 수집하거나 추가 명령을 실행하는 명령에 사용하도록 설계되었습니다.

주의: CredSSP는 사용자의 자격 증명을 로컬 컴퓨터에서 원격 컴퓨터로 위임합니다. 이렇게 하면 원격 작업의 보안 위험이 높아집니다. 원격 컴퓨터가 손상된 경우 자격 증명이 이 컴퓨터로 전달되면 이 자격 증명을 사용하여 네트워크 세션을 제어할 수 있습니다.

필수 여부	false
위치	named
기본값	Default
파이프라인 입력 적용 여부	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

-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

-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

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_Commonparameters.

입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.

입력

없음

이 cmdlet은 어떠한 입력도 받지 않습니다.

출력

없음

이 cmdlet은 어떠한 출력도 생성하지 않습니다.

WS-Management 세션을 만들지 않고 원격 컴퓨터에서 관리 명령을 실행하거나 관리 데이터를 쿼리할 수 있습니다. Invoke-WSManAction 및 Get-WSManInstance의 ComputerName 매개 변수를 사용하여 이 작업을 수행할 수 있습니다. ComputerName 매개 변수를 사용하는 경우 Windows PowerShell은 단일 명령에 사용되는 임시 연결을 만듭니다. 명령이 실행된 후 연결이 닫힙니다.

C:\PS>Connect-WSMan -computer server01

PS C:\Users\testuser> cd wsman:
PS WSMan:\> 
PS WSMan:\> dir


   WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan

ComputerName                                  Type
------------                                  ----
localhost                                     Container
server01                                      Container

설명
-----------
이 명령은 원격 컴퓨터 server01에 대한 연결을 만듭니다.

일반적으로 Connect-WSMan cmdlet은 WS-Management 공급자 컨텍스트 내에서 원격 컴퓨터(이 경우 server01 컴퓨터)에 연결하는 데 사용됩니다. 그러나 WS-Management 공급자로 변경하기 전에 이 cmdlet을 사용하여 원격 컴퓨터에 대한 연결을 설정할 수 있습니다. 이러한 연결은 ComputerName 목록에 표시됩니다.

C:\PS>$cred = Get-Credential Administrator
Connect-WSMan -computer server01 -credential $cred

PS C:\Users\testuser> cd wsman:
PS WSMan:\>
PS WSMan:\> dir

WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan

ComputerName Type
------------ ----
localhost Container
server01 Container

설명
-----------
이 명령은 Administrator 계정 자격 증명을 사용하여 원격 시스템 server01에 대한 연결을 만듭니다.

첫 번째 명령은 Get-Credential cmdlet을 사용하여 Administrator 자격 증명을 가져와 $cred 변수에 저장합니다. Get-Credential cmdlet은 사용자 이름과 암호를 묻는 메시지를 사용자에게 표시합니다. 시스템 레지스트리 설정에 따라 대화 상자를 통해 또는 명령줄에
메시지가 표시됩니다.

두 번째 명령은 Credential 매개 변수를 사용하여 $cred에 저장된 자격 증명을 Connect-WSMan으로 전달합니다. Connect-WSMan은 Administrator 자격 증명을 사용하여 원격 시스템 server01에 연결합니다.

일반적으로 Connect-WSMan cmdlet은 WS-Management 공급자 컨텍스트 내에서 원격 컴퓨터(이 경우 server01)에 연결하는 데 사용됩니다. 그러나 WS-Management 공급자로 변경하기 전에 cmdlet을 사용하여 원격 컴퓨터에 대한 연결을 설정할 수 있으며, 이러한 연결은 ComputerName 목록에 표시됩니다.

C:\PS>Connect-WSMan -computer server01 -port 80

PS C:\Users\testuser> cd wsman:
PS WSMan:\> 
PS WSMan:\> dir


   WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan

ComputerName                                  Type
------------                                  ----
localhost                                     Container
server01                                      Container

설명
-----------
이 명령은 포트 80을 통해 원격 컴퓨터 server01에 대한 연결을 만듭니다.

일반적으로 Connect-WSMan cmdlet은 WS-Management 공급자 컨텍스트 내에서 원격 컴퓨터(이 경우 server01 컴퓨터)에 연결하는 데 사용됩니다. 그러나 WS-Management 공급자로 변경하기 전에 이 cmdlet을 사용하여 원격 컴퓨터에 대한 연결을 설정할 수 있습니다. 이러한 연결은 ComputerName 목록에 표시됩니다.

C:\PS>$a = New-WSManSessionOption -operationtimeout 30000
Connect-WSMan -computer server01 -sessionoption $a

PS C:\Users\testuser> cd wsman:
PS WSMan:\> 
PS WSMan:\> dir


   WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan

ComputerName                                  Type
------------                                  ----
localhost                                     Container
server01                                      Container

설명
-----------
이 명령은 New-WSManSessionOption 명령에 정의된 연결 옵션을 사용하여 원격 컴퓨터 server01에 대한 연결을 만듭니다.

첫 번째 명령은 New-WSManSessionOption cmdlet을 사용하여 연결 설정 옵션 집합을 $a 변수에 저장합니다. 이 경우 세션 옵션은 연결 시간 제한을 30초(30,000밀리초)로 설정합니다.

두 번째 명령은 SessionOption 매개 변수를 사용하여 $a 변수에 저장된 자격 증명을 Connect-WSMan으로 전달합니다. 그런 다음 Connect-WSMan은 지정된 세션 옵션을 사용하여 원격 컴퓨터 server01에 연결합니다.

일반적으로 Connect-WSMan cmdlet은 WS-Management 공급자 컨텍스트 내에서 원격 컴퓨터(이 경우 server01 컴퓨터)에 연결하는 데 사용됩니다. 그러나 WS-Management 공급자로 변경하기 전에 이 cmdlet을 사용하여 원격 컴퓨터에 대한 연결을 설정할 수 있습니다. 이러한 연결은 ComputerName 목록에 표시됩니다.