Remove-PSSession
하나 이상의 PowerShell 세션(PSSessions)을 닫습니다.
구문
Remove-PSSession
[-Id] <Int32[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-PSSession
[-Session] <PSSession[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-PSSession
-ContainerId <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-PSSession
-VMId <Guid[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-PSSession
-VMName <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-PSSession
-InstanceId <Guid[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-PSSession
-Name <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-PSSession
[-ComputerName] <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Remove-PSSession
cmdlet은 현재 세션에서 PowerShell 세션(PSSessions)을 닫습니다.
PSSessions실행되는 모든 명령을 중지하고, PSSession종료하고, PSSession 사용했던 리소스를 해제합니다.
PSSession 원격 컴퓨터에 연결된 경우 이 cmdlet은 로컬 컴퓨터와 원격 컴퓨터 간의 연결도 닫습니다.
PSSession제거하려면 세션의 이름, ComputerName, ID또는 InstanceID 입력합니다.
PSSession 변수에 저장한 경우 세션 개체는 변수에 남아 있지만 PSSession 상태는 Closed입니다.
예제
예제 1: ID별 세션 제거
Remove-PSSession -Id 1, 2
이 명령은 ID가 1
와 2
인 PSSessions을 제거합니다.
예제 2: 현재 세션의 모든 세션 제거
Get-PSSession | Remove-PSSession
Remove-PSSession -Session (Get-PSSession)
$s = Get-PSSession
Remove-PSSession -Session $s
이러한 명령은 현재 세션의 PSSessions 모두 제거합니다. 세 가지 명령 형식은 다르게 보이지만 동일한 효과가 있습니다.
예제 3: 이름으로 세션 닫기
$r = Get-PSSession -ComputerName Serv*
$r | Remove-PSSession
다음 명령은 이름이 Serv
로 시작하는 컴퓨터에 연결된 PSSessions을 닫습니다.
예제 4: 포트에 연결된 세션 닫기
Get-PSSession | Where-Object {$_.port -eq 90} | Remove-PSSession
이 명령은 포트 90에 연결된 PSSessions 닫습니다. 이 명령 형식을 사용하여 ComputerName, Name, InstanceID및 ID이외의 속성으로 PSSessions을 식별할 수 있습니다.
예제 5: 인스턴스 ID별로 세션 닫기
Get-PSSession | Format-Table ComputerName, InstanceID -AutoSize
ComputerName InstanceId
------------ ----------------
Server01 875d231b-2788-4f36-9f67-2e50d63bb82a
localhost c065ffa0-02c4-406e-84a3-dacb0d677868
Server02 4699cdbc-61d5-4e0d-b916-84f82ebede1f
Server03 4e5a3245-4c63-43e4-88d0-a7798bfc2414
TX-TEST-01 fc4e9dfa-f246-452d-9fa3-1adbdd64ae85
Remove-PSSession -InstanceID fc4e9dfa-f246-452d-9fa3-1adbdd64ae85
이러한 명령은 인스턴스 ID에 따라 PSSession 닫거나 RemoteRunspaceID 방법을 보여 줍니다.
첫 번째 명령은 Get-PSSession
cmdlet을 사용하여 현재 세션에서 PSSessions 가져옵니다.
파이프라인 연산자(|
)를 사용하여 PSSessions를 Format-Table
cmdlet에 보냅니다. 이 cmdlet은 ComputerName과 InstanceID 속성을 테이블 형식으로 지정합니다.
AutoSize 매개 변수는 표시할 열을 압축합니다.
결과 화면에서 닫아야 할 PSSession을 식별한 후, 해당 PSSession의 InstanceID를 복사하여 두 번째 명령에 붙여넣을 수 있습니다.
두 번째 명령은 Remove-PSSession
cmdlet을 사용하여 지정된 인스턴스 ID가 있는 PSSession 제거합니다.
예제 6: 현재 세션의 모든 세션을 삭제하는 함수 만들기
Function EndPSS { Get-PSSession | Remove-PSSession }
이 함수는 현재 세션의 모든 PSSession 닫습니다. PowerShell 프로필에 이 함수를 추가한 후 모든 세션을 삭제하려면 EndPSS
입력합니다.
매개 변수
-ComputerName
컴퓨터 이름의 배열을 지정합니다. 이 cmdlet은 지정된 컴퓨터에 연결된 PSSessions 닫습니다. 와일드카드 문자가 허용됩니다.
하나 이상의 원격 컴퓨터의 NetBIOS 이름, IP 주소 또는 정규화된 도메인 이름을 입력합니다. 로컬 컴퓨터를 지정하려면 컴퓨터 이름, localhost
또는 점(.
)을 입력합니다.
형식: | String[] |
별칭: | Cn |
Position: | 0 |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | True |
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
형식: | SwitchParameter |
별칭: | cf |
Position: | Named |
Default value: | False |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ContainerId
컨테이너 ID의 배열을 지정합니다. 이 cmdlet은 지정된 각 컨테이너에 대한 세션을 제거합니다.
docker ps
명령을 사용하여 컨테이너 ID 목록을 가져옵니다. 자세한 내용은 docker ps 명령에 대한 도움말을 참조하세요.
형식: | String[] |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-Id
세션 ID의 배열을 지정합니다. 이 cmdlet은 지정된 ID를 사용하여 PSSessions 닫습니다.
하나 이상의 ID를 쉼표로 구분하여 입력하거나 범위 연산자(..
)를 사용하여 ID 범위를 지정합니다.
ID는 현재 세션의 PSSession 고유하게 식별하는 정수입니다.
InstanceId보다 쉽게 기억하고 입력할 수 있지만 현재 세션에서만 고유합니다.
PSSessionID를 찾으려면 매개 변수 없이 Get-PSSession
cmdlet을 실행합니다.
형식: | Int32[] |
Position: | 0 |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-InstanceId
인스턴스 ID의 배열을 지정합니다. 이 cmdlet은 지정된 인스턴스 ID가 있는 PSSessions 닫습니다.
인스턴스 ID는 현재 세션의 PSSession 고유하게 식별하는 GUID입니다. 인스턴스 ID는 단일 컴퓨터에서 여러 세션을 실행하는 경우에도 고유합니다.
인스턴스 ID는 PSSession나타내는 개체의 InstanceID 속성에 저장됩니다. 현재 세션에서 PSSessions의 InstanceID을 찾으려면 Get-PSSession | Format-Table Name, ComputerName, InstanceId
입력합니다.
형식: | Guid[] |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-Name
친숙한 세션 이름의 배열을 지정합니다. 이 cmdlet은 지정된 친숙한 이름을 가진 PSSessions을 닫습니다. 와일드카드 문자가 허용됩니다.
PSSession의 이름이 중복될 수 있으므로, Name 매개 변수를 사용할 때에는 Confirm 또는 WhatIf 매개 변수를 Remove-PSSession
명령에 함께 사용하는 것이 좋습니다.
형식: | String[] |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | True |
-Session
닫을 PSSessions 세션 개체를 지정합니다.
PSSessions을 포함하는 변수를 입력하거나 PSSessions을 만들거나 가져오는 New-PSSession
또는 Get-PSSession
명령과 같은 명령을 입력합니다. 하나 이상의 세션 개체를 Remove-PSSession
에 파이프할 수도 있습니다.
형식: | PSSession[] |
Position: | 0 |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-VMId
가상 머신의 ID 배열을 지정합니다. 이 cmdlet은 지정된 각 가상 머신과 대화형 세션을 시작합니다. 사용할 수 있는 가상 머신을 보려면 다음 명령을 사용합니다.
Get-VM | Select-Object -Property Name, ID
형식: | Guid[] |
별칭: | VMGuid |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-VMName
가상 머신의 이름 배열을 지정합니다. 이 cmdlet은 지정된 각 가상 머신과 대화형 세션을 시작합니다. 사용할 수 있는 가상 머신을 보려면 Get-VM
cmdlet을 사용합니다.
형식: | String[] |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.
형식: | SwitchParameter |
별칭: | wi |
Position: | Named |
Default value: | False |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
입력
세션 개체를 이 cmdlet으로 파이프할 수 있습니다.
출력
None
이 cmdlet은 출력을 반환하지 않습니다.
참고
PowerShell에는 Remove-PSSession
다음과 같은 별칭이 포함되어 있습니다.
모든 플랫폼:
rsn
ID 매개 변수는 필수입니다. 현재 세션에서 PSSessions 모두 삭제하려면
Get-PSSession | Remove-PSSession
입력합니다.PSSession 원격 컴퓨터에 대한 영구 연결을 사용합니다. PSSession 만들어 데이터를 공유하는 일련의 명령을 실행합니다. 자세한 내용은
Get-Help about_PSSessions
입력합니다.PSSessions 현재 세션과 관련이 있습니다. 세션을 종료하면 해당 세션에서 만든 PSSessions 강제로 닫힙니다.
관련 링크
PowerShell