Query user

Applies To: Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1, Windows Server 2003 with SP2

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

See Also

Concepts

Command-line reference A-Z
Command shell overview
Query session
Terminal Services commands