Eventquery.vbs

Lists the events and event properties from one or more event logs.

Syntax

eventquery[.vbs] [/s Computer [/u Domain\User [/p Password]]] [/fi FilterName] [/fo {TABLE|LIST|CSV}] [/r EventRange [/nh] [/v] [/l [APPLICATION] [SYSTEM] [SECURITY] ["DNS server"] [UserDefinedLog] [DirectoryLogName] [*] ]

Parameters

/s   Computer   : Specifies the name or IP address of a remote computer (do not use backslashes). The default is the local computer.

/u   Domain \ User   : Runs the script with the account permissions of the user specified by User or Domain\User. The default is the permissions of the current logged on user on the computer issuing the command.

/p   Password   : Specifies the password of the user account that is specified in the /u parameter.

/fi   FilterName   : Specifies the types of events to include in or exclude from the query. To find events with either value, Type and ID can be used together in a single syntax statement by using the or operator.The following are valid filter names, operators, and values.

Name

Operator

Value

Datetime

eq, ne, ge, le, gt, lt

mm/dd/yy(yyyy), hh:mm:ssAM(/PM)

Type

eq, ne, or

{ERROR|INFORMATION|WARNING|SUCCESSAUDIT|FAILUREAUDIT}

ID

eq, ne, or, ge, le, gt, lt

Any valid positive integer.

User

eq, ne

Any valid string.

Computer

eq, ne

Any valid string.

Source

eq, ne

Any valid string.

Category

eq, ne

Any valid string

/fo { TABLE | LIST | CSV } : Specifies the format to use for the output. Valid values are table, list, and csv.

/r   EventRange   : Specifies the range of events to list.

Value

Description

N

Lists N most recent events.

-N

Lists N oldest events.

N1-N2

Lists the events from N1 to N2.

/nh   : Suppresses column headers in the output. Valid only for table and csv formats.

/v   : Specifies that verbose event information be displayed in the output.

/l [ APPLICATION ] [ SYSTEM ] [ SECURITY ] [ "DNS server" ] [ UserDefinedLog ] [ DirectoryLogName ] [ * ] ] : Specifies the log(s) to monitor. Valid values are Application, System, Security, "DNS server", a user-defined log, and Directory log. "DNS server" can be used only if the DNS service is running on the computer specified by the /s parameter. To specify more than one log to monitor, reuse the /l parameter. The wildcard (*) can be used and is the default.

/? : Displays help at the command prompt.

Remarks

  • To run this script, you must be running CScript. If you have not already set the default Windows Script Host to CScript, type:

    cscript //h:cscript //s //nologo

Examples

The following examples show how you can use the eventquery command:

eventquery /l system
eventquery /l mylog
eventquery /l application /l system
eventquery /s srvmain /u maindom\hiropln /p p@ssW23 /v /l *
eventquery /r 10 /l application /nh
eventquery /r -10 /fo LIST /l security
eventquery /r 5-10 /l "DNS server"
eventquery /fi "Type eq Error" /l application
eventquery /fi "Datetime eq 06/25/00,03:15:00AM/06/25/00,03:15:00PM" /l application
eventquery /fi "Datetime gt 08/03/00,06:20:00PM" /fi "id gt 700" /fi "Type eq warning" /l system   eventquery /fi "ID eq 1000 OR ID ge 4500"   eventquery /fi "Type eq error OR Type eq INFORMATION"   eventquery /fi "ID eq 250 OR Type eq ERROR"

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

Command-line reference A-Z

Using the command-based script host (CScript.exe)