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>]
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ókkal
Remove-PSSession -Id 1, 2
Ez a parancs eltávolítja a PSSessions, amelyek 1. és 2. azonosítóval rendelkeznek.
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 nevek használatával
$r = Get-PSSession -ComputerName Serv*
$r | Remove-PSSession
Ezek a parancsok bezárják a PSSessions, amelyek olyan számítógépekhez csatlakoznak, amelyek neve a Serv kezdetű.
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 a példányazonosító alapján
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
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. Folyamatkezelővel (|) küldi el a PSSessions a Format-Table parancsmagba, amely formázja a ComputerName és InstanceID tulajdonságait egy táblában. 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 PSSession 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 törli az összes PSSessions az aktuális munkamenetben.
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, a localhost vagy a 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 |
-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ány operátort (..) egy azonosítótartomány 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. Egy PSSessionazonosí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 egy PSSession rövid neve nem egyedi, a Name paraméter használatakor érdemes lehet a WhatIf vagy Confirm paramétert használni 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 PSSessions vagy egy parancsot, amely létrehozza vagy lekéri a PSSessions, például egy New-PSSession vagy Get-PSSession parancsot.
A Remove-PSSession
Paramétertulajdonságok
| Típus: | PSSession[] |
| 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 |
-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 objektumokat.
Jegyzetek
- 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.