Computer and Software Support


Query User

This page is from Microsoft

Updated: January 21, 2005

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

Format Meaning
Italic Information that the user must supply
Bold 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