Remove-PSSession

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>]

Remove-PSSession コマンドレットは、現在のセッションの PowerShell セッション (PSSessions) を閉じます。 PSSessionsで実行されているコマンドをすべて停止し、PSSessionを終了し、PSSession が使用していたリソースを解放します。 PSSession がリモート コンピューターに接続されている場合、このコマンドレットはローカル コンピューターとリモート コンピューター間の接続も閉じます。

PSSessionを削除するには、セッションの Name、ComputerName、ID、または InstanceID を入力します。

PSSession を変数に保存した場合、セッション オブジェクトは変数に残りますが、PSSession の状態は Closed です。

Remove-PSSession -Id 1, 2

このコマンドは、ID が 1 と 2 の PSSessions を削除します。

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 を閉じます。

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

このコマンドは、ポート 90 に接続されている PSSessions を閉じます。 このコマンド形式を使用すると、ComputerName、Name、InstanceID、ID以外のプロパティによって、PSSessions を識別できます。

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

これらのコマンドは、インスタンス ID に基づいて PSSession を閉じる方法、または RemoteRunspaceID する方法を示しています。

最初のコマンドでは、 Get-PSSession コマンドレットを使用して、現在のセッションの PSSession を取得します。 パイプライン演算子 (|) を使用して PSSessions を Format-Table コマンドレットに送信し、テーブル内の ComputerName プロパティと InstanceID プロパティを書式設定します。 AutoSize パラメーターは、表示する列を圧縮します。

結果の表示から、閉じる PSSession を識別し、その PSSession の InstanceID をコピーして 2 番目のコマンドに貼り付けることができます。

2 番目のコマンドでは、 Remove-PSSession コマンドレットを使用して、指定したインスタンス ID を持つ PSSession を削除します。

Function EndPSS { Get-PSSession | Remove-PSSession }

この関数は、現在のセッション内のすべての PSSessions を削除します。 この関数を PowerShell プロファイルに追加した後、すべてのセッションを削除するには、「EndPSS」と入力します。

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

セッション オブジェクトをこのコマンドレットにパイプできます。

このコマンドレットはオブジェクトを返しません。

• ID パラメーターは必須です。 現在のセッションのすべての PSSessions を削除するには、「Get-PSSession | Remove-PSSession」と入力します。
• PSSession は、リモート コンピューターへの永続的な接続を使用します。 PSSession を作成して、データを共有する一連のコマンドを実行します。 詳細については、「Get-Help about_PSSessions」と入力します。
• PSSessions は、現在のセッションに固有です。 セッションを終了すると、そのセッションで作成した PSSessions が強制的に閉じられます。