Sdílet prostřednictvím

Remove-PSSession

  • Reference
Modul:
Microsoft.PowerShell.Core

Zavře jednu nebo více relací PowerShellu (PSSessions).

Syntaxe

Remove-PSSession
      [-Id] <Int32[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-PSSession
      [-Session] <PSSession[]>
      [-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

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 odebratPSSession, zadejte Název, Název počítače, ID nebo ID instance 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 jeho 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 rutiny Format-Table, která formátuje jejich vlastnosti ComputerName a InstanceID v tabulce. 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 pomocí rutiny Remove-PSSession odebere 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 odstraní všechny psSessions v aktuální relaci. Po přidání této funkce do profilu PowerShellu zadejte EndPSSvšechny relace.

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 (.).

Typ:String[]
Aliasy:Cn
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:True

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Id

Určuje pole ID 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é jednoznačně identifikuje PSSession v aktuální relaci. Je snazší pamatovat a psát než InstanceId, ale je jedinečný pouze v aktuální relaci. Pokud chcete najít IDPSSession, spusťte rutinu Get-PSSession bez parametrů.

Typ:Int32[]
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-InstanceId

Určuje pole ID instancí. Tato rutina zavře PSSessions, které mají zadané ID 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ženo v InstanceID vlastnost objektu, který představuje PSSession. Pokud chcete najít ID instance PSSessions v aktuální relaci, zadejte .

Typ:Guid[]
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

Určuje pole popisných názvů relací. Tato rutina zavře PSSessions se zadanými popisný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.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:True

-Session

Určuje objekty relace PSSessions zavřít. Zadejte proměnnou, která obsahuje psSessions nebo příkaz, který vytvoří nebo získá psSessions, například New-PSSession nebo Příkaz Get-PSSession. Můžete také řadit jeden nebo více objektů relace Remove-PSSession.

Typ:PSSession[]
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

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, abyste spustili řadu příkazů, které sdílejí data. Další informace potřebujete zadáním 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.