Remove-PSSession
Zavře jednu nebo více relací PowerShellu (PSSessions).
Syntax
Id (Výchozí)
Remove-PSSession
[-Id] <Int32[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Session
Remove-PSSession
[-Session] <PSSession[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ContainerId
Remove-PSSession
-ContainerId <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
VMId
Remove-PSSession
-VMId <Guid[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
VMName
Remove-PSSession
-VMName <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InstanceId
Remove-PSSession
-InstanceId <Guid[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Name
Remove-PSSession
-Name <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ComputerName
Remove-PSSession
[-ComputerName] <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Rutina Remove-PSSession zavře relace PowerShellu (psSessions) v aktuální relaci. Zastaví všechny příkazy, které běží v psSessions, ukončí PSSessiona uvolní prostředky, které PSSession používal. Pokud je psSession připojen ke vzdálenému počítači, tato rutina také ukončí připojení mezi místními a vzdálenými počítači.
Pokud chcete odebrat PSSession, zadejte Název, Název počítače, IDnebo InstanceID relace.
Pokud jste uložili PSSession do proměnné, objekt relace zůstane v proměnné, ale stav PSSession je uzavřen.
Příklady
Příklad 1: Odebrání relací podle ID
Remove-PSSession -Id 1, 2
Tento příkaz odebere PSSessions, které mají ID 1 a 2.
Příklad 2: Odebrání všech relací v aktuální relaci
Get-PSSession | Remove-PSSession
Remove-PSSession -Session (Get-PSSession)
$s = Get-PSSession
Remove-PSSession -Session $s
Tyto příkazy odeberou všechny PSSessions v aktuální relaci. I když tyto tři formáty příkazů vypadají jinak, mají stejný účinek.
Příklad 3: Zavření relací podle názvu
$r = Get-PSSession -ComputerName Serv*
$r | Remove-PSSession
Tyto příkazy zavřou PSSessions, které jsou připojeny k počítačům, jejichž názvy začínají Serv.
Příklad 4: Zavření relací připojených k portu
Get-PSSession | where {$_.port -eq 90} | Remove-PSSession
Tento příkaz zavře psSessions, které jsou připojené k portu 90. Tento formát příkazu můžete použít k identifikaci psSessions jinými vlastnostmi než ComputerName, Name, InstanceIDa ID .
Příklad 5: Zavření relace podle ID instance
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
Tyto příkazy ukazují, jak zavřít PSSession na základě ID instance nebo RemoteRunspaceID.
První příkaz používá rutinu Get-PSSession k získání PSSessions v aktuální relaci.
Pomocí operátoru kanálu (|) odešle PSSessions do cmdletu Format-Table, který formátuje jejich vlastnosti ComputerName a InstanceID do tabulky. Parametr AutoSize komprimuje sloupce pro zobrazení.
Z výsledného zobrazení můžete identifikovat PSSession, který se má zavřít, a zkopírovat a vložit ID instance tohoto PSSession do druhého příkazu.
Druhý příkaz používá rutinu Remove-PSSession k odebrání PSSession se zadaným ID instance.
Příklad 6: Vytvoření funkce, která odstraní všechny relace v aktuální relaci
Function EndPSS { Get-PSSession | Remove-PSSession }
Tato funkce zavře každou PSSession v aktuální relaci. Po přidání této funkce do profilu PowerShellu zadejte EndPSSpro smazání všech relací.
Parametry
-ComputerName
Určuje pole názvů počítačů. Tato rutina zavře psSessions, které jsou připojené k zadaným počítačům. Jsou povoleny zástupné znaky.
Zadejte název NetBIOS, IP adresu nebo plně kvalifikovaný název domény jednoho nebo více vzdálených počítačů. Chcete-li zadat místní počítač, zadejte název počítače, localhostnebo tečku (.).
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
| Aliasy: | Kn |
Sady parametrů
ComputerName
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Confirm
Před spuštěním cmdletu vás vyzve k potvrzení.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | viz |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-ContainerId
Určuje pole ID kontejnerů. Tento cmdlet odebere relace pro každý ze zadaných kontejnerů. Pomocí příkazu docker ps získejte seznam ID kontejnerů. Další informace najdete v nápovědě k příkazu docker ps.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
ContainerId
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Id
Určuje pole identifikátorů relací. Tato rutina zavře PSSessions se zadanými ID.
Zadejte jedno nebo více ID oddělených čárkami nebo pomocí operátoru rozsahu (..) zadejte rozsah ID.
ID je celé číslo, které v aktuální relaci jednoznačně identifikuje PSSession. Je snazší pamatovat a psát než InstanceId, ale je jedinečný pouze v aktuální relaci. Pokud chcete najít ID PSSession, spusťte rutinu Get-PSSession bez parametrů.
Vlastnosti parametru
| Typ: | Int32[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
Id
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-InstanceId
Určuje pole identifikátorů instancí. Tento cmdlet zavře PSSessions, které mají zadané identifikátory instancí.
ID instance je identifikátor GUID, který jednoznačně identifikuje PSSession v aktuální relaci. ID instance je jedinečné, i když máte na jednom počítači spuštěných více relací.
ID instance je uložena ve InstanceID vlastnosti objektu, který představuje PSSession. Pokud chcete najít ID instance PSSessions v aktuální relaci, zadejte Get-PSSession | Format-Table Name, ComputerName, InstanceId.
Vlastnosti parametru
| Typ: | Guid[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
InstanceId
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Name
Určuje pole přátelských názvů relací. Tato rutina zavře PSSessions s určenými přátelskými názvy. Jsou povoleny zástupné znaky.
Protože popisný název psSession nemusí být jedinečný, při použití parametru Name zvažte také použití parametru WhatIf nebo Potvrdit v příkazu Remove-PSSession.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
Name
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Session
Určuje objekty relace u PSSessions, které mají být zavřeny. Zadejte proměnnou, která obsahuje PSSessions, nebo příkaz, který vytvoří či získá PSSessions, jako je příkaz New-PSSession nebo Get-PSSession. Do Remove-PSSessionmůžete přesměrovat také jeden nebo více objektů relace.
Vlastnosti parametru
| Typ: | |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
Session
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-VMId
Určuje pole ID virtuálních počítačů. Tato rutina spustí interaktivní relaci s jednotlivými zadanými virtuálními počítači. K zobrazení dostupných virtuálních počítačů použijte následující příkaz:
Get-VM | Select-Object -Property Name, ID
Vlastnosti parametru
| Typ: | Guid[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | VMGuid |
Sady parametrů
VMId
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-VMName
Určuje pole názvů virtuálních počítačů. Tato rutina spustí interaktivní relaci s jednotlivými zadanými virtuálními počítači. K zobrazení dostupných virtuálních počítačů použijte rutinu Get-VM.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
VMName
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-WhatIf
Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Wi |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
PSSession
K této rutině můžete připojit objekt relace.
Výstupy
None
Tato rutina nevrací žádné objekty.
Poznámky
- Parametr ID je povinný. Pokud chcete odstranit všechny PSSessions v aktuální relaci, zadejte
Get-PSSession | Remove-PSSession. -
PSSession používá trvalé připojení ke vzdálenému počítači. Vytvořte PSSession pro spuštění řady příkazů, které sdílejí data. Pro více informací zadejte
Get-Help about_PSSessions. - PSSessions jsou specifické pro aktuální relaci. Když relaci ukončíte, PSSessions, které jste v této relaci vytvořili, jsou vynuceně uzavřeny.