Enter-PSSession

참조

모듈:: Microsoft.PowerShell.Core

원격 컴퓨터로 대화형 세션을 시작합니다.

Syntax

Enter-PSSession
     [-ComputerName] <String>
     [-EnableNetworkAccess]
     [[-Credential] <PSCredential>]
     [-ConfigurationName <String>]
     [-Port <Int32>]
     [-UseSSL]
     [-ApplicationName <String>]
     [-SessionOption <PSSessionOption>]
     [-Authentication <AuthenticationMechanism>]
     [-CertificateThumbprint <String>]
     [<CommonParameters>]

Enter-PSSession
     [-HostName] <String>
     [-Options <Hashtable>]
     [-Port <Int32>]
     [-UserName <String>]
     [-KeyFilePath <String>]
     [-Subsystem <String>]
     [-ConnectingTimeout <Int32>]
     [-SSHTransport]
     [<CommonParameters>]

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

Enter-PSSession
     [[-ConnectionUri] <Uri>]
     [-EnableNetworkAccess]
     [[-Credential] <PSCredential>]
     [-ConfigurationName <String>]
     [-AllowRedirection]
     [-SessionOption <PSSessionOption>]
     [-Authentication <AuthenticationMechanism>]
     [-CertificateThumbprint <String>]
     [<CommonParameters>]

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

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

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

Enter-PSSession
     [-VMId] <Guid>
     [-Credential] <PSCredential>
     [-ConfigurationName <String>]
     [<CommonParameters>]

Enter-PSSession
     [-VMName] <String>
     [-Credential] <PSCredential>
     [-ConfigurationName <String>]
     [<CommonParameters>]

Enter-PSSession
     [-ContainerId] <String>
     [-ConfigurationName <String>]
     [-RunAsAdministrator]
     [<CommonParameters>]

Description

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

일반적으로 ComputerName 매개 변수를 사용하여 원격 컴퓨터의 이름을 지정합니다. 그러나 대화형 세션에 cmdlet을 사용하여 New-PSSession 만든 세션을 사용할 수도 있습니다. 그러나 대화Connect-PSSession형 세션의 Disconnect-PSSession연결을 끊거나 다시 연결하는 데는 cmdlet 또는 Receive-PSSession cmdlet을 사용할 수 없습니다.

PowerShell 6.0부터 SSH(Secure Shell)를 사용하여 로컬 컴퓨터에서 SSH를 사용할 수 있고 원격 컴퓨터가 PowerShell SSH 엔드포인트로 구성된 경우 원격 컴퓨터에 대한 연결을 설정할 수 있습니다. SSH 기반 PowerShell 원격 세션의 이점은 여러 플랫폼(Windows, Linux, macOS)에서 작동한다는 것입니다. SSH 기반 원격의 경우 HostName 매개 변수 집합을 사용하여 원격 컴퓨터 및 관련 연결 정보를 지정합니다. PowerShell SSH 원격을 설정하는 방법에 대한 자세한 내용은 SSH를 통해 PowerShell 원격을 참조하세요.

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

예제

예제 1: 대화형 세션 시작

PS> Enter-PSSession
[localhost]: PS>

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

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

예제 2: 대화형 세션 작업

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

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

세 번째 명령은 Exit 키워드(keyword) 사용하여 대화형 세션을 종료하고 연결을 닫습니다. 네 번째 명령은 Process.txt 파일이 원격 컴퓨터에 있는지 확인합니다. 로컬 컴퓨터의 ( Get-ChildItem "dir") 명령은 파일을 찾을 수 없습니다.

PS C:\> Enter-PSSession -ComputerName Server01
[Server01]: PS C:\>
[Server01]: PS C:\> Get-Process PowerShell > C:\ps-test\Process.txt
[Server01]: PS C:\> exit
PS C:\>
PS C:\> 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

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

예제 3: 세션 매개 변수 사용

PS> $s = New-PSSession -ComputerName Server01
PS> Enter-PSSession -Session $s
[Server01]: PS>

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

예제 4: 대화형 세션을 시작하고 포트 및 자격 증명 매개 변수 지정

PS> Enter-PSSession -ComputerName Server01 -Port 90 -Credential Domain01\User01
[Server01]: PS>

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

예제 5: 대화형 세션 중지

PS> Enter-PSSession -ComputerName Server01
[Server01]: PS> Exit-PSSession
PS>

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

두 번째 명령은 cmdlet을 Exit-PSSession 사용하여 세션을 종료합니다. Exit 키워드(keyword) 사용하여 대화형 세션을 종료할 수도 있습니다. Exit-PSSession 종료와 같은 효과가 있습니다.

예제 6: SSH를 사용하여 대화형 세션 시작

PS> Enter-PSSession -HostName UserA@LinuxServer01

이 예제에서는 SSH(Secure Shell)를 사용하여 대화형 세션을 시작하는 방법을 보여 줍니다. 원격 컴퓨터에서 암호를 사용하도록 SSH가 구성된 경우 암호를 입력하라는 메시지가 표시됩니다. 그렇지 않으면 키 기반 사용자 인증을 사용해야 합니다.

예제 7: 포트 및 사용자 인증 키와 함께 SSH를 사용하여 대화형 세션 시작

PS> Enter-PSSession -HostName UserA@LinuxServer02:22 -KeyFilePath c:\sshkeys\userAKey_rsa

이 예제에서는 SSH를 사용하여 대화형 세션을 시작하는 방법을 보여줍니다. 사용자 이름 및 SSH 포트 번호는 HostName 매개 변수 값의 일부로 지정됩니다. KeyFilePath 매개 변수는 원격 컴퓨터에서 사용자를 인증하는 데 사용되는 RSA 키의 위치를 지정합니다.

예제 8: SSH 옵션을 사용하여 대화형 세션 시작

$options = @{
    Port=22
    User = 'UserA'
    Host = 'LinuxServer02'
}
Enter-PSSession -KeyFilePath c:\sshkeys\userAKey_rsa -Options $options

이 예제에서는 SSH를 사용하여 대화형 세션을 시작하는 방법을 보여줍니다. Options 매개 변수는 원격 시스템에 대한 연결을 설정한 기본 ssh 명령에 옵션으로 전달되는 값의 해시 테이블을 사용합니다.

매개 변수

-AllowRedirection

이 연결을 대체 URI(Uniform Resource Identifier)로 리디렉션할 수 있습니다. 기본적으로 리디렉션은 허용되지 않습니다.

커넥트ionURI 매개 변수를 사용하는 경우 원격 대상은 다른 URI로 리디렉션하는 명령을 반환할 수 있습니다. 기본적으로 PowerShell은 연결을 리디렉션하지 않지만 이 매개 변수를 사용하여 연결을 리디렉션할 수 있습니다.

최대커넥트ionRedirectionCount 세션 옵션 값을 변경하여 연결이 리디렉션되는 횟수를 제한할 수도 있습니다. cmdlet의 MaximumRedirection 매개 변수를 New-PSSessionOption 사용하거나 기본 설정 변수의 Maximum커넥트ionRedirectionCount 속성을 $PSSessionOption 설정합니다. 기본 값은 5입니다.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationName

연결 URI의 애플리케이션 이름 세그먼트를 지정합니다. 명령에서 커넥트ionURI 매개 변수를 사용하지 않을 때 이 매개 변수를 사용하여 애플리케이션 이름을 지정합니다.

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

WinRM 서비스는 애플리케이션 이름을 사용하여 연결 요청을 서비스할 수신기를 선택합니다. 이 매개 변수의 값은 원격 컴퓨터에서 수신기의 URLPrefix 속성 값과 일치해야 합니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Authentication

사용자의 자격 증명을 인증하는 데 사용되는 메커니즘을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

기본값
기본
Credssp
다이제스트
Kerberos
Negotiate
NegotiateWithImplicitCredential

기본값은 Default입니다.

CredSSP 인증은 Windows Vista, Windows Server 2008 이상 버전의 Windows 운영 체제에서만 사용할 수 있습니다.

이 매개 변수의 값에 대한 자세한 내용은 AuthenticationMechanism 열거형을 참조 하세요.

주의

사용자의 자격 증명이 인증될 원격 컴퓨터에 전달되는 CredSSP(자격 증명 보안 지원 공급자) 인증은 원격 네트워크 공유 액세스와 같이 둘 이상의 리소스에 대한 인증이 필요한 명령을 위해 설계되었습니다. 이 메커니즘은 원격 작업의 보안 위험을 높입니다. 원격 컴퓨터가 손상된 경우 이 컴퓨터로 전달된 자격 증명을 사용하여 네트워크 세션을 제어할 수 있습니다.

Type:	AuthenticationMechanism
Accepted values:	Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificateThumbprint

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

인증서는 클라이언트 인증서 기반 인증에 사용됩니다. 로컬 사용자 계정에만 매핑할 수 있습니다. do기본 계정으로는 작동하지 않습니다.

인증서를 얻으려면 PowerShell 인증서: 드라이브에서 또는 Get-ChildItem 명령을 사용합니다Get-Item.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ComputerName

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

컴퓨터의 NetBIOS 이름, IP 주소 또는 정규화된 do기본 이름을 입력합니다. 컴퓨터 이름을 으로 파이프할 Enter-PSSession수도 있습니다.

ComputerName 매개 변수 값에 IP 주소를 사용하려면 명령에 자격 증명 매개 변수가 포함되어야 합니다. 또한 HTTPS 전송을 위해 컴퓨터를 구성해야 하거나 원격 컴퓨터의 IP 주소를 로컬 컴퓨터의 WinRM TrustedHosts 목록에 포함해야 합니다. 컴퓨터 이름을 TrustedHosts 목록에 추가하는 방법에 대한 지침은 about_Remote_Troubleshooting의 "신뢰할 수 있는 호스트 목록에 컴퓨터를 추가하는 방법"을 참조하세요.

참고 항목

Windows 운영 체제에서 ComputerName 매개 변수 값에 로컬 컴퓨터를 포함하려면 관리자 권한으로 실행 옵션을 사용하여 PowerShell을 시작해야 합니다.

Type:	String
Aliases:	Cn
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ConfigurationName

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

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

SSH와 함께 사용할 경우 sshd_config 정의된 대로 대상에 사용할 하위 시스템을 지정합니다. SSH의 기본값은 하위 시스템입니다 powershell .

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

기본값은 로컬 컴퓨터의 $PSSessionConfigurationName 기본 설정 변수 값입니다. 이 기본 설정 변수가 설정되지 않은 경우 기본값은 Microsoft.PowerShell입니다. 자세한 내용은 about_Preference_Variables 참조하세요.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ConnectingTimeout

초기 SSH 연결을 완료하는 데 허용되는 시간(밀리초)을 지정합니다. 지정된 시간 내에 연결이 완료되지 않으면 오류가 반환됩니다.

이 매개 변수는 PowerShell 7.2에서 도입되었습니다.

Type:	Int32
Position:	Named
Default value:	unlimited
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConnectionUri

세션의 연결 엔드포인트를 정의하는 URI를 지정합니다. URI는 정규화되어야 합니다. 이 문자열의 형식은 다음과 같습니다.

<Transport>://<ComputerName>:<Port>/<ApplicationName>

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

http://localhost:5985/WSMAN

커넥트ionURI를 지정하지 않으면 UseSSL, ComputerName, Port 및 ApplicationName 매개 변수를 사용하여 커넥트ionURI 값을 지정할 수 있습니다.

URI의 전송 세그먼트에 유효한 값은 HTTP 및 HTTPS입니다. 전송 세그먼트를 사용하여 연결 URI를 지정하지만 포트를 지정하지 않으면 HTTP의 경우 80, HTTPS의 경우 443의 표준 포트를 사용하여 세션이 만들어집니다. PowerShell 원격에 기본 포트를 사용하려면 HTTP용 포트 5985 또는 HTTPS의 경우 5986을 지정합니다.

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

Type:	Uri
Aliases:	URI, CU
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ContainerId

컨테이너의 ID를 지정합니다.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Credential

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

User01 또는 Do기본01\User01과 같은 사용자 이름을 입력하거나 cmdlet에서 생성된 PSCredential 개체를 Get-Credential 입력합니다. 사용자 이름을 입력하면 암호를 입력하라는 메시지가 표시됩니다.

자격 증명은 PSCredential 개체에 저장되고 암호는 SecureString 으로 저장됩니다.

참고 항목

SecureString 데이터 보호에 대한 자세한 내용은 SecureString이 얼마나 안전한가요?를 참조하세요.

Type:	PSCredential
Position:	1
Default value:	Current user
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-EnableNetworkAccess

이 cmdlet은 루프백 세션에 대화형 보안 토큰을 추가한다는 것을 나타냅니다. 대화형 토큰을 사용하면 루프백 세션에서 다른 컴퓨터에서 데이터를 가져오는 명령을 실행할 수 있습니다. 예를 들어 원격 컴퓨터에서 로컬 컴퓨터로 XML 파일을 복사하는 명령을 세션에서 실행할 수 있습니다.

루프백 세션은 동일한 컴퓨터에서 시작되고 끝나는 PSSession 입니다. 루프백 세션을 만들려면 ComputerName 매개 변수를 생략하거나 값을 .로 설정합니다. (점), localhost 또는 로컬 컴퓨터의 이름입니다.

기본적으로 루프백 세션은 원격 컴퓨터에 인증하기에 충분한 권한을 제공하지 않을 수 있는 네트워크 토큰을 사용하여 만들어집니다.

EnableNetworkAccess 매개 변수는 루프백 세션에서만 유효합니다. 원격 컴퓨터에서 세션을 만들 때 EnableNetworkAccess를 사용하면 명령이 성공하지만 매개 변수는 무시됩니다.

세션 자격 증명을 다른 컴퓨터에 위임하는 인증 매개 변수의 CredSSP 값을 사용하여 루프백 세션에서 원격 액세스를 허용할 수도 있습니다.

이 매개 변수는 Windows PowerShell 3.0에서 도입되었습니다.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HostName

SSH(Secure Shell) 기반 연결의 컴퓨터 이름을 지정합니다. 이는 원격 컴퓨터에 대한 연결이 Windows WinRM이 아닌 SSH를 사용하여 수행된다는 점을 제외하고 ComputerName 매개 변수와 유사합니다. 이 매개 변수는 양식을 user@hostname:port사용하여 호스트 이름 매개 변수 값의 일부로 사용자 이름 및/또는 포트를 지정할 수 있습니다. 호스트 이름의 일부로 지정된 사용자 이름 및/또는 포트가 지정된 경우 및 -Port 매개 변수보다 -UserName 우선합니다. 이렇게 하면 특정 사용자 이름 및/또는 포트가 있는 경우 이 매개 변수에 여러 컴퓨터 이름을 전달할 수 있고 다른 컴퓨터 이름은 사용자 이름 및/또는 매개 변수의 포트를 -UserName-Port 사용할 수 있습니다.

이 매개 변수는 PowerShell 6.0에서 도입되었습니다.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Id

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

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

Type:	Int32
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-InstanceId

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

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

Type:	Guid
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-KeyFilePath

SSH(Secure Shell)에서 원격 컴퓨터에서 사용자를 인증하는 데 사용하는 키 파일 경로를 지정합니다.

SSH를 사용하면 기본 암호 인증 대신 프라이빗/퍼블릭 키를 통해 사용자 인증을 수행할 수 있습니다. 원격 컴퓨터가 키 인증을 위해 구성된 경우 이 매개 변수를 사용하여 사용자를 식별하는 키를 제공할 수 있습니다.

이 매개 변수는 PowerShell 6.0에서 도입되었습니다.

Type:	String
Aliases:	IdentityFilePath
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

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

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

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Options

원격 SSH 기반 세션에 연결할 때 사용되는 SSH 옵션의 해시 테이블을 지정합니다. 가능한 옵션은 Unix 기반 버전의 ssh 명령에서 지원하는 모든 값입니다.

매개 변수에 의해 명시적으로 전달된 모든 값이 Options hashtable에 전달된 값보다 우선합니다. 예를 들어 포트 매개 변수를 사용하면 Options hashtable에 전달된 키Port-값 쌍이 재정의됩니다.

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Port

이 명령에 사용되는 원격 컴퓨터의 네트워크 포트를 지정합니다.

PowerShell 6.0에서 이 매개 변수는 SSH(Secure Shell) 연결을 지원하는 HostName 매개 변수 집합에 포함되었습니다.

WinRM(ComputerName 매개 변수 집합)

원격 컴퓨터에 연결하려면 원격 컴퓨터가 연결에서 사용하는 포트에서 수신 대기해야 합니다. 기본 포트는 HTTP용 WinRM 포트인 5985와 HTTPS용 WinRM 포트인 5986입니다.

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

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

반드시 사용해야 하는 경우가 아니면 포트 매개 변수를 사용하지 마세요. 명령의 포트 설정은 명령이 실행되는 모든 컴퓨터 또는 세션에 적용됩니다. 대체 포트 설정을 사용하면 명령이 모든 컴퓨터에서 실행되지 않을 수 있습니다.

SSH(HostName 매개 변수 집합)

원격 컴퓨터에 연결하려면 원격 컴퓨터를 SSHD(SSH 서비스)로 구성해야 하며 연결에서 사용하는 포트에서 수신 대기해야 합니다. SSH의 기본 포트는 22입니다.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RunAsAdministrator

PSSession이 관리자 권한으로 실행됨을 나타냅니다.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Session

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

세션 개체 또는 명령과 같은 세션 개체를 만들거나 가져오는 명령이 포함된 변수를 New-PSSessionGet-PSSession 입력합니다. 세션 개체를 .에 파이프할 Enter-PSSession수도 있습니다. 이 매개 변수를 사용하여 하나의 PSSession 만 제출할 수 있습니다. 둘 이상의 PSSession을 포함하는 변수를 입력하면 명령이 실패합니다.

사용 Exit-PSSession 하거나 EXIT 키워드(keyword) 경우 대화형 세션이 종료되지만 다시 만든 PSSession은 열려 있고 사용할 수 기본.

Type:	PSSession
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-SessionOption

세션에 대한 고급 옵션을 설정합니다. cmdlet을 사용하여 New-PSSessionOption 만든 개체와 같은 SessionOption 개체 또는 키가 세션 옵션 이름이고 값이 세션 옵션 값인 해시 테이블을 입력합니다.

옵션의 기본값은 설정된 경우 기본 설정 변수의 $PSSessionOption 값에 따라 결정됩니다. 그렇지 않으면 기본값은 세션 구성에 설정된 옵션에 의해 설정됩니다.

세션 옵션 값은 기본 설정 변수 및 세션 구성에서 설정된 세션의 $PSSessionOption 기본값보다 우선합니다. 그러나 세션 구성에 설정된 최대 값, 할당량 또는 제한보다 우선하지 않습니다.

기본값을 포함하여 세션 옵션에 대한 설명은 다음을 참조하세요 New-PSSessionOption. 기본 설정 변수에 $PSSessionOption 대한 자세한 내용은 about_Preference_Variables 참조하세요. 세션 구성에 대한 자세한 내용은 about_Session_Configurations를 참조하세요.

Type:	PSSessionOption
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SSHTransport

SSH(Secure Shell)를 사용하여 원격 연결이 설정되었음을 나타냅니다.

기본적으로 PowerShell은 Windows WinRM을 사용하여 원격 컴퓨터에 연결합니다. 이 스위치는 PowerShell이 SSH 기반 원격 연결을 설정하기 위해 HostName 매개 변수 집합을 사용하도록 강제합니다.

이 매개 변수는 PowerShell 6.0에서 도입되었습니다.

Type:	SwitchParameter
Accepted values:	true
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Subsystem

새 PSSession에 사용되는 SSH 하위 시스템을 지정합니다.

sshd_config 정의된 대로 대상에 사용할 하위 시스템을 지정합니다. 하위 시스템은 미리 정의된 매개 변수를 사용하여 특정 버전의 PowerShell을 시작합니다. 지정된 하위 시스템이 원격 컴퓨터에 없으면 명령이 실패합니다.

이 매개 변수를 사용하지 않으면 기본값은 'powershell' 하위 시스템입니다.

Type:	String
Position:	Named
Default value:	Powershell
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-UserName

원격 컴퓨터에서 세션을 만드는 데 사용되는 계정의 사용자 이름을 지정합니다. 사용자 인증 방법은 원격 컴퓨터에서 SSH(Secure Shell)를 구성하는 방법에 따라 달라집니다.

기본 암호 인증을 위해 SSH가 구성된 경우 사용자 암호를 묻는 메시지가 표시됩니다.

키 기반 사용자 인증을 위해 SSH가 구성된 경우 KeyFilePath 매개 변수를 통해 키 파일 경로를 제공할 수 있으며 암호 프롬프트가 발생하지 않습니다. 클라이언트 사용자 키 파일이 SSH 알려진 위치에 있는 경우 키 기반 인증에 KeyFilePath 매개 변수가 필요하지 않으며 사용자 이름에 따라 사용자 인증이 자동으로 수행됩니다. 자세한 내용은 키 기반 사용자 인증에 대한 SSH 설명서를 참조하세요.

필수 매개 변수가 아닙니다. UserName 매개 변수가 지정되지 않은 경우 현재 로그온 사용자 이름이 연결에 사용됩니다.

이 매개 변수는 PowerShell 6.0에서 도입되었습니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UseSSL

이 cmdlet은 SSL(Secure Sockets Layer) 프로토콜을 사용하여 원격 컴퓨터에 대한 연결을 설정합니다. 기본적으로 SSL은 사용되지 않습니다.

WS-Management는 네트워크를 통해 전송되는 모든 PowerShell 콘텐츠를 암호화합니다. UseSSL 매개 변수는 HTTP 연결 대신 HTTPS 연결을 통해 데이터를 보내는 추가 보호입니다.

이 매개 변수를 사용하지만 명령에 사용되는 포트에서 SSL을 사용할 수 없는 경우 명령이 실패합니다.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VMId

가상 머신의 ID를 지정합니다.

Type:	Guid
Aliases:	VMGuid
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-VMName

가상 머신의 이름을 지정합니다.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

입력

String

컴퓨터 이름을 문자열로 이 cmdlet에 파이프할 수 있습니다.

PSSession

세션 개체를 이 cmdlet으로 파이프할 수 있습니다.

출력

None

이 cmdlet은 출력을 반환하지 않습니다.

참고

PowerShell에는 다음 별칭이 포함됩니다.Enter-PSSession

모든 플랫폼:
- etsn

원격 컴퓨터에 연결하려면 원격 컴퓨터에서 관리istrators 그룹의 구성원이어야 합니다. 로컬 컴퓨터에서 대화형 세션을 시작하려면 관리자 권한으로 실행 옵션을 사용하여 PowerShell을 시작해야 합니다.

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

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

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

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

입력하려는 세션이 명령을 처리하는 데 사용 중인 경우 PowerShell이 명령에 응답 Enter-PSSession 하기 전에 지연이 있을 수 있습니다. 세션을 사용할 수 있는 즉시 연결됩니다. 명령을 취소 Enter-PSSession 하려면 Ctrl+C를 누릅니다.

HostName 매개 변수 집합은 PowerShell 6.0부터 포함되었습니다. SSH(Secure Shell)를 기반으로 PowerShell 원격을 제공하기 위해 추가되었습니다. SSH와 PowerShell은 모두 여러 플랫폼(Windows, Linux, macOS)에서 지원되며 PowerShell 및 SSH가 설치되고 구성된 이러한 플랫폼에서 PowerShell 원격 작업이 작동합니다. 이는 WinRM을 기반으로 하는 이전 Windows 전용 원격 기능과는 별개이며 WinRM 관련 기능과 제한 사항은 대부분 적용되지 않습니다. 예를 들어 WinRM 기반 할당량, 세션 옵션, 사용자 지정 엔드포인트 구성 및 연결 끊기/다시 연결 기능은 현재 지원되지 않습니다. PowerShell SSH 원격을 설정하는 방법에 대한 자세한 내용은 SSH를 통해 PowerShell 원격을 참조하세요.

PowerShell 7.1 이전에는 SSH를 통해 원격으로 이동하여 두 번째 홉 원격 세션을 지원하지 않았습니다. 해당 기능은 WinRM을 사용하는 세션으로 제한되었습니다. PowerShell 7.1을 Enter-PSSession 사용하면 대화형 원격 세션 내에서 작업할 수 있습니다 Enter-PSHostProcess .

실행 파일은 ssh 다음 순서대로 다음 원본에서 구성 데이터를 가져옵니다.

명령줄 옵션
사용자의 구성 파일(~/.ssh/config)
시스템 전체 구성 파일(/etc/ssh/ssh_config)

다음 cmdlet 매개 변수는 매개 변수 및 옵션에 ssh 매핑됩니다.

Cmdlet 매개 변수	ssh 매개 변수	동등한 ssh -o 옵션
`-KeyFilePath`	`-i <KeyFilePath>`	`-o IdentityFile=<KeyFilePath>`
`-UserName`	`-l <UserName>`	`-o User=<UserName>`
`-Port`	`-p <Port>`	`-o Port=<Port>`
`-ComputerName -Subsystem`	`-s <ComputerName> <Subsystem>`	`-o Host=<ComputerName>`

매개 변수에 의해 명시적으로 전달된 모든 값이 Options hashtable에 전달된 값보다 우선합니다. 파일에 대한 ssh_config 자세한 내용은 ssh_config(5)를 참조하세요.

Enter-PSSession

Syntax

Description

예제

예제 1: 대화형 세션 시작

예제 2: 대화형 세션 작업

예제 3: 세션 매개 변수 사용

예제 4: 대화형 세션을 시작하고 포트 및 자격 증명 매개 변수 지정

예제 5: 대화형 세션 중지

예제 6: SSH를 사용하여 대화형 세션 시작

예제 7: 포트 및 사용자 인증 키와 함께 SSH를 사용하여 대화형 세션 시작

예제 8: SSH 옵션을 사용하여 대화형 세션 시작

매개 변수

-AllowRedirection

-ApplicationName

-Authentication

-CertificateThumbprint

-ComputerName

-ConfigurationName

-ConnectingTimeout

-ConnectionUri

-ContainerId

-Credential

-EnableNetworkAccess

-HostName

-Id

-InstanceId

-KeyFilePath

-Name

-Options

-Port

-RunAsAdministrator

-Session

-SessionOption

-SSHTransport

-Subsystem

-UserName

-UseSSL

-VMId

-VMName

입력

출력

참고

관련 링크

피드백

추가 리소스