Remove-PSSession

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

The Remove-PSSession cmdlet closes Windows PowerShell sessions ( PSSessions ) in the current session. It stops any commands that are running in the PSSessions , ends the PSSession , and releases the resources that the PSSession was using. If the PSSession is connected to a remote computer, this cmdlet also closes the connection between the local and remote computers.

To remove a PSSession , enter the Name , ComputerName , ID , or InstanceID of the session.

If you have saved the PSSession in a variable, the session object remains in the variable, but the state of the PSSession is Closed.

Examples

Example 1: Remove sessions by using IDs

PS C:\> Remove-PSSession -Id 1, 2

This command removes the PSSessions that have IDs 1 and 2.

Example 2: Remove all the sessions in the current session

PS C:\> Get-PSSession | Remove-PSSession



- or -



PS C:\> Remove-PSSession -Session (Get-PSSession)



- or -



PS C:\> $s = Get-PSSession

PS C:\> Remove-PSSession -Session $s

These commands remove all of the PSSessions in the current session. Although the three command formats look different, they have the same effect.

Example 3: Close sessions by using names

PS C:\> $r = Get-PSSession -ComputerName Serv*

PS C:\> $r | Remove-PSSession

These commands close the PSSessions that are connected to computers that have names that begin with Serv.

Example 4: Close sessions connected to a port

PS C:\> Get-PSSession | where {$_.port -eq 90} | Remove-PSSession

This command closes the PSSessions that are connected to port 90. You can use this command format to identify PSSessions by properties other than ComputerName , Name , InstanceID , and ID .

Example 5: Close a session based on instance ID

PS C:\> 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

These commands show how to close a PSSession based on its instance ID, or RemoteRunspaceID .

The first command uses the Get-PSSession cmdlet to get the PSSessions in the current session. It uses a pipeline operator (|) to send the PSSessions to the Format-Table cmdlet, which formats their ComputerName and InstanceID properties in a table. The AutoSize parameter compresses the columns for display.

From the resulting display, you can identify the PSSession to be closed, and copy and paste the InstanceID of that PSSession into the second command.

The second command uses the Remove-PSSession cmdlet to remove the PSSession with the specified instance ID.

Example 6: Create a function that deletes all sessions in the current session

PS C:\> Function EndPSS { Get-PSSession | Remove-PSSession }

This function deletes all of the PSSessions in the current session. After you add this function to your Windows PowerShell profile, to delete all sessions, type EndPSS .

Required Parameters

Optional Parameters

Inputs

System.Management.Automation.Runspaces.PSSession

You can pipe a session object to this cmdlet.

Outputs

None

This cmdlet does not return any objects.

Notes

• The Id parameter is mandatory. To delete all the PSSessions in the current session, type Get-PSSession | Remove-PSSession .
• A PSSession uses a persistent connection to a remote computer. Create a PSSession to run a series of commands that share data. For more information, type Get-Help about_PSSessions .
• PSSessions are specific to the current session. When you end a session, the PSSessions that you created in that session are forcibly closed.

Related Links

• Connect-PSSession
• Disconnect-PSSession
• Enter-PSSession
• Exit-PSSession
• Get-PSSession
• Invoke-Command
• New-PSSession
• Receive-PSSession