Remove-PSSession
Bezár egy vagy több PowerShell-munkamenetet (PSSessions).
Syntax
Id (Alapértelmezett)
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
A Remove-PSSession parancsmag bezárja a PowerShell-munkameneteket (PSSessions) az aktuális munkamenetben. Leállítja a PSSessionsfutó parancsokat, leállítja a PSSession, és felszabadítja azokat az erőforrásokat, amelyeket a PSSession használt. Ha a PSSession távoli számítógéphez csatlakozik, ez a parancsmag a helyi és a távoli számítógépek közötti kapcsolatot is bezárja.
Ha el szeretne távolítani egy PSSession, adja meg a Név, Számítógépnév, azonosítóvagy Példányazonosító.
Ha egy változóba mentette a PSSession, 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, 2
Ez 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 $s
Ezek a parancsok eltávolítják az összes PSSessions az aktuális munkamenetben. 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-PSSession
Ezek 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-PSSession
Ez a parancs bezárja a PSSessions, amelyek a 90-s porthoz csatlakoznak. Ezzel a parancsformátummal azonosíthatja PSSessions nem ComputerName, Name, InstanceIDés ID.
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-1adbdd64ae85
Ezek a parancsok bemutatják, hogyan zárhat be egy PSSession a példányazonosítója vagy RemoteRunspaceIDalapján.
Az első parancs a Get-PSSession parancsmagot használja a PSSessions lekéréséhez az aktuális munkamenetben.
Egy folyamatoperátorral (|) küldi el a PSSessionsFormat-Table parancsmagnak, amely egy táblában formázza a ComputerName és az InstanceID tulajdonságait. Az Automatikus méretezés paraméter tömöríti az oszlopokat a megjelenítéshez.
Az eredményül kapott megjelenítéssel azonosíthatja a bezárandó PSSession, majd másolja és illessze be a PSSessionInstanceID 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 EndPSS.
Paraméterek
-ComputerName
Megadja a számítógépek neveit tartalmazó tömböt. Ez a parancsmag bezárja a megadott számítógépekhez csatlakoztatott PSSessions. 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, localhostvagy pont (.).
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
| Aliasok: | Cn |
Paraméterkészletek
ComputerName
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-Confirm
Megerősítést kér a parancsmag futtatása előtt.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Cf |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-ContainerId
Tárolók azonosítóinak tömbje. Ez a parancsmag eltávolítja a megadott tárolók munkameneteit. A tárolóazonosítók listájának lekéréséhez használja a docker ps parancsot. További információt a docker ps parancs súgójában talál.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
ContainerId
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-Id
A munkamenetek azonosítóinak tömbje. Ez a parancsmag bezárja a PSSessions a megadott azonosítókkal.
Írjon be egy vagy több azonosítót vesszővel elválasztva, vagy használja a tartományoperátort (..) az azonosítók tartományának megadásához.
Az azonosító egy egész szám, amely egyedileg azonosítja a PSSession az aktuális munkamenetben. Könnyebb megjegyezni és begépelni, mint a 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.
Paramétertulajdonságok
| Típus: | Int32[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
Id
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | 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.
A példányazonosító egy GUID, amely egyedileg azonosít egy PSSession 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ó az objektum InstanceID tulajdonságában van tárolva, amely egy PSSessionjelöl. Az aktuális munkamenetben
Paramétertulajdonságok
| Típus: | Guid[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
InstanceId
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | 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. 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.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
Name
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-Session
Megadja a PSSessions bezárandó 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 New-PSSession egy Get-PSSession parancsot. Egy vagy több munkamenet-objektumot is becsúszthat.Remove-PSSession
Paramétertulajdonságok
| Típus: | |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
Session
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | 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
Paramétertulajdonságok
| Típus: | Guid[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | VMGuid |
Paraméterkészletek
VMId
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | 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. Az Ön számára elérhető virtuális gépek megtekintéséhez használja a Get-VM parancsmagot.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
VMName
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-WhatIf
Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Wi |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
PSSession
Erre a parancsmagra egy munkamenet-objektumot csövezhet.
Kimenetek
None
Ez a parancsmag nem ad vissza kimenetet.
Jegyzetek
A PowerShell a következő aliasokat tartalmazza Remove-PSSession:
Minden platform:
rsn
A azonosító paraméter megadása kötelező. Az aktuális munkamenetben
PSSessions törléséhez írja be a . A PSSession állandó kapcsolatot használ egy távoli számítógéppel. Hozzon létre egy PSSession az adatokat megosztó parancsok futtatásához. További információkért írja be a következőt
Get-Help about_PSSessions:PSSessions az aktuális munkamenetre vonatkoznak. Amikor befejez egy munkamenetet, a munkamenetben létrehozott PSSessions kényszerítetten bezárul.