Remove-PSSession
Hiermee sluit u een of meer PowerShell-sessies (PSSessions).
Syntax
Id (Standaard)
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
De Remove-PSSession cmdlet sluit PowerShell-sessies (PSSessions) in de huidige sessie. Het stopt alle opdrachten die worden uitgevoerd in de PSSessions, beëindigt de PSSession en publiceert de resources die de PSSession gebruikte. Als de PSSession is verbonden met een externe computer, sluit deze cmdlet ook de verbinding tussen de lokale en externe computers.
Als u een PSSession wilt verwijderen, voert u de naam, computernaam, id of InstanceId van de sessie in.
Als u de PSSession in een variabele hebt opgeslagen, blijft het sessieobject in de variabele, maar is de status van de PSSession gesloten.
Voorbeelden
Voorbeeld 1: Sessies verwijderen op id
Remove-PSSession -Id 1, 2
Met deze opdracht verwijdert u de PSSessions met id's 1 en 2.
Voorbeeld 2: Alle sessies in de huidige sessie verwijderen
Get-PSSession | Remove-PSSession
Remove-PSSession -Session (Get-PSSession)
$s = Get-PSSession
Remove-PSSession -Session $s
Met deze opdrachten worden alle PSSessions in de huidige sessie verwijderd. Hoewel de drie opdrachtindelingen er anders uitzien, hebben ze hetzelfde effect.
Voorbeeld 3: Sessies sluiten op naam
$r = Get-PSSession -ComputerName Serv*
$r | Remove-PSSession
Met deze opdrachten sluit u de PSSessions die zijn verbonden met computers met namen die beginnen met Serv.
Voorbeeld 4: Sessies sluiten die zijn verbonden met een poort
Get-PSSession | where {$_.Port -eq 90} | Remove-PSSession
Met deze opdracht sluit u de PSSessions die zijn verbonden met poort 90. U kunt deze opdrachtindeling gebruiken om PSSessions te identificeren op andere eigenschappen dan ComputerName, Name, InstanceId en Id.
Voorbeeld 5: Een sessie sluiten op exemplaar-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
Deze opdrachten laten zien hoe u een PSSession sluit op basis van de exemplaar-id of RemoteRunspaceID.
De eerste opdracht gebruikt de Get-PSSession cmdlet om de PSSessions op te halen in de huidige sessie.
Er wordt een pijplijnoperator (|) gebruikt om de PSSessions naar de Format-Table cmdlet te verzenden, waarmee de eigenschappen ComputerName en InstanceId in een tabel worden opgemaakt. De parameter AutoSize comprimeert de kolommen voor weergave.
Vanaf de resulterende weergave kunt u de PSSession identificeren die moet worden gesloten en de InstanceId van die PSSession kopiëren en plakken in de tweede opdracht.
De tweede opdracht gebruikt de Remove-PSSession cmdlet om de PSSession te verwijderen met de opgegeven exemplaar-id.
Voorbeeld 6: Een functie maken waarmee alle sessies in de huidige sessie worden verwijderd
function EndPSS { Get-PSSession | Remove-PSSession }
Met deze functie wordt elke PSSession in de huidige sessie gesloten. Nadat u deze functie aan uw PowerShell-profiel hebt toegevoegd, typt u om alle sessies EndPSSte verwijderen.
Parameters
-ComputerName
Geeft een lijst van computernamen op. Met deze cmdlet worden de PSSessions gesloten die zijn verbonden met de opgegeven computers. Jokertekens zijn toegestaan.
Typ de NetBIOS-naam, een IP-adres of een volledig gekwalificeerde domeinnaam van een of meer externe computers. Als u de lokale computer wilt opgeven, typt u de computernaam, localhostof een punt (.).
Parametereigenschappen
| Type: | String[] |
| Default value: | None |
| Ondersteunt jokertekens: | True |
| DontShow: | False |
| Aliassen: | Cn |
Parametersets
ComputerName
| Position: | 0 |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-Confirm
Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Cf |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-ContainerId
Hiermee geeft u een matrix van id's van containers. Met deze cmdlet worden sessies voor elk van de opgegeven containers verwijderd. Gebruik de opdracht docker ps om een lijst met container-id's op te halen. Zie de Help voor de opdracht docker ps voor meer informatie.
Parametereigenschappen
| Type: | String[] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
ContainerId
| Position: | Named |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-Id
Hiermee geeft u een matrix van id's van sessies. Met deze cmdlet worden de PSSessions gesloten met de opgegeven id's.
Typ een of meer id's, gescheiden door komma's of gebruik de bereikoperator (..) om een bereik van id's op te geven.
Een id is een geheel getal dat de PSSession uniek identificeert in de huidige sessie. Het is gemakkelijker om te onthouden en te typen dan de InstanceId, maar het is alleen uniek in de huidige sessie. Als u de id van een PSSession wilt vinden, voert u de Get-PSSession cmdlet uit zonder parameters.
Parametereigenschappen
| Type: | Int32[] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
Id
| Position: | 0 |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-InstanceId
Hiermee geeft u een matrix van exemplaar-id's. Met deze cmdlet worden de PSSessions gesloten met de opgegeven exemplaar-id's.
De exemplaar-id is een GUID die een PSSession uniek identificeert in de huidige sessie. De exemplaar-id is uniek, zelfs als er meerdere sessies worden uitgevoerd op één computer.
De exemplaar-id wordt opgeslagen in de eigenschap InstanceId van het object dat een PSSession vertegenwoordigt. Als u de InstanceId van de PSSessions in de huidige sessie wilt vinden, typt u Get-PSSession | Format-Table Name, ComputerName, InstanceId.
Parametereigenschappen
| Type: | Guid[] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
InstanceId
| Position: | Named |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-Name
Hiermee geeft u een matrix van beschrijvende namen van sessies. Met deze cmdlet worden de PSSessions gesloten met de opgegeven beschrijvende namen. Jokertekens zijn toegestaan.
Omdat de beschrijvende naam van een PSSession mogelijk niet uniek is, kunt u, wanneer u de parameter Name gebruikt, ook overwegen de parameter WhatIf of Confirm in de Remove-PSSession opdracht te gebruiken.
Parametereigenschappen
| Type: | String[] |
| Default value: | None |
| Ondersteunt jokertekens: | True |
| DontShow: | False |
Parametersets
Name
| Position: | Named |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-Session
Hiermee geeft u de sessieobjecten van de PSSessions te sluiten. Voer een variabele in die de PSSessions of een opdracht bevat die de PSSessions maakt of ophaalt, zoals een New-PSSession of Get-PSSession opdracht. U kunt ook een of meer sessieobjecten doorsluisen naar Remove-PSSession.
Parametereigenschappen
| Type: | |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
Session
| Position: | 0 |
| Verplicht: | True |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-VMId
Hiermee geeft u een matrix van id van virtuele machines. Met deze cmdlet wordt een interactieve sessie gestart met elk van de opgegeven virtuele machines. Gebruik de volgende opdracht om de virtuele machines weer te geven die voor u beschikbaar zijn:
Get-VM | Select-Object -Property Name, ID
Parametereigenschappen
| Type: | Guid[] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | VMGuid |
Parametersets
VMId
| Position: | Named |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-VMName
Bepaalt een array van namen van virtuele machines. Met deze cmdlet wordt een interactieve sessie gestart met elk van de opgegeven virtuele machines. Gebruik de Get-VM cmdlet om de virtuele machines te zien die voor u beschikbaar zijn.
Parametereigenschappen
| Type: | String[] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
VMName
| Position: | Named |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-WhatIf
Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Wi |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.
Invoerwaarden
PSSession
U kunt een sessieobject doorsluisen naar deze cmdlet.
Uitvoerwaarden
None
Deze cmdlet retourneert geen uitvoer.
Notities
PowerShell bevat de volgende aliassen voor Remove-PSSession:
Alle platforms:
rsn
De id-parameter is verplicht. Als u alle PSSessions in de huidige sessie wilt verwijderen, typt u
Get-PSSession | Remove-PSSession.Een PSSession maakt gebruik van een permanente verbinding met een externe computer. Maak een PSSession om een reeks opdrachten uit te voeren waarmee gegevens worden gedeeld. Typ voor meer informatie
Get-Help about_PSSessions.PSSessions zijn specifiek voor de huidige sessie. Wanneer u een sessie beëindigt, worden de PSSessions die u in die sessie hebt gemaakt, geforceerd gesloten.