Remove-PSSession
Bezár egy vagy több PowerShell-munkamenetet (PSSessions).
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
A Remove-PSSession parancsmag bezárja a PowerShell-munkameneteket (PSSessions) az aktuális munkamenetben. Leállítja a PSSessionsban futó parancsokat, leállítja a PSSessiont, és felszabadítja a PSSession által használt erőforrásokat. Ha a PSSession távoli számítógéphez van csatlakoztatva, ez a parancsmag a helyi és a távoli számítógépek közötti kapcsolatot is bezárja.
PSSession eltávolításához adja meg a munkamenet nevét, számítógépnevét, azonosítóját vagy példányazonosítóját.
Ha a PSSessiont egy változóban mentette, a munkamenet-objektum a változóban marad, de a PSSession állapota zárva van.
Példák
1. példa: Munkamenetek eltávolítása azonosító alapján
Remove-PSSession -Id 1, 2Ez a parancs eltávolítja azokat a PSSessionokat , amelyek azonosítókkal 1 és 2.
2. példa: Az aktuális munkamenet összes munkamenetének eltávolítása
Get-PSSession | Remove-PSSession
Remove-PSSession -Session (Get-PSSession)
$s = Get-PSSession
Remove-PSSession -Session $sEzek a parancsok eltávolítják az aktuális munkamenet összes PSSessionját . Bár a három parancsformátum eltérően néz ki, ugyanazt a hatást érik el.
3. példa: Munkamenetek bezárása név szerint
$r = Get-PSSession -ComputerName Serv*
$r | Remove-PSSessionEzek a parancsok bezárják azokat a PSSessionokat , amelyek olyan számítógépekhez csatlakoznak, amelyek nevei kezdődnek Serv.
4. példa: Porthoz csatlakoztatott munkamenetek bezárása
Get-PSSession | where {$_.port -eq 90} | Remove-PSSessionEz a parancs bezárja a 90-s porthoz csatlakoztatott PSSessionokat . Ezzel a parancsformátummal azonosíthatja a PSSessionst a ComputerName, a Name, az InstanceID és az ID tulajdonságtól eltérő tulajdonságok alapján.
5. példa: Munkamenet bezárása példányazonosító szerint
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-1adbdd64ae85Ezek a parancsok bemutatják, hogyan zárható be egy PSSession a példányazonosítója vagy a RemoteRunspaceID alapján.
Az első parancs a Get-PSSession parancsmagot használja a PSSessions lekéréséhez az aktuális munkamenetben.
Egy folyamatkezelővel (|) küldi el a PSSessions parancsmagot a Format-Table parancsmagnak, amely egy táblában formázja a ComputerName és InstanceID tulajdonságait. Az AutoSize paraméter tömöríti az oszlopokat a megjelenítéshez.
Az eredményül kapott megjelenítésből azonosíthatja a bezárandó PSSessiont, majd másolja és illessze be az adott PSSession instanceID azonosítóját a második parancsba.
A második parancs a Remove-PSSession parancsmaggal távolítja el a PSSessiont a megadott példányazonosítóval.
6. példa: Olyan függvény létrehozása, amely törli az aktuális munkamenet összes munkamenetét
Function EndPSS { Get-PSSession | Remove-PSSession }Ez a függvény az aktuális munkamenet minden PSSession-ját bezárja. Miután hozzáadta ezt a függvényt a PowerShell-profilhoz, az összes munkamenet törléséhez írja be a kívánt parancsot EndPSS.
Paraméterek
-ComputerName
A számítógépek nevének tömbje. Ez a parancsmag bezárja a megadott számítógépekhez csatlakoztatott PSSessions parancsmagokat . A helyettesítő karakterek használata engedélyezett.
Írja be egy vagy több távoli számítógép NetBIOS-nevét, IP-címét vagy teljes tartománynevét. A helyi számítógép megadásához írja be a számítógép nevét vagy localhostpontját (.).
| Típus: | String[] |
| Aliasok: | Cn |
| Position: | 0 |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | True |
-Confirm
Jóváhagyást kér a parancsmag futtatása előtt.
| Típus: | SwitchParameter |
| Aliasok: | cf |
| Position: | Named |
| Alapértelmezett érték: | False |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-ContainerId
Tárolók azonosítóinak tömbje. Ez a parancsmag eltávolítja a megadott tárolók munkameneteit. docker ps A parancs használatával lekérheti a tárolóazonosítók listáját. További információt a docker ps parancs súgójában talál.
| Típus: | String[] |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-Id
A munkamenetek azonosítóinak tömbje. Ez a parancsmag bezárja a PSSessionst a megadott azonosítókkal.
Írjon be egy vagy több azonosítót vesszővel elválasztva, vagy használja a tartomány operátort (..) egy azonosítótartomány megadásához.
Az azonosító egy egész szám, amely egyedileg azonosítja a PSSessiont az aktuális munkamenetben. Egyszerűbb megjegyezni és begépelni, mint az InstanceId, de csak az aktuális munkamenetben egyedi. A PSSession azonosítójának megkereséséhez futtassa a Get-PSSession parancsmagot paraméterek nélkül.
| Típus: | Int32[] |
| Position: | 0 |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-InstanceId
A példányazonosítók tömbjének megadása. Ez a parancsmag bezárja a megadott példányazonosítókkal rendelkező PSSessions parancsmagokat .
A példányazonosító egy GUID, amely egyedileg azonosítja a PSSessiont az aktuális munkamenetben. A példányazonosító egyedi, még akkor is, ha több munkamenet fut egyetlen számítógépen.
A példányazonosító a PSSession objektum InstanceID tulajdonságában van tárolva. Ha meg szeretné keresni a PSSessions példányazonosítóját az aktuális munkamenetben, írja be a következőtGet-PSSession | Format-Table Name, ComputerName, InstanceId: .
| Típus: | Guid[] |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-Name
A munkamenetek rövid neveit tartalmazó tömböt ad meg. Ez a parancsmag bezárja a megadott felhasználóbarát neveket tartalmazó PSSessions parancsmagokat . A helyettesítő karakterek használata engedélyezett.
Mivel előfordulhat, hogy a PSSession rövid neve nem egyedi, a Név paraméter használatakor fontolja meg a WhatIf vagy a Confirm paraméter használatát is a Remove-PSSession parancsban.
| Típus: | String[] |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | True |
-Session
Megadja a bezárandó PSSessions munkamenet-objektumait. Adjon meg egy változót, amely tartalmazza a PSSessionst, vagy egy olyan parancsot, amely létrehozza vagy lekéri a PSSessionst, például egy vagy Get-PSSession egy New-PSSession parancsot. Egy vagy több munkamenet-objektumot is becsúszthat.Remove-PSSession
| Típus: | PSSession[] |
| Position: | 0 |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-VMId
A virtuális gépek azonosítójának tömbje. Ez a parancsmag egy interaktív munkamenetet indít el a megadott virtuális gépek mindegyikével. Az Ön számára elérhető virtuális gépek megtekintéséhez használja a következő parancsot:
Get-VM | Select-Object -Property Name, ID
| Típus: | Guid[] |
| Aliasok: | VMGuid |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-VMName
A virtuális gépek nevének tömbje. Ez a parancsmag egy interaktív munkamenetet indít el a megadott virtuális gépek mindegyikével. A rendelkezésére álló virtuális gépek megtekintéséhez használja a Get-VM parancsmagot.
| Típus: | String[] |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-WhatIf
Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.
| Típus: | SwitchParameter |
| Aliasok: | wi |
| Position: | Named |
| Alapértelmezett érték: | False |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
Bevitelek
Erre a parancsmagra egy munkamenet-objektumot csövezhet.
Kimenetek
None
Ez a parancsmag nem ad vissza kimenetet.
Jegyzetek
A PowerShell a következő aliasokat Remove-PSSessiontartalmazza:
Összes platform:
rsn
Az Azonosító paraméter megadása kötelező. Az aktuális munkamenet összes PSSessions elemének törléséhez írja be a következőt
Get-PSSession | Remove-PSSession: .A PSSession egy távoli számítógép állandó kapcsolatát használja. Hozzon létre egy PSSession-t az adatokat megosztó parancsok sorozatának futtatásához. További információkért írja be a következőt
Get-Help about_PSSessions:A PSSessions az aktuális munkamenetre jellemző. Amikor befejez egy munkamenetet, az abban a munkamenetben létrehozott PSSessions kényszerítetten bezárul.
