共用方式為

Remove-PSSession

  • 參考
模組:
Microsoft.PowerShell.Core

關閉一或多個 PowerShell 工作階段 （PSSessions）。

語法

Remove-PSSession
      [-Id] <Int32[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-PSSession
      [-Session] <PSSession[]>
      [-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

Remove-PSSession Cmdlet 會在目前的工作階段中關閉 PowerShell 會話 （PSSessions]。 它會停止在 PSSessions中執行的任何命令、結束 PSSession，並釋放使用 PSSession 的資源。 如果 PSSession 連線到遠端電腦，此 Cmdlet 也會關閉本機和遠端電腦之間的連線。

若要移除 PSSession，請輸入會話的 Name、ComputerName、ID或 InstanceID。

如果您已將 PSSession 儲存在變數中，會話物件會保留在變數中，但 PSSession 的狀態為 Closed。

範例

範例 1：使用標識碼移除會話

Remove-PSSession -Id 1, 2

此命令會移除具有標識碼 1 和 2 的 PSSessions 。

範例 2：移除目前會話中的所有會話

Get-PSSession | Remove-PSSession
Remove-PSSession -Session (Get-PSSession)
$s = Get-PSSession
Remove-PSSession -Session $s

這些命令會移除目前會話中所有 PSSessions。 雖然這三種命令格式看起來不同，但它們具有相同的效果。

範例 3：使用名稱關閉工作階段

$r = Get-PSSession -ComputerName Serv*
$r | Remove-PSSession

這些命令會關閉已連線到名稱為 Serv 的電腦 PSSessions。

範例 4：關閉連線到埠的會話

Get-PSSession | where {$_.port -eq 90} | Remove-PSSession

此命令會關閉連線至埠 90 的 PSSessions。 您可以使用此命令格式，藉由 ComputerName、Name、InstanceID和 標識符以外的屬性來 識別 PSSessions。

範例 5：根據實例標識碼關閉工作階段

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

這些命令示範如何根據其實例標識碼，或 RemoteRunspaceID關閉 PSSession。

第一個命令會使用 Get-PSSession Cmdlet 來取得目前會話中的 PSSessions。 它會使用管線運算符 （|） 將 PSSessions 傳送至 Format-Table Cmdlet，以格式化其 ComputerName，並在數據表中 InstanceID 屬性。 AutoSize 參數會壓縮要顯示的欄。

從產生的顯示中，您可以識別要關閉的 PSSession，然後將該 PSSession 的 InstanceID 複製並貼到第二個命令中。

第二個命令會使用 remove-PSSession Cmdlet Remove-PSSession，移除具有指定實例標識碼的 PSSession。

範例 6：建立函式，以刪除目前工作階段中的所有工作階段

Function EndPSS { Get-PSSession | Remove-PSSession }

此函式會刪除目前會話中所有 PSSessions。 將此函式新增至 PowerShell 設定檔之後，若要刪除所有工作階段，請輸入 EndPSS。

參數

-ComputerName

指定計算機名稱的陣列。 此 Cmdlet 會關閉連接到指定電腦的 PSSessions。 允許通配符。

輸入 NetBIOS 名稱、IP 位址或一或多部遠端電腦的完整功能變數名稱。 若要指定本機計算機，請輸入計算機名稱、localhost 或點 （.）。

類型:String[]
別名:Cn
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:True

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-Id

指定會話的識別碼陣列。 此 Cmdlet 會關閉具有指定標識碼 PSSessions。 輸入一或多個標識碼，並以逗號分隔，或使用範圍運算符 （..） 來指定標識符的範圍。

標識碼是整數，可唯一識別目前會話中 PSSession。 比 InstanceId更容易記住並輸入 ，但只在目前的會話中是唯一的。 若要尋找 PSSession的標識碼，請執行不含參數的 Get-PSSession Cmdlet。

類型:Int32[]
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-InstanceId

指定實例識別碼的陣列。 此 Cmdlet 會關閉具有指定實例識別碼的 PSSessions。

實例標識碼是 GUID，可唯一識別目前會話中 PSSession。 實例標識碼是唯一的，即使您在單一計算機上執行多個會話也是如此。

實例標識碼會儲存在 物件的 InstanceID 屬性中，代表 PSSession。 若要在目前工作階段中尋找 PSSessions 的 InstanceID，請輸入 Get-PSSession | Format-Table Name, ComputerName, InstanceId。

類型:Guid[]
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-Name

指定工作階段易記名稱的陣列。 此 Cmdlet 會關閉具有指定易記名稱 PSSessions。 允許通配符。

由於 PSSession 的易記名稱可能不是唯一的，因此當您使用 Name 參數時，也請考慮在 Remove-PSSession 命令中使用 WhatIf 或 Confirm 參數。

類型:String[]
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:True

-Session

指定要關閉之 PSSessions 的工作階段物件。 輸入變數，其中包含 PSSessions 或建立或取得 PSSessions的命令，例如 New-PSSession 或 Get-PSSession 命令。 您也可以使用管線將一或多個工作階段物件傳送至 Remove-PSSession。

類型:PSSession[]
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。

類型:SwitchParameter
別名:wi
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

PSSession

您可以使用管線將會話物件傳送至此 Cmdlet。

輸出

None

此 Cmdlet 不會傳回任何物件。

備註

  • 識別碼 參數是必要的。 若要刪除目前工作階段中的所有 PSSessions，請輸入 Get-PSSession | Remove-PSSession。
  • PSSession 會使用遠端電腦的持續性連線。 建立 PSSession，以執行一系列共享數據的命令。 如需詳細資訊，請輸入 Get-Help about_PSSessions。
  • PSSessions 是目前會話特有的。 當您結束會話時，您在該會話中建立的 PSSessions 會強制關閉。