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.


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

  • 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.
  • 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.


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

Format Meaning


Information that the user must supply


Elements that the user must type exactly as shown

Ellipsis (...)

Parameter that can be repeated several times in a command line

Between brackets ([])

Optional items

Between braces ({}); choices separated by pipe (|). Example: {even|odd}

Set of choices from which the user must choose only one

Courier font

Code or program output

See Also


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