Remove-PSSession

Referens

Modul:: Microsoft.PowerShell.Core

Stänger en eller flera PowerShell-sessioner (PSSessioner).

Syntax

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

Cmdleten Remove-PSSession stänger PowerShell-sessioner (PSSessions) i den aktuella sessionen. Det stoppar alla kommandon som körs i PSSessions, avslutar PSSessionoch släpper de resurser som PSSession använde. Om PSSession- är ansluten till en fjärrdator stänger den här cmdleten även anslutningen mellan lokala datorer och fjärrdatorer.

Om du vill ta bort en PSSession-anger du Name, ComputerName, IDeller InstanceId för sessionen.

Om du har sparat PSSession- i en variabel finns sessionsobjektet kvar i variabeln, men tillståndet för PSSession är Stängd.

Exempel

Exempel 1: Ta bort sessioner efter ID

Remove-PSSession -Id 1, 2

Det här kommandot tar bort PSSessions- som har ID:t 1 och 2.

Exempel 2: Ta bort alla sessioner i den aktuella sessionen

Get-PSSession | Remove-PSSession
Remove-PSSession -Session (Get-PSSession)
$s = Get-PSSession
Remove-PSSession -Session $s

Dessa kommandon tar bort alla PSSessions- i den aktuella sessionen. Även om de tre kommandoformaten ser olika ut har de samma effekt.

Exempel 3: Stäng sessioner efter namn

$r = Get-PSSession -ComputerName Serv*
$r | Remove-PSSession

Dessa kommandon stänger PSSessions- som är anslutna till datorer som har namn som börjar med Serv.

Exempel 4: Stäng sessioner som är anslutna till en port

Get-PSSession | where {$_.Port -eq 90} | Remove-PSSession

Det här kommandot stänger PSSessions- som är anslutna till port 90. Du kan använda det här kommandoformatet för att identifiera PSSessioner med andra egenskaper än ComputerName, Name, InstanceIdoch ID.

Exempel 5: Stäng en session efter instans-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

Dessa kommandon visar hur du stänger en PSSession- baserat på dess instans-ID eller RemoteRunspaceID.

Det första kommandot använder cmdleten Get-PSSession för att hämta PSSessions- i den aktuella sessionen. Den använder en pipelineoperator (|) för att skicka PSSessions till cmdleten Format-Table som formaterar deras ComputerName- och InstanceId- egenskaper i en tabell. Parametern AutoSize komprimerar kolumnerna för visning.

Från den resulterande visningen kan du identifiera PSSession som ska stängas och kopiera och klistra in InstanceId- för den PSSession- i det andra kommandot.

Det andra kommandot använder cmdleten Remove-PSSession för att ta bort PSSession- med det angivna instans-ID:t.

Exempel 6: Skapa en funktion som tar bort alla sessioner i den aktuella sessionen

function EndPSS { Get-PSSession | Remove-PSSession }

Den här funktionen stänger varje PSSession- i den aktuella sessionen. När du har lagt till den här funktionen i PowerShell-profilen skriver du EndPSSom du vill ta bort alla sessioner.

Parametrar

-ComputerName

Anger en matris med namn på datorer. Den här cmdleten stänger PSSessions- som är anslutna till de angivna datorerna. Jokertecken tillåts.

Ange NetBIOS-namnet, en IP-adress eller ett fullständigt domännamn för en eller flera fjärrdatorer. Om du vill ange den lokala datorn skriver du datornamnet, localhosteller en punkt (.).

Typ:	String[]
Alias:	Cn
Position:	0
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	True

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:	SwitchParameter
Alias:	cf
Position:	Named
Standardvärde:	False
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ContainerId

Anger en matris med ID:er för containrar. Den här cmdleten tar bort sessioner för var och en av de angivna containrarna. Använd kommandot docker ps för att hämta en lista över container-ID:t. Mer information finns i hjälpen för kommandot docker ps.

Typ:	String[]
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-Id

Anger en matris med ID:t för sessioner. Den här cmdleten stänger PSSessions- med de angivna ID:na. Ange ett eller flera ID:t, avgränsade med kommatecken, eller använd intervalloperatorn (..) för att ange ett intervall med ID:er.

Ett ID är ett heltal som unikt identifierar PSSession- i den aktuella sessionen. Det är lättare att komma ihåg och skriva än InstanceId, men det är bara unikt i den aktuella sessionen. Om du vill hitta ID:t för en PSSession-kör du cmdleten Get-PSSession utan parametrar.

Typ:	Int32[]
Position:	0
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-InstanceId

Anger en matris med instans-ID:t. Den här cmdleten stänger PSSessioner som har angivna instans-ID:t.

Instans-ID:t är ett GUID som unikt identifierar en PSSession- i den aktuella sessionen. Instans-ID:t är unikt, även om du har flera sessioner som körs på en enda dator.

Instans-ID:t lagras i egenskapen InstanceId för objektet som representerar ett PSSession-. Om du vill hitta InstanceId för PSSessions i den aktuella sessionen skriver du Get-PSSession | Format-Table Name, ComputerName, InstanceId.

Typ:	Guid[]
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-Name

Anger en matris med egna namn på sessioner. Den här cmdleten stänger PSSessions- som har de angivna egna namnen. Jokertecken tillåts.

Eftersom det egna namnet på en PSSession- kanske inte är unikt kan du överväga att även använda parametern WhatIf eller Confirm i kommandot när du använder parametern Remove-PSSession.

Typ:	String[]
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	True

-Session

Anger sessionsobjekten för PSSessions att stänga. Ange en variabel som innehåller PSSessions eller ett kommando som skapar eller hämtar PSSessions, till exempel ett New-PSSession- eller Get-PSSession-kommando. Du kan också skicka ett eller flera sessionsobjekt till Remove-PSSession.

Typ:	PSSession[]
Position:	0
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-VMId

Anger en matris med ID för virtuella datorer. Den här cmdleten startar en interaktiv session med var och en av de angivna virtuella datorerna. Om du vill se de virtuella datorer som är tillgängliga för dig använder du följande kommando:

Get-VM | Select-Object -Property Name, ID

Typ:	Guid[]
Alias:	VMGuid
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-VMName

Anger en matris med namn på virtuella datorer. Den här cmdleten startar en interaktiv session med var och en av de angivna virtuella datorerna. Om du vill se de virtuella datorer som är tillgängliga för dig använder du cmdleten Get-VM.

Typ:	String[]
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:	SwitchParameter
Alias:	wi
Position:	Named
Standardvärde:	False
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

Indata

PSSession

Du kan skicka ett sessionsobjekt till den här cmdleten.

Utdata

None

Den här cmdleten returnerar inga utdata.

Kommentarer

PowerShell innehåller följande alias för Remove-PSSession:

Alla plattformar:
- rsn
Parametern ID är obligatorisk. Om du vill ta bort alla PSSessions- i den aktuella sessionen skriver du Get-PSSession | Remove-PSSession.
En PSSession- använder en beständig anslutning till en fjärrdator. Skapa en PSSession- för att köra en serie kommandon som delar data. Om du vill ha mer information skriver du Get-Help about_PSSessions.
PSSessions är specifika för den aktuella sessionen. När du avslutar en session stängs PSSessions- som du skapade i den sessionen med två skäl.

Dela via

Remove-PSSession

Syntax

Description

Exempel

Exempel 1: Ta bort sessioner efter ID

Exempel 2: Ta bort alla sessioner i den aktuella sessionen

Exempel 3: Stäng sessioner efter namn

Exempel 4: Stäng sessioner som är anslutna till en port

Exempel 5: Stäng en session efter instans-ID

Exempel 6: Skapa en funktion som tar bort alla sessioner i den aktuella sessionen

Parametrar

-ComputerName

-Confirm

-ContainerId

-Id

-InstanceId

-Name

-Session

-VMId

-VMName

-WhatIf

Indata

Utdata

Kommentarer

Ytterligare resurser

Dela via

Remove-PSSession

Syntax

Description

Exempel

Exempel 1: Ta bort sessioner efter ID

Exempel 2: Ta bort alla sessioner i den aktuella sessionen

Exempel 3: Stäng sessioner efter namn

Exempel 4: Stäng sessioner som är anslutna till en port

Exempel 5: Stäng en session efter instans-ID

Exempel 6: Skapa en funktion som tar bort alla sessioner i den aktuella sessionen

Parametrar

-ComputerName

-Confirm

-ContainerId

-Id

-InstanceId

-Name

-Session

-VMId

-VMName

-WhatIf

Indata

Utdata

Kommentarer

Relaterade länkar

Ytterligare resurser