Get-PSSession

모듈:

Microsoft.PowerShell.Core

로컬 및 원격 컴퓨터에서 Windows 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]
   [-Name <String[]>]
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [-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
   [-InstanceId <Guid[]>]
   [<CommonParameters>]

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

Description

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

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

매개 변수가 없으면 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의 모든 세션을 반환합니다.

출력은 두 세션의 연결이 끊어진 상태와 사용 중인 가용성을 보여 줍니다. 서로 다른 세션에서 만들어졌으며 현재 사용 중입니다. 현재 세션에서 열리고 사용 가능한 ScheduledJobs 세션이 만들어졌습니다.

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

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

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

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

두 번째 명령은 Get-PSSession cmdlet을 사용하여 세 가지 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 모두 가져옵니다. PSSessions Format-Table cmdlet으로 전송합니다. 이 cmdlet은 각 PSSessionComputerName 및 InstanceID 속성을 표시합니다.

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

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

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

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

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

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

Get-PSSession -Id 2

이 명령은 ID가 2인 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: https://localhost:5985/WSMAN. 세션의 애플리케이션 이름은 세션의 Runspace.ConnectionInfo.AppName 속성에 저장됩니다.

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

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

-Authentication

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

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

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

• 기본값
• 기초의
• Credssp
• 소화하다
• Kerberos
• 교섭하다
• NegotiateWithImplicitCredential.

기본값은 Default입니다.

이 매개 변수의 값에 대한 자세한 내용은 MSDN 라이브러리의 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 인증서: 드라이브에서 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 앞에 https://schemas.microsoft.com/powershell. 세션의 구성 이름은 세션의 ConfigurationName 속성에 저장됩니다.

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

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

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

-ConnectionUri

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

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

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

<전송>://<ComputerName>:<포트>/<ApplicationName>

기본값은 https://localhost:5985/WSMAN.

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

대상 컴퓨터가 연결을 다른 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

-Credential

사용자 자격 증명을 지정합니다. 이 cmdlet은 지정된 사용자의 권한으로 명령을 실행합니다. 원격 컴퓨터에 연결하고 Get-PSSession 명령을 실행할 수 있는 권한이 있는 사용자 계정을 지정합니다. 기본값은 현재 사용자입니다. User01, Domain01\User01또는 User@Domain.com같은 사용자 이름을 입력하거나 Get-Credential cmdlet에서 반환된 개체와 같은 PSCredential 개체를 입력합니다. 사용자 이름을 입력하면 이 cmdlet에서 암호를 묻는 메시지를 표시합니다.

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

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

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

-Id

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

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

대체 포트를 사용하기 전에 원격 컴퓨터에서 해당 포트에서 수신 대기하도록 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

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

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

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

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

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

-State

세션 상태를 지정합니다. 이 cmdlet은 지정된 상태의 세션만 가져옵니다. 이 매개 변수에 허용되는 값은 All, Opened, Disconnected, Closed 및 Broken입니다. 기본값은 All입니다.

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

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

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

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

-ThrottleLimit

Get-PSSession 명령을 실행하기 위해 설정할 수 있는 최대 동시 연결 수를 지정합니다. 이 매개 변수를 생략하거나 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

입력

None

이 cmdlet에 입력을 파이프할 수 없습니다.

출력

PSSession

참고

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

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

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

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

관련 링크

• Connect-PSSession
• Disconnect-PSSession
• Receive-PSSession
• Enter-PSSession
• Exit-PSSession
• Invoke-Command
• New-PSSession
• Remove-PSSession
• about_PSSessions
• about_Remote