Get-PSSession
현재 세션의 Windows PowerShell 세션(PSSession)을 가져옵니다.
구문
Get-PSSession [[-ComputerName] <string[]>] [<CommonParameters>]
Get-PSSession [-Id] <Int32[]> [<CommonParameters>]
Get-PSSession [-InstanceId <Guid[]>] [<CommonParameters>]
Get-PSSession [-Name <string[]>] [<CommonParameters>]
설명
Get-PSSession cmdlet은 현재 세션에서 만들어진 Windows PowerShell 세션(PSSession)을 가져옵니다.
매개 변수가 없는 경우 Get-PSSession은 현재 세션에서 만들어진 PSSession을 모두 가져옵니다. Get-PSSession의 매개 변수를 사용하여 특정 컴퓨터에 연결된 세션을 가져오거나 세션의 이름, ID 또는 인스턴스 ID로 세션을 식별할 수 있습니다.
Windows PowerShell 세션에 대한 자세한 내용은 about_PSSessions를 참조하십시오.
매개 변수
-ComputerName <string[]>
지정된 컴퓨터에 연결된 PSSession만 가져옵니다. 와일드카드를 사용할 수 있습니다.
하나 이상의 컴퓨터의 NetBIOS 이름, IP 주소 또는 정규화된 도메인 이름을 입력합니다. 로컬 컴퓨터를 지정하려면 컴퓨터 이름, "localhost" 또는 점(.)을 입력합니다.
필수 여부 |
false |
위치 |
1 |
기본값 |
|
파이프라인 입력 적용 여부 |
true (ByPropertyName) |
와일드카드 문자 적용 여부 |
true |
-Id <Int32[]>
지정된 ID를 가진 PSSession만 가져옵니다. 하나 이상의 ID를 쉼표로 구분하여 입력하거나 범위 연산자(..)를 사용하여 ID 범위를 지정하십시오.
ID는 현재 세션의 PSSession을 고유하게 식별하는 정수입니다. 이 ID는 InstanceId보다 기억하거나 입력하기 쉽지만 현재 세션 내부에서만 고유합니다. PSSession의 ID를 찾으려면 매개 변수 없이 Get-PSSession을 사용합니다.
필수 여부 |
true |
위치 |
1 |
기본값 |
셸의 모든 세션 |
파이프라인 입력 적용 여부 |
true (ByPropertyName) |
와일드카드 문자 적용 여부 |
false |
-InstanceId <Guid[]>
지정된 인스턴스 ID를 가진 PSSession만 가져옵니다.
인스턴스 ID는 로컬 또는 원격 컴퓨터의 PSSession을 고유하게 식별하는 GUID입니다. Windows PowerShell에서 여러 세션이 실행되는 경우에도 InstanceID는 고유합니다.
InstanceID는 PSSession을 나타내는 개체의 InstanceID 속성에 저장됩니다. 현재 세션에서 PSSession의 InstanceID를 찾으려면 "get-pssession | Format-Table Name, ComputerName, InstanceId"를 입력합니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
true (ByPropertyName) |
와일드카드 문자 적용 여부 |
true |
-Name <string[]>
지정된 이름의 PSSession만 가져옵니다. 와일드카드를 사용할 수 있습니다.
현재 세션에 있는 PSSession의 이름을 찾으려면 매개 변수 없이 "get-pssession"을 입력합니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
true (ByPropertyName) |
와일드카드 문자 적용 여부 |
true |
<CommonParameters>
이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_commonparameters.
입력 및 출력
입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.
입력 |
없음 입력을 이 cmdlet으로 파이프할 수 없습니다. |
출력 |
System.Management.Automation.Runspaces.PSSession Get-PSSession은 가져오는 각 PSSession에 대한 PSSession 개체를 반환합니다. |
참고
Get-PSSession은 현재 세션에서 만들어진 PSSession을 가져옵니다. 이 명령은 Windows PowerShell을 열 때 만들어진 세션을 가져오지 않으며 다른 세션이나 다른 컴퓨터에서 만들어진 PSSession을 가져오지 않습니다. 이는 다른 세션이나 다른 컴퓨터가 로컬 컴퓨터에 연결된 경우에도 마찬가지입니다.
예 1
C:\PS>get-pssession
설명
-----------
이 명령은 현재 세션에서 만들어진 PSSession을 모두 가져옵니다.
이 명령은 다른 세션이나 다른 컴퓨터에서 만들어진 PSSession을 가져오지 않습니다. 이는 다른 세션이나 다른 컴퓨터가 해당 컴퓨터에 연결된 경우에도 마찬가지입니다.
예 2
C:\PS>$s = get-pssession -computername Server02
설명
-----------
이 명령은 Server02 컴퓨터에 연결된 PSSession을 가져와서 $p 변수에 저장합니다.
예 3
C:\PS>new-pssession -computername Server01, Server02, Server03
C:\PS> $s1, $s2, $s3 = get-pssession
설명
-----------
이 예에서는 Get-PSSession 명령의 결과를 여러 변수에 저장하는 방법을 보여 줍니다.
첫 번째 명령은 New-PSSession cmdlet을 사용하여 세 원격 컴퓨터에 PSSession을 만듭니다.
두 번째 명령은 Get-PSSession cmdlet을 사용하여 세 PSSession을 가져온 다음 각 PSSession을 별도의 변수에 저장합니다.
Windows PowerShell은 개체의 배열을 변수의 배열에 할당할 때 첫 번째 개체를 첫 번째 변수에 할당하고 두 번째 개체를 두 번째 변수에 할당하는 식으로 개체를 변수에 할당합니다. 변수보다 개체가 많은 경우에는 모든 나머지 개체를 마지막 변수에 배열로 할당합니다. 개체보다 변수가 많은 경우에는 추가 변수가 사용되지 않습니다.
예 4
C:\PS>get-pssession | format-table -property computername, InstanceID
C:\PS> $s = get-pssession -InstanceID a786be29-a6bb-40da-80fb-782c67f7db0f
C:\PS> remove-pssession -session $s
설명
-----------
이 예에서는 인스턴스 ID를 사용하여 PSSession을 가져온 다음 해당 PSSession을 삭제하는 방법을 보여 줍니다.
첫 번째 명령은 로컬 컴퓨터의 PSSession을 모두 가져옵니다. 이 명령은 PSSession을 Format-Table cmdlet으로 보내고, 이 cmdlet은 각 PSSession의 ComputerName 및 InstanceID 속성을 표시합니다.
두 번째 명령은 Get-PSSession cmdlet을 사용하여 특정 PSSession을 가져와서 $s 변수에 저장합니다. 이 명령은 InstanceID 매개 변수를 사용하여 PSSession을 식별합니다.
세 번째 명령은 Remove-PSSession cmdlet을 사용하여 $s 변수에서 PSSession을 삭제합니다.
예 5
C:\PS>get-pssession -computername Serv*
설명
-----------
이 명령은 컴퓨터 이름이 "Serv"로 시작하는 컴퓨터에 연결된 PSSession을 모두 가져옵니다.
예 6
C:\PS>get-pssession -name Test*, Ux*
설명
-----------
이 명령은 이름이 "Test" 또는 "Ux"로 시작하는 PSSession을 가져옵니다.
예 7
C:\PS>get-pssession 2
설명
-----------
이 명령은 ID가 2인 PSSession을 가져옵니다.
참고 항목
개념
about_PSSessions
about_Remote
New-PSSession
Remove-PSSession
Enter-PSSession
Exit-PSSession
Invoke-Command