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, 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 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-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 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-1adbdd64ae85

Ezek 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 (.).

Type:String[]
Aliases:Cn
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:Int32[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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: .

Type:Guid[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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

Type:PSSession[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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

Type:Guid[]
Aliases:VMGuid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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 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őtGet-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.