PowerShell Logo Small

Disconnect-RDUser



This is the built-in help made by Microsoft for the command 'Disconnect-RDUser', in PowerShell version 5 - as retrieved from Windows version 'Microsoft Windows Server 2012 R2 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Disconnects a user from a session that runs on a remote server.

SYNTAX


Disconnect-RDUser [-HostServer] <String> [-UnifiedSessionID] <Int32> [-Force] [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Disconnect-RDUser cmdlet disconnects a specified user from a session that runs on the remote server. All applications continue to run.


Use the Invoke-RDUserLogoff cmdlet to end a session and close running applications.


Use the Get-RDUserSessioncmdlet to retrieve the value for the user session ID. Because the user session ID is unique only within the context of a session host, a different
session host server can share the same user session ID. The host server and session ID that you specify in this cmdlet uniquely identify a session within a deployment.



<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?LinkId=294207
Get-RDUserSession
Invoke-RDUserLogoff
Send-RDUserMessage

REMARKS

<

Examples


Example 1: Disconnect a User from a session on an RD Session Host Server

PS C:\> Disconnect-RDUser -HostServer sessionhost.contoso.com -UnifiedSessionID 2



This command disconnects the user connected to session 2 on the host server sessionhost.contoso.com.