Query user
Applies To: Windows Vista, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012, Windows 8
Displays information about user sessions on a Remote Desktop Session Host (RD Session Host) server.
For examples of how to use this command, see Examples.
Note
In Windows Server 2008 R2, Terminal Services was renamed Remote Desktop Services. To find out what's new in the latest version, see What’s New in Remote Desktop Services in Windows Server 2012 in the Windows Server TechNet Library.
Syntax
query user [<UserName> | <SessionName> | <SessionID>] [/server:<ServerName>]
Parameters
Parameter |
Description |
---|---|
<UserName> |
Specifies the logon name of the user that you want to query. |
<SessionName> |
Specifies the name of the session that you want to query. |
<SessionID> |
Specifies the ID of the session that you want to query. |
/server:<ServerName> |
Specifies the RD Session Host server that you want to query. Otherwise, the current RD Session Host server is used. |
/? |
Displays help at the command prompt. |
Remarks
You can use this command to find out if a specific user is logged on to a specific RD Session Host server. Query user returns the following information:
The name of the user
The name of the session on the RD Session Host server
The session ID
The state of the session (active or disconnected)
The idle time (the number of minutes since the last keystroke or mouse movement at the session)
The date and time the user logged on
To use query user, you must have Full Control permission or Query Information special access permission.
If you use query user without specifying <UserName>, <SessionName>, or <SessionID>, a list of all users who are logged on to the server is returned. Alternatively, you can also use query session to display a list of all sessions on a server.
When query user returns information, a greater than (>) symbol is displayed before the current session.
The /server parameter is required only if you use query user from a remote server.
Examples
To display information about all users logged on the system, type:
query user
To display information about the user USER1 on server SERVER1, type:
query user USER1 /server:SERVER1
Additional references
Remote Desktop Services (Terminal Services) Command Reference