Enter-PSSession

Enter-PSSession [-ComputerName] <string> [-ApplicationName <string>] [-Authentication {<Default> | <Basic> | <Negotiate> | <NegotiateWithImplicitCredential> | <Credssp> | <Digest> | <Kerberos>}] [-CertificateThumbprint <string>] [-ConfigurationName <string>] [-Credential <PSCredential>] [-Port <int>] [-SessionOption <PSSessionOption>] [-UseSSL] [<CommonParameters>]

Enter-PSSession [[-Id] <int>] [<CommonParameters>]

Enter-PSSession [-InstanceId <Guid>] [<CommonParameters>]

Enter-PSSession [-Name <string>] [<CommonParameters>]

Enter-PSSession [[-Session] <PSSession>] [<CommonParameters>]

Enter-PSSession [[-ConnectionURI] <Uri>] [-AllowRedirection] [-Authentication {<Default> | <Basic> | <Negotiate> | <NegotiateWithImplicitCredential> | <Credssp> | <Digest> | <Kerberos>}] [-CertificateThumbprint <string>] [-ConfigurationName <string>] [-Credential <PSCredential>] [-SessionOption <PSSessionOption>] [<CommonParameters>]

Enter-PSSession cmdlet은 단일 원격 컴퓨터와 대화형 세션을 시작합니다. 세션 중에 사용자가 입력하는 명령은 원격 컴퓨터에서 직접 입력하는 것처럼 원격 컴퓨터에서 실행됩니다. 한 번에 하나의 대화형 세션만 사용할 수 있습니다.

일반적으로 ComputerName 매개 변수를 사용하여 원격 컴퓨터의 이름을 지정합니다. 그러나 대화형 세션을 위해 New-PSSession을 사용하여 만드는 세션을 사용할 수도 있습니다.

대화형 세션을 종료하고 원격 컴퓨터의 연결을 끊으려면 Exit-PSSession cmdlet을 사용하거나 "exit"를 입력합니다.

-AllowRedirection

이 연결을 대체 URI(Uniform Resource Identifier)로 리디렉션할 수 있도록 합니다.

ConnectionURI 매개 변수를 사용하는 경우 원격 대상은 다른 URI로 리디렉션하라는 지침을 반환할 수 있습니다. 기본적으로 Windows PowerShell은 연결을 리디렉션하지 않지만 이 매개 변수를 사용하여 Windows PowerShell이 연결을 리디렉션하도록 허용할 수 있습니다.

이 연결을 대체 URI로 리디렉션할 수 있도록 허용합니다.

ConnectionURI 매개 변수를 사용하는 경우 원격 대상은 다른 URI로 리디렉션하라는 지침을 반환할 수 있습니다. 기본적으로 Windows PowerShell은 연결을 리디렉션하지 않지만 AllowRedirection 매개 변수를 사용하여 Windows PowerShell이 연결을 리디렉션하도록 허용할 수 있습니다.

$PSSessionOption 기본 설정 변수의 MaximumConnectionRedirectionCount 속성 또는 SessionOption 매개 변수 값의 MaximumConnectionRedirectionCount 속성을 설정하여 연결이 리디렉션되는 횟수를 제한할 수도 있습니다. 기본값은 5입니다. 자세한 내용은 SessionOption 매개 변수 설명과 New-PSSessionOption을 참조하십시오.

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

-ApplicationName <string>

연결 URI의 응용 프로그램 이름 세그먼트를 지정합니다. 이 매개 변수를 사용하여 명령에 ConnectionURI 매개 변수를 사용하지 않는 경우 응용 프로그램 이름을 지정할 수 있습니다.

기본값은 로컬 컴퓨터의 $PSSessionApplicationName 기본 설정 변수의 값입니다. 이 기본 설정 변수를 정의하지 않으면 WSMAN이 기본값으로 사용됩니다. 대부분의 경우 이 값을 사용하면 됩니다. 자세한 내용은 about_Preference_Variables를 참조하십시오.

WinRM 서비스는 응용 프로그램 이름을 사용하여 연결 요청을 서비스하는 수신기를 선택합니다. 이 매개 변수 값은 원격 컴퓨터에 있는 수신기의 URLPrefix 속성 값과 일치해야 합니다.

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

-Authentication <AuthenticationMechanism>

사용자 자격 증명을 인증하는 데 사용되는 메커니즘을 지정합니다. 유효한 값은 "Default", "Basic", "Credssp", "Digest", "Kerberos", "Negotiate" 및 "NegotiateWithImplicitCredential"입니다. 기본값은 "Default"입니다.

CredSSP 인증은 Windows Vista 및 Windows Server 2008 이상에서만 사용할 수 있습니다.

이 매개 변수 값에 대한 자세한 내용은 MSDN(Microsoft Developer Network) 라이브러리의 System.Management.Automation.Runspaces.AuthenticationMechanism 열거형에 대한 설명(https://go.microsoft.com/fwlink/?LinkId=144382)을 참조하십시오.

주의: 사용자의 자격 증명이 인증을 위해 원격 컴퓨터로 전달되는 CredSSP(자격 증명 보안 서비스 공급자) 인증은 원격 네트워크 공유에 액세스하는 것처럼 둘 이상의 리소스에서 인증이 필요한 명령을 위한 것입니다. 이렇게 하면 원격 작업의 보안 위험이 높아집니다. 원격 컴퓨터가 손상된 경우 이 컴퓨터로 전달된 자격 증명을 사용하여 네트워크 세션을 제어할 수 있습니다.

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

-CertificateThumbprint <string>

이 작업을 수행할 권한이 있는 사용자 계정의 디지털 공개 키 인증서(X509)를 지정합니다. 인증서의 인증서 손 도장(Thumbprint)을 입력합니다.

인증서는 클라이언트 인증서 기반 인증에 사용됩니다. 인증서는 로컬 사용자 계정으로만 매핑될 수 있고 도메인 계정에는 사용할 수 없습니다.

인증서 손 도장(Thumbprint)을 가져오려면 Windows PowerShell Cert: 드라이브에서 Get-Item 또는 Get-ChildItem 명령을 사용합니다.

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

-ComputerName <string>

지정된 원격 컴퓨터와 대화형 세션을 시작합니다. 컴퓨터 이름을 하나만 입력하십시오. 기본값은 로컬 컴퓨터입니다.

하나 이상의 원격 컴퓨터의 NetBIOS 이름, IP 주소 또는 정규화된 도메인 이름을 입력합니다. 또한 컴퓨터 이름을 Enter-PSSession으로 파이프할 수 있습니다.

ComputerName 매개 변수의 값에 IP 주소를 사용하려면 명령에 Credential 매개 변수를 포함해야 합니다. 또한 HTTPS 전송을 사용하도록 컴퓨터를 구성하거나 원격 컴퓨터의 IP 주소를 로컬 컴퓨터의 WinRM TrustedHosts 목록에 포함해야 합니다. 컴퓨터 이름을 TrustedHosts 목록에 추가하는 방법에 대한 지침은 about_Remote_Troubleshooting의 "How to Add a Computer to the Trusted Host List(신뢰할 수 있는 호스트 목록에 컴퓨터를 추가하는 방법)"를 참조하십시오.

참고: Windows Vista 이상 버전에서 ComputerName 매개 변수 값에 로컬 컴퓨터를 포함하려면 "관리자 권한으로 실행" 옵션을 사용하여 Windows PowerShell을 시작해야 합니다.

필수 여부	true
위치	1
기본값
파이프라인 입력 적용 여부	true (ByValue, ByPropertyName)
와일드카드 문자 적용 여부	false

-ConfigurationName <string>

대화형 세션에 사용할 세션 구성을 지정합니다.

구성 이름 또는 세션 구성에 대한 정규화된 리소스 URI를 입력합니다. 구성 이름만 지정하는 경우 스키마 URI https://schemas.microsoft.com/powershell이 앞에 추가됩니다.

세션의 세션 구성은 원격 컴퓨터에 있습니다. 지정된 세션 구성이 원격 컴퓨터에 없으면 명령이 실패합니다.

기본값은 로컬 컴퓨터의 $PSSessionConfigurationName 기본 설정 변수의 값입니다. 이 기본 설정 변수를 설정하지 않으면 Microsoft.PowerShell이 기본값으로 사용됩니다. 자세한 내용은 about_Preference_Variables를 참조하십시오.

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

-ConnectionURI <Uri>

대화형 세션의 연결 끝점을 정의하는 URI(Uniform Resource Identifier)를 지정합니다. URI는 정규화된 URI여야 합니다.

이 문자열의 형식은 다음과 같습니다.

기본값은 다음과 같습니다.

http://localhost:80/WSMAN

URI의 전송 세그먼트에 유효한 값은 HTTP 및 HTTPS입니다. ConnectionURI를 지정하지 않으면 UseSSL, ComputerName, Port 및 ApplicationName 매개 변수를 사용하여 URI 값을 지정할 수 있습니다.

대상 컴퓨터가 연결을 다른 URI로 리디렉션하는 경우 Windows PowerShell은 명령에 AllowRedirection 매개 변수가 사용되지 않은 한 리디렉션을 허용하지 않습니다.

필수 여부	false
위치	2
기본값
파이프라인 입력 적용 여부	true (ByPropertyName)
와일드카드 문자 적용 여부	false

-Credential <PSCredential>

이 작업을 수행할 수 있는 권한을 가진 사용자 계정을 지정합니다. 기본값은 현재 사용자입니다.

"User01", "Domain01\User01" 또는 "User@Domain.com"과 같은 사용자 이름을 입력하거나 Get-Credential cmdlet에서 반환한 것과 같은 PSCredential 개체를 입력합니다.

사용자 이름을 입력하면 암호를 묻는 메시지가 표시됩니다.

필수 여부	false
위치	named
기본값	Current user
파이프라인 입력 적용 여부	true (ByPropertyName)
와일드카드 문자 적용 여부	false

-Id <int>

기존 세션의 ID를 지정합니다. Enter-PSSession은 대화형 세션에 지정된 세션을 사용합니다.

세션의 ID를 찾으려면 Get-PSSession cmdlet을 사용합니다.

필수 여부	false
위치	1
기본값
파이프라인 입력 적용 여부	true (ByPropertyName)
와일드카드 문자 적용 여부	false

-InstanceId <Guid>

기존 세션의 인스턴스 ID를 지정합니다. Enter-PSSession은 대화형 세션에 지정된 세션을 사용합니다.

인스턴스 ID는 GUID입니다. 세션의 인스턴스 ID를 찾으려면 Get-PSSession cmdlet을 사용합니다. Session, Name 또는 ID 매개 변수를 사용하여 기존 세션을 지정할 수도 있습니다. 또는 ComputerName 매개 변수를 사용하여 임시 세션을 시작할 수 있습니다.

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

-Name <string>

기존 세션의 이름을 지정합니다. Enter-PSSession은 대화형 세션에 지정된 세션을 사용합니다.

지정한 이름이 둘 이상의 세션과 일치하는 경우 명령이 실패합니다. Session, InstanceID 또는 ID 매개 변수를 사용하여 기존 세션을 지정할 수도 있습니다. 또는 ComputerName 매개 변수를 사용하여 임시 세션을 시작할 수 있습니다.

세션의 이름을 설정하려면 New-PSSession cmdlet의 Name 매개 변수를 사용합니다.

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

-Port <int>

이 명령에 사용할 원격 컴퓨터의 네트워크 포트를 지정합니다. 기본값은 포트 80(HTTP 포트)입니다.

대체 포트를 사용하려면 먼저 원격 컴퓨터에 해당 포트에서 수신할 WinRM 수신기를 구성해야 합니다. 다음 명령을 사용하여 수신기를 구성합니다.

1. winrm delete winrm/config/listener?Address=*+Transport=HTTP

2. winrm create winrm/config/listener?Address=*+Transport=HTTP @{Port="<port-number>"}

꼭 필요한 경우가 아니면 Port 매개 변수를 사용하지 마십시오. 명령의 포트 설정은 이 명령이 실행되는 모든 컴퓨터나 세션에 적용됩니다. 대체 포트 설정을 사용하면 일부 컴퓨터에서 명령이 실행되지 않을 수 있습니다.

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

-Session <PSSession>

대화형 세션에 사용할 Windows PowerShell 세션(PSSession)을 지정합니다. 이 매개 변수는 세션 개체를 받습니다. Name, InstanceID 또는 ID 매개 변수를 사용하여 PSSession을 지정할 수도 있습니다.

세션 개체가 포함된 변수를 입력하거나 세션 개체를 만들거나 가져오는 명령(예: New-PSSession 또는 Get-PSSession 명령)을 입력합니다. 또한 세션 개체를 Enter-PSSession으로 파이프할 수 있습니다. 이 매개 변수를 사용하여 PSSession을 하나만 전송할 수 있습니다. 둘 이상의 PSSession이 포함된 변수를 입력하는 경우 명령이 실패합니다.

Exit-PSSession 또는 EXIT 키워드를 사용하면 대화형 세션이 종료되지만 사용자가 만든 PSSession은 열려 있으므로 사용할 수 있습니다.

필수 여부	false
위치	1
기본값
파이프라인 입력 적용 여부	true (ByValue, ByPropertyName)
와일드카드 문자 적용 여부	true

-SessionOption <PSSessionOption>

세션의 고급 옵션을 설정합니다. New-PSSessionOption cmdlet을 사용하여 만든 SessionOption 개체를 입력합니다.

옵션의 기본값은 $PSSessionOption 기본 설정 변수의 값(설정되어 있는 경우)에 의해 결정됩니다. 그렇지 않으면 세션에서 시스템 기본값이 사용됩니다.

세션 옵션 및 기본값에 대한 자세한 내용은 New-PSSessionOption을 참조하십시오. $PSSessionOption 기본 설정 변수에 대한 자세한 내용은 about_Preference_Variables를 참조하십시오.

필수 여부	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에서 반환되는 개체의 유형입니다.

입력

System.String 또는 System.Management.Automation.Runspaces.PSSession

컴퓨터 이름(문자열) 또는 세션 개체를 Enter-PSSession으로 파이프할 수 있습니다.

출력

없음

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

-- 원격 컴퓨터에 연결하려면 원격 컴퓨터에서 Administrators 그룹의 구성원이어야 합니다.

-- Windows Vista 이상 버전의 로컬 컴퓨터에서 대화형 세션을 시작하려면 "관리자 권한으로 실행" 옵션을 사용하여 Windows PowerShell을 시작해야 합니다.

-- Enter-PSSession을 사용하는 경우 원격 컴퓨터의 사용자 프로필이 대화형 세션에 사용됩니다. Windows PowerShell 스냅인을 추가하고 명령 프롬프트를 변경하는 명령을 비롯한 원격 사용자 프로필의 명령은 원격 프롬프트가 표시되기 전에 실행됩니다.

-- Enter-PSSession은 로컬 컴퓨터의 UI culture 설정을 대화형 세션에 사용합니다. 로컬 UI culture를 찾으려면 $UICulture 자동 변수를 사용합니다.

-- Enter-PSSession에는 Get-Command, Out-Default 및 Exit-PSSession cmdlet이 필요합니다. 이러한 cmdlet이 원격 컴퓨터의 세션 구성에 포함되어 있지 않으면 Enter-PSSession 명령이 실패합니다.

-- 명령을 원격 컴퓨터로 보내기 전에 구문을 분석하고 해석하는 Invoke-Command와 달리 Enter-PSSession은 해석하지 않고 명령을 직접 원격 컴퓨터로 보냅니다.

C:\PS>Enter-PSSession

LocalHost\PS>

설명
-----------
이 명령은 로컬 컴퓨터에서 대화형 세션을 시작합니다. 명령 프롬프트가 변경되어 현재 다른 세션에서 명령을 실행하고 있음을 나타냅니다.

입력한 명령은 새 세션에서 실행되고 결과가 기본 세션에 텍스트로 반환됩니다.

C:\PS>enter-pssession -computer Server01

Server01\PS> get-process powershell > C:\ps-test\process.txt

Server01\PS> exit-pssession
C:\PS>

C:\PS> dir C:\ps-test\process.txt
Get-ChildItem : Cannot find path 'C:\ps-test\process.txt' because it does not exist.
At line:1 char:4
+ dir <<<<  c:\ps-test\process.txt

설명
-----------
이 명령은 원격 컴퓨터와의 대화형 세션에서 작업하는 방법을 보여 줍니다.

첫 번째 명령은 Enter-PSSession cmdlet을 사용하여 Server01 원격 컴퓨터와 대화형 세션을 시작합니다. 세션이 시작되면 명령 프롬프트가 변경되어 컴퓨터 이름을 포함합니다.

두 번째 명령은 PowerShell 프로세스를 가져오고 출력을 Process.txt 파일로 리디렉션합니다. 이 명령은 원격 컴퓨터에 전송되고 Process.txt 파일이 원격 컴퓨터에 저장됩니다. 

세 번째 명령은 Exit 키워드를 사용하여 대화형 세션을 종료하고 연결을 닫습니다.

네 번째 명령은 Process.txt 파일이 원격 컴퓨터에 있는지 확인합니다. 로컬 컴퓨터의 Get-ChildItem("dir") 명령은 이 파일을 찾을 수 없습니다.

C:\PS>$s = new-pssession -computername Server01

C:\PS> Enter-PSSession -session $s

Server01\PS>

설명
-----------
이들 명령은 Enter-PSSession의 Session 매개 변수를 사용하여 기존 Windows PowerShell 세션(PSSession)에서 대화형 세션을 실행합니다.

C:\PS>Enter-PSSession -computername Server01 -port 90 -credential domain01\user01

Server01\PS>

설명
-----------
이 명령은 Server01 컴퓨터와 대화형 세션을 시작합니다. 이 명령은 Port 매개 변수를 사용하여 포트를 지정하고 Credential 매개 변수를 사용하여 원격 컴퓨터에 연결할 수 있는 권한을 가진 사용자의 계정을 지정합니다.

C:\PS>Enter-PSSession -computername Server01

Server01:\PS> Exit-PSSession

C:\PS>

설명
-----------
이 예에서는 대화형 세션을 시작하고 중지하는 방법을 보여 줍니다. 첫 번째 명령은 Enter-PSSession cmdlet을 사용하여 Server01 컴퓨터와 대화형 세션을 시작합니다. 

두 번째 명령은 Exit-PSSession cmdlet을 사용하여 세션을 종료합니다. Exit 키워드를 사용하여 대화형 세션을 종료할 수도 있습니다. Exit-PSSession과 Exit는 동일한 효과가 있습니다.