Remove-PSSession
關閉一或多個 PowerShell 工作階段 （PSSessions）。
語法
Id (預設值)
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
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、名稱、InstanceID和 ID之外的屬性來識別 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
範例 6：建立函式，以刪除目前工作階段中的所有會議階段。
Function EndPSS { Get-PSSession | Remove-PSSession }
此函式會刪除目前會話中所有 PSSessions。
將此函式新增至 PowerShell 設定檔之後，若要刪除所有工作階段，請輸入 EndPSS。
參數
-ComputerName
指定計算機名稱的陣列。 此 Cmdlet 會關閉連接到指定電腦的 PSSessions。 允許使用通配符字元。
輸入 NetBIOS 名稱、IP 位址或一部或多部遠端電腦的完整網域名稱。 若要指定本機計算機，請輸入計算機名稱、localhost 或點 （.）。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | True |
| 不要顯示: | False |
| 別名: | Cn |
參數集
ComputerName
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Confirm
在執行 Cmdlet 之前，提示您進行確認。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | cf |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Id
指定會話的識別碼陣列。 此命令將會關閉具有指定標識碼的 PSSessions。 輸入一或多個標識碼，並以逗號分隔，或使用範圍運算符 （..） 來指定標識符的範圍。
在目前會話中，ID 是一個整數，用於唯一識別 PSSession。 比 InstanceId更容易記住和輸入，但只在當前的會話中是唯一的。 若要尋找 PSSession的標識碼，請執行不含參數的 Get-PSSession Cmdlet。
參數屬性
| 類型: | Int32[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Id
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-InstanceId
指定一組實例識別碼。 此 Cmdlet 會關閉具有指定實例識別碼的 PSSessions。
實例標識碼是 GUID，用於唯一識別目前會話中的 PSSession。 實例標識碼是唯一的，即使您在單一計算機上執行多個會話也是如此。
實例標識碼會儲存在 物件的 InstanceID 屬性中，代表 PSSession。
若要在目前工作階段中尋找 PSSessions 的 InstanceID，請輸入 Get-PSSession | Format-Table Name, ComputerName, InstanceId。
參數屬性
| 類型: | Guid[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
InstanceId
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Name
指定工作階段易記名稱的陣列。 此 Cmdlet 會關閉具有指定易記名稱的 PSSessions。 允許使用通配符字元。
由於 PSSession 的易記名稱可能不是唯一的，因此當您使用 Name 參數時，也請考慮在 Remove-PSSession 命令中使用 WhatIf 或 Confirm 參數。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | True |
| 不要顯示: | False |
參數集
Name
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Session
指定要關閉之 PSSessions 的工作階段物件。 輸入變數，其中包含 PSSessions 或建立或取得 PSSessions的命令，例如 New-PSSession 或 Get-PSSession 命令。 您也可以使用管線將一或多個工作階段物件傳送至 Remove-PSSession。
參數屬性
| 類型: | PSSession[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Session
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。 指令未執行。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 無線 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸入
PSSession
您可以透過管線將會話物件傳送至此 CMDLET。
輸出
None
此 Cmdlet 不會傳回任何物件。
備註
-
識別碼 參數是必要的。 若要刪除目前會話中的所有 PSSessions，請輸入
Get-PSSession | Remove-PSSession。 -
PSSession 會使用遠端電腦的持續性連線。 建立 PSSession，以執行一系列共享數據的命令。 如需詳細資訊，請輸入
Get-Help about_PSSessions。 - PSSessions 是目前會話特有的。 當您結束會話時，您在該會話中建立的 PSSessions 會被強制關閉。