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>]
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í pomocí ID
Remove-PSSession -Id 1, 2
Tento příkaz odebere psSessions s 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í pomocí názvů
$r = Get-PSSession -ComputerName Serv*
$r | Remove-PSSession
Tyto příkazy zavře psSessions, které jsou připojené k počítačům, které mají názvy začínající 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 na základě 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 PS C:\> 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
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 pomocí rutiny
Příklad 6: Vytvoření funkce, která odstraní všechny relace v aktuální relaci
Function EndPSS { Get-PSSession | Remove-PSSession }
Tato funkce odstraní všechny psSessions 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, localhost nebo 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 |
-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
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 parametr 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
Vlastnosti parametru
| Typ: | PSSession[] |
| 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 |
-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.