Get-PSSession

참조

모듈:: Microsoft.PowerShell.Core

로컬 및 원격 컴퓨터에서 PowerShell 세션을 가져옵니다.

구문

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

Get-PSSession
   [-ComputerName] <String[]>
   [-ApplicationName <String>]
   [-ConfigurationName <String>]
   [-Name <String[]>]
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [-Port <Int32>]
   [-UseSSL]
   [-ThrottleLimit <Int32>]
   [-State <SessionFilterState>]
   [-SessionOption <PSSessionOption>]
   [<CommonParameters>]

Get-PSSession
   [-ComputerName] <String[]>
   [-ApplicationName <String>]
   [-ConfigurationName <String>]
   -InstanceId <Guid[]>
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [-Port <Int32>]
   [-UseSSL]
   [-ThrottleLimit <Int32>]
   [-State <SessionFilterState>]
   [-SessionOption <PSSessionOption>]
   [<CommonParameters>]

Get-PSSession
   [-ConnectionUri] <Uri[]>
   [-ConfigurationName <String>]
   [-AllowRedirection]
   -InstanceId <Guid[]>
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [-ThrottleLimit <Int32>]
   [-State <SessionFilterState>]
   [-SessionOption <PSSessionOption>]
   [<CommonParameters>]

Get-PSSession
   [-ConnectionUri] <Uri[]>
   [-ConfigurationName <String>]
   [-AllowRedirection]
   [-Name <String[]>]
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [-ThrottleLimit <Int32>]
   [-State <SessionFilterState>]
   [-SessionOption <PSSessionOption>]
   [<CommonParameters>]

Get-PSSession
   [-ConfigurationName <String>]
   [-Name <String[]>]
   [-State <SessionFilterState>]
   -ContainerId <String[]>
   [<CommonParameters>]

Get-PSSession
   [-ConfigurationName <String>]
   -InstanceId <Guid[]>
   [-State <SessionFilterState>]
   -ContainerId <String[]>
   [<CommonParameters>]

Get-PSSession
   [-ConfigurationName <String>]
   [-Name <String[]>]
   [-State <SessionFilterState>]
   -VMId <Guid[]>
   [<CommonParameters>]

Get-PSSession
   [-ConfigurationName <String>]
   -InstanceId <Guid[]>
   [-State <SessionFilterState>]
   -VMId <Guid[]>
   [<CommonParameters>]

Get-PSSession
   [-ConfigurationName <String>]
   [-Name <String[]>]
   [-State <SessionFilterState>]
   -VMName <String[]>
   [<CommonParameters>]

Get-PSSession
   [-ConfigurationName <String>]
   -InstanceId <Guid[]>
   [-State <SessionFilterState>]
   -VMName <String[]>
   [<CommonParameters>]

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

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

Description

cmdlet은 Get-PSSession 로컬 및 원격 컴퓨터에서 사용자 관리 PowerShell 세션(PSSessions)을 가져옵니다.

Windows PowerShell 3.0부터 세션은 각 연결의 원격 끝에 있는 컴퓨터에 저장됩니다. ComputerName 또는 ConnectionUri 매개 변수 Get-PSSession 를 사용하여 현재 세션에서 만들어지지 않은 경우에도 로컬 컴퓨터 또는 원격 컴퓨터에 연결하는 세션을 가져올 수 있습니다.

매개 변수가 Get-PSSession 없으면 현재 세션에서 만든 모든 세션을 가져옵니다.

이름, ID, InstanceID, State, ApplicationName 및 ConfigurationName을 비롯한 필터링 매개 변수를 사용하여 반환되는 Get-PSSession 세션 중에서 선택합니다.

나머지 매개 변수를 사용하여 ComputerName 또는 ConnectionUri 매개 변수를 Get-PSSession 사용할 때 명령이 실행되는 임시 연결을 구성 합니다.

참고 항목

Windows PowerShell 2.0에서는 매개 변수 Get-PSSession 없이 현재 세션에서 만든 모든 세션을 가져옵니다. ComputerName 매개 변수는 현재 세션에서 만든 세션을 가져오고 지정된 컴퓨터에 연결합니다.

PowerShell 세션에 대한 자세한 내용은 about_PSSessions 참조하세요.

예제

예제 1: 현재 세션에서 만든 세션 가져오기

Get-PSSession

이 명령은 현재 세션에서 만든 모든 PSSessions 를 가져옵니다. 다른 세션이나 다른 컴퓨터에서 만든 PSSessions는 이 컴퓨터에 연결하더라도 가져올 수 없습니다.

예제 2: 로컬 컴퓨터에 연결된 세션 가져오기

Get-PSSession -ComputerName "localhost"

이 명령은 로컬 컴퓨터에 연결된 PSSessions를 가져옵니다. 로컬 컴퓨터를 나타내려면 컴퓨터 이름, localhost 또는 점(.)을 입력합니다.

이 명령은 다른 세션 또는 다른 컴퓨터에서 생성된 경우에도 로컬 컴퓨터의 모든 세션을 반환합니다.

예제 3: 컴퓨터에 연결된 세션 가져오기

Get-PSSession -ComputerName "Server02"

Id Name            ComputerName    State         ConfigurationName     Availability
 -- ----            ------------    -----         -----------------     ------------
  2 Session3        Server02       Disconnected  ITTasks                       Busy
  1 ScheduledJobs   Server02       Opened        Microsoft.PowerShell     Available
  3 Test            Server02       Disconnected  Microsoft.PowerShell          Busy

이 명령은 Server02 컴퓨터에 연결된 PSSessions를 가져옵니다.

이 명령은 다른 세션 또는 다른 컴퓨터에서 생성된 경우에도 Server02의 모든 세션을 반환합니다.

출력은 두 세션 Disconnected 에 상태와 가용성이 Busy 있음을 보여 줍니다. 서로 다른 세션에서 만들어졌으며 현재 사용 중입니다. ScheduledJobs 현재 세션에서 만들어진 세션입니다 Opened Available.

예제 4: 이 명령의 결과 저장

New-PSSession -ComputerName Server01, Server02, Server03
$s1, $s2, $s3 = Get-PSSession

이 예제에서는 명령의 Get-PSSession 결과를 여러 변수에 저장하는 방법을 보여 줍니다.

첫 번째 명령은 cmdlet을 New-PSSession 사용하여 세 개의 원격 컴퓨터에서 PSSessions를 만듭니다.

두 번째 명령은 cmdlet을 Get-PSSession 사용하여 세 가지 PSSessions를 가져옵니다. 그런 다음 각 PSSessions 를 별도의 변수에 저장합니다.

PowerShell이 변수 배열에 개체 배열을 할당하면 첫 번째 개체를 첫 번째 변수에 할당하고 두 번째 개체를 두 번째 변수에 할당합니다. 개체가 변수보다 많을 경우 배열의 마지막 변수에 남은 개체를 모두 할당합니다. 개체보다 더 많은 변수가 있는 경우 추가 변수는 사용되지 않습니다.

예제 5: 인스턴스 ID를 사용하여 세션 삭제

Get-PSSession | Format-Table -Property ComputerName, InstanceID
$s = Get-PSSession -InstanceID a786be29-a6bb-40da-80fb-782c67f7db0f
Remove-PSSession -Session $s

이 예제에서는 인스턴스 ID를 사용하여 PSSession을 가져오고 PSSession을 삭제하는 방법을 보여 줍니다.

첫 번째 명령은 현재 세션에서 만든 모든 PSSessions 를 가져옵니다. 각 PSSession의 ComputerName 및 InstanceID 속성을 표시하는 cmdlet에 PSSessionsFormat-Table를 보냅니다.

두 번째 명령은 cmdlet을 Get-PSSession 사용하여 특정 PSSession 을 가져와 변수에 $s 저장합니다. 이 명령은 InstanceID 매개 변수를 사용하여 PSSession을 식별합니다.

세 번째 명령은 Remove-PSSession cmdlet을 사용하여 변수에서 PSSession 을 $s 삭제합니다.

예제 6: 특정 이름을 가진 세션 가져오기

이 예제의 명령은 특정 이름 형식으로 되어 있으며 특정 세션 구성을 사용하는 세션을 찾아 연결합니다. 이와 같은 명령을 사용하여 동료가 작업을 시작한 세션을 찾고 연결하여 작업을 완료할 수 있습니다.

Get-PSSession -ComputerName Server02, Server12 -Name BackupJob* -ConfigurationName ITTasks -SessionOption @{OperationTimeout=240000}

Id Name            ComputerName    State         ConfigurationName     Availability
 -- ----            ------------    -----         -----------------     ------------
  3 BackupJob04     Server02        Disconnected        ITTasks                  None

$s = Get-PSSession -ComputerName Server02 -Name BackupJob04 -ConfigurationName ITTasks | Connect-PSSession
$s

Id Name            ComputerName    State         ConfigurationName     Availability
-- ----            ------------    -----         -----------------     ------------
 5 BackupJob04     Server02        Opened        ITTasks                  Available

첫 번째 명령은 세션 구성으로 시작하고 BackupJob 사용하는 이름이 있는 Server02 및 Server12 원격 컴퓨터에서 ITTasks 세션을 가져옵니다. 이 명령은 Name 매개 변수를 사용하여 이름 패턴을 지정하고 ConfigurationName 매개 변수를 사용하여 세션 구성을 지정합니다. SessionOption 매개 변수의 값은 OperationTimeout 240000 의 값을 밀리초(4분)로 설정하는 해시 테이블입니다. 이 설정은 명령을 완료하는 데 더 많은 시간을 제공합니다. ConfigurationName 및 SessionOption 매개 변수는 cmdlet이 각 컴퓨터에서 Get-PSSession 실행되는 임시 세션을 구성하는 데 사용됩니다. 출력은 명령이 세션을 반환한다는 것을 BackupJob04 보여줍니다. 세션의 연결이 끊어지고 가용성 이 None사용 중이 아님을 나타냅니다.

두 번째 명령은 cmdlet을 Get-PSSession 사용하여 세션에 BackupJob04 연결하고 Connect-PSSession cmdlet을 사용하여 세션에 연결합니다. 이 명령은 세션을 $s 변수에 저장합니다.

세 번째 명령은 변수의 세션을 $s 가져옵니다. 출력은 명령이 성공했음을 Connect-PSSession 보여줍니다. 세션이 열린 상태이며 사용할 수 있습니다.

예제 7: ID를 사용하여 세션 가져오기

Get-PSSession -Id 2

이 명령은 ID2가 있는 PSSession을 가져옵니다. ID 속성의 값은 현재 세션에서만 고유하므로 Id 매개 변수는 로컬 명령에만 유효합니다.

매개 변수

-AllowRedirection

이 cmdlet은 이 연결을 대체 URI(Uniform Resource Identifier)로 리디렉션할 수 있음을 나타냅니다. 기본적으로 PowerShell은 연결을 리디렉션하지 않습니다.

이 매개 변수는 ConnectionUri 매개 변수를 사용하여 명령을 실행 Get-PSSession 하도록 만들어진 임시 연결을 구성합니다.

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

형식:	SwitchParameter
Position:	Named
Default value:	False
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ApplicationName

애플리케이션의 이름을 지정합니다. 이 cmdlet은 지정된 애플리케이션을 사용하는 세션에만 연결됩니다.

연결 URI의 애플리케이션 이름 세그먼트를 입력합니다. 예를 들어 다음 연결 URI에서 애플리케이션 이름은 WSMan http://localhost:5985/WSMAN입니다. 세션의 애플리케이션 이름은 세션의 Runspace.ConnectionInfo.AppName 속성에 저장됩니다.

이 매개 변수의 값은 세션을 선택하고 필터링하는 데 사용됩니다. 세션에서 사용하는 애플리케이션을 변경하지 않습니다.

형식:	String
Position:	Named
Default value:	All sessions
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-Authentication

명령이 실행되는 세션에 대한 자격 증명을 인증하는 데 사용되는 메커니즘을 Get-PSSession 지정합니다.

이 매개 변수는 ComputerName 또는 ConnectionUri 매개 변수를 Get-PSSession 사용하여 명령을 실행하기 위해 만들어진 임시 연결을 구성 합니다.

이 매개 변수에 허용되는 값은 다음과 같습니다.

Default
Basic
CredSSP
Digest
Kerberos
Negotiate
NegotiateWithImplicitCredential.

기본값은 Default입니다.

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

주의

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

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

형식:	AuthenticationMechanism
허용되는 값:	Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos
Position:	Named
Default value:	Default
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-CertificateThumbprint

명령이 실행되는 세션을 Get-PSSession 만들 수 있는 권한이 있는 사용자 계정의 디지털 공개 키 인증서(X509)를 지정합니다. 인증서의 인증서 지문을 입력합니다.

이 매개 변수는 ComputerName 또는 ConnectionUri 매개 변수를 Get-PSSession 사용하여 명령을 실행하기 위해 만들어진 임시 연결을 구성 합니다.

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

인증서 지문을 가져오려면 PowerShell Cert: 드라이브에서 또는 Get-Item Get-ChildItem 명령을 사용합니다.

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

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ComputerName

컴퓨터 이름의 배열을 지정합니다. 지정된 컴퓨터에 연결하는 세션을 가져옵니다. 와일드카드 문자는 허용되지 않습니다. 기본값이 없습니다.

Windows PowerShell 3.0 부터 PSSession 개체는 각 연결의 원격 끝에 있는 컴퓨터에 저장됩니다. 지정된 컴퓨터에서 세션을 가져오기 위해 PowerShell은 각 컴퓨터에 대한 임시 연결을 만들고 명령을 실행합니다 Get-PSSession .

하나 이상의 컴퓨터의 NetBIOS 이름, IP 주소 또는 정규화된 도메인 이름을 입력합니다. 로컬 컴퓨터를 지정하려면 컴퓨터 이름 localhost또는 점(.)을 입력합니다.

참고 항목

이 매개 변수는 Windows PowerShell 3.0 이상 버전의 PowerShell을 실행하는 컴퓨터에서만 세션을 가져옵니다. 이전 버전은 세션을 저장하지 않습니다.

형식:	String[]
별칭:	Cn
Position:	0
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-ConfigurationName

구성의 이름을 지정합니다. 이 cmdlet은 지정된 세션 구성을 사용하는 세션에만 가져옵니다.

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

이 매개 변수의 값은 세션을 선택하고 필터링하는 데 사용됩니다. 세션이 사용하는 세션 구성은 변경되지 않습니다.

세션 구성에 대한 자세한 내용은 about_Session_Configurations를 참조하세요.

형식:	String
Position:	Named
Default value:	All sessions
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-ConnectionUri

명령이 실행되는 임시 세션에 대한 연결 엔드포인트를 정의하는 URI를 Get-PSSession 지정합니다. URI는 정규화되어야 합니다.

이 매개 변수는 ConnectionUri 매개 변수를 사용하여 명령을 실행 Get-PSSession 하도록 만들어진 임시 연결을 구성합니다.

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

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

기본값은 http://localhost:5985/WSMAN입니다.

ConnectionUri를 지정하지 않으면 UseSSL, ComputerName, Port 및 ApplicationName 매개 변수를 사용하여 ConnectionURI 값을 지정할 수 있습니다. URI의 전송 세그먼트에 유효한 값은 HTTP 및 HTTPS입니다. 전송 세그먼트를 사용하여 연결 URI를 지정하지만 포트를 지정하지 않으면 HTTP 및 443 HTTPS에 대한 표준 포트 80 를 사용하여 세션이 만들어집니다. PowerShell 원격에 기본 포트를 사용하려면 HTTP 또는 5986 HTTPS에 대한 포트 5985 를 지정합니다.

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

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

이 매개 변수는 Windows PowerShell 3.0 이상 버전의 Windows PowerShell을 실행하는 컴퓨터에서만 세션을 가져옵니다. 이전 버전은 세션을 저장하지 않습니다.

형식:	Uri[]
별칭:	URI, CU
Position:	0
Default value:	Http://localhost:5985/WSMAN
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-ContainerId

컨테이너 ID의 배열을 지정합니다. 이 cmdlet은 지정된 각 컨테이너를 사용하여 대화형 세션을 시작합니다. 명령을 docker ps 사용하여 컨테이너 ID 목록을 가져옵니다. 자세한 내용은 docker ps 명령에 대한 도움말을 참조하세요.

형식:	String[]
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-Credential

사용자 자격 증명을 지정합니다. 이 cmdlet은 지정된 사용자의 권한으로 명령을 실행합니다. 원격 컴퓨터에 연결하고 명령을 실행할 수 있는 권한이 있는 사용자 계정을 지정합니다 Get-PSSession . 기본값은 현재 사용자입니다.

사용자 이름(예: User01 또는)을 입력하거나 Domain01\User01cmdlet에서 생성된 PSCredential 개체를 Get-Credential 입력합니다. 사용자 이름을 입력하면 암호를 입력하라는 메시지가 표시됩니다.

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

참고 항목

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

이 매개 변수는 ComputerName 또는 ConnectionUri 매개 변수를 사용하여 명령을 실행 Get-PSSession 하기 위해 만들어진 임시 연결로 구성 됩니다.

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

형식:	PSCredential
Position:	Named
Default value:	Current user
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Id

세션 ID의 배열을 지정합니다. 이 cmdlet은 지정된 ID가 있는 세션만 가져옵니다. 하나 이상의 ID를 쉼표로 구분하여 입력하거나 범위 연산자(..)를 사용하여 ID 범위를 지정합니다. ComputerName 매개 변수와 함께 ID 매개 변수를 사용할 수 없습니다.

ID는 현재 세션의 사용자 관리 세션을 고유하게 식별하는 정수입니다. InstanceId보다 기억하고 입력하는 것이 더 쉽지만 현재 세션 내에서만 고유합니다. 세션의 ID는 세션의 ID 속성에 저장됩니다.

형식:	Int32[]
Position:	0
Default value:	All sessions
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-InstanceId

세션의 인스턴스 ID 배열을 지정합니다. 이 cmdlet은 지정된 인스턴스 ID가 있는 세션만 가져옵니다.

인스턴스 ID는 로컬 또는 원격 컴퓨터에서 세션을 고유하게 식별하는 GUID입니다. InstanceID는 PowerShell에서 여러 세션이 실행되는 경우에도 고유합니다.

세션의 인스턴스 ID는 세션의 InstanceID 속성에 저장됩니다.

형식:	Guid[]
Position:	Named
Default value:	All sessions
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Name

세션 이름의 배열을 지정합니다. 이 cmdlet은 지정된 이름을 가진 세션만 가져옵니다. 와일드카드 문자를 사용할 수 있습니다.

세션의 친숙한 이름은 세션의 Name 속성에 저장됩니다.

형식:	String[]
Position:	Named
Default value:	All sessions
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	True

-Port

명령이 실행되는 임시 연결에 사용되는 지정된 네트워크 포트를 Get-PSSession 지정합니다. 원격 컴퓨터에 연결하려면 원격 컴퓨터가 연결에서 사용하는 포트에서 수신 대기해야 합니다. 기본 포트는 5985HTTP용 WinRM 포트이고 5986HTTPS용 WinRM 포트입니다.

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

Remove-Item -Path WSMan:\Localhost\listener\listener* -Recurse

New-Item -Path WSMan:\Localhost\listener -Transport http -Address * -Port \<port-number\>

이 매개 변수는 ComputerName 또는 ConnectionUri 매개 변수를 사용하여 명령을 실행 Get-PSSession 하기 위해 만들어진 임시 연결로 구성 됩니다.

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

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

형식:	Int32
Position:	Named
Default value:	5985, 5986
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-SessionOption

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

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

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

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

형식:	PSSessionOption
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-State

세션 상태를 지정합니다. 이 cmdlet은 지정된 상태의 세션만 가져옵니다. 이 매개 변수에 허용되는 값은 다음과 BrokenClosedDisconnectedOpened같습니다. All 기본값은 All입니다.

세션 상태 값은 현재 세션을 기준으로 합니다. 현재 세션에서 만들어지지 않았고 현재 세션에 연결되지 않은 세션은 다른 세션에 연결된 경우에도 상태가 Disconnected 됩니다.

세션의 상태는 세션의 상태 속성에 저장됩니다.

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

형식:	SessionFilterState
허용되는 값:	All, Opened, Disconnected, Closed, Broken
Position:	Named
Default value:	All
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ThrottleLimit

명령을 실행 Get-PSSession 하기 위해 설정할 수 있는 최대 동시 연결 수를 지정합니다. 이 매개 변수를 생략하거나 값 0 (0)을 입력하면 기본값이 32사용됩니다. 제한 제한은 세션이나 컴퓨터가 아닌 현재 명령에만 적용됩니다.

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

형식:	Int32
Position:	Named
Default value:	32
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-UseSSL

이 cmdlet은 SSL(Secure Sockets Layer) 프로토콜을 사용하여 명령이 실행되는 연결을 설정했음을 Get-PSSession 나타냅니다. 기본적으로 SSL은 사용되지 않습니다. 이 매개 변수를 사용하지만 명령에 사용되는 포트에서 SSL을 사용할 수 없는 경우 명령이 실패합니다.

이 매개 변수는 ComputerName 매개 변수를 사용하여 명령을 실행 Get-PSSession 하도록 만들어진 임시 연결을 구성합니다.

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

형식:	SwitchParameter
Position:	Named
Default value:	False
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-VMId

가상 머신의 ID 배열을 지정합니다. 이 cmdlet은 지정된 각 가상 머신과 대화형 세션을 시작합니다. 사용할 수 있는 가상 머신을 보려면 다음 명령을 사용합니다.

Get-VM | Select-Object -Property Name, ID

형식:	Guid[]
별칭:	VMGuid
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-VMName

가상 머신의 이름 배열을 지정합니다. 이 cmdlet은 지정된 각 가상 머신과 대화형 세션을 시작합니다. 사용할 수 있는 가상 머신을 보려면 cmdlet을 Get-VM 사용합니다.

형식:	String[]
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

입력

None

개체를 이 cmdlet으로 파이프할 수 없습니다.

출력

PSSession

참고

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

gsn
이 cmdlet은 사용자 관리 세션 PSSession 개체를 가져옵니다. 예를 들어 , Enter-PSSession및 Invoke-Command cmdlet을 사용하여 New-PSSession만든 개체입니다. PowerShell을 시작할 때 생성되는 시스템 관리 세션을 얻지 못합니다.
Windows PowerShell 3.0 부터 PSSession 개체는 서버 쪽에 있거나 연결의 끝을 수신하는 컴퓨터에 저장됩니다. 로컬 컴퓨터 또는 원격 컴퓨터에 저장된 세션을 가져오기 위해 PowerShell은 지정된 컴퓨터에 대한 임시 세션을 설정하고 세션에서 쿼리 명령을 실행합니다.
원격 컴퓨터에 연결하는 세션을 얻으려면 ComputerName 또는 ConnectionUri 매개 변수를 사용하여 원격 컴퓨터를 지정합니다. 가져오는 세션을 Get-PSSession 필터링하려면 이름, ID, InstanceID 및 상태 매개 변수를 사용합니다. 나머지 매개 변수를 사용하여 사용하는 임시 세션을 Get-PSSession 구성합니다.
ComputerName 또는 ConnectionUri 매개 변수 Get-PSSession 를 사용하는 경우 Windows PowerShell 3.0 이상 버전의 PowerShell을 실행하는 컴퓨터에서 세션만 가져옵니다.
PSSession의 State 속성 값은 현재 세션을 기준으로 합니다. 따라서 연결 끊김 값은 PSSession이 현재 세션에 연결되지 않음을 의미합니다. 그러나 PSSession이 모든 세션에서 연결이 끊어지는 것은 아닙니다. 다른 세션에 연결되어 있을 수도 있습니다. 현재 세션에서 PSSession에 연결하거나 다시 연결할 수 있는지 여부를 확인하려면 가용성 속성을 사용합니다.

None의 가용성 값은 세션에 연결할 수 있음을 나타냅니다. 사용 중 값은 PSSession이 다른 세션에 연결되어 있으므로 연결할 수 없음을 나타냅니다.

세션의 State 속성 값에 대한 자세한 내용은 RunspaceState 열거형을 참조하세요.

세션의 가용성 속성 값에 대한 자세한 내용은 RunspaceAvailability 열거형을 참조 하세요.

다음을 통해 공유

Get-PSSession

구문

Description

예제

예제 1: 현재 세션에서 만든 세션 가져오기

예제 2: 로컬 컴퓨터에 연결된 세션 가져오기

예제 3: 컴퓨터에 연결된 세션 가져오기

예제 4: 이 명령의 결과 저장

예제 5: 인스턴스 ID를 사용하여 세션 삭제

예제 6: 특정 이름을 가진 세션 가져오기

예제 7: ID를 사용하여 세션 가져오기

매개 변수

-AllowRedirection

-ApplicationName

-Authentication

-CertificateThumbprint

-ComputerName

-ConfigurationName

-ConnectionUri

-ContainerId

-Credential

-Id

-InstanceId

-Name

-Port

-SessionOption

-State

-ThrottleLimit

-UseSSL

-VMId

-VMName

입력

출력

참고

추가 리소스

다음을 통해 공유

Get-PSSession

구문

Description

예제

예제 1: 현재 세션에서 만든 세션 가져오기

예제 2: 로컬 컴퓨터에 연결된 세션 가져오기

예제 3: 컴퓨터에 연결된 세션 가져오기

예제 4: 이 명령의 결과 저장

예제 5: 인스턴스 ID를 사용하여 세션 삭제

예제 6: 특정 이름을 가진 세션 가져오기

예제 7: ID를 사용하여 세션 가져오기

매개 변수

-AllowRedirection

-ApplicationName

-Authentication

-CertificateThumbprint

-ComputerName

-ConfigurationName

-ConnectionUri

-ContainerId

-Credential

-Id

-InstanceId

-Name

-Port

-SessionOption

-State

-ThrottleLimit

-UseSSL

-VMId

-VMName

입력

출력

참고

관련 링크

추가 리소스