Query user

Displays information about user sessions on a terminal server.

Syntax

query user [{UserName|SessionName|SessionID}] [**/server:**ServerName]

Parameters

UserName   : Specifies the logon name of the user you want to query.

SessionName   : Specifies the name of the session you want to query.

SessionID   : Specifies the ID of the session you want to query.

/server: ServerName   : Specifies the terminal server you want to query. Otherwise, the current terminal 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 terminal server. Query user returns the following information:

  • The name of the user

  • The name of the session on the terminal 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 a user name, session name, or session ID, 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 less 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

Formatting legend

Command-line reference A-Z

Query session

Terminal Services commands