Windows IT Pro is the leading independent community for IT professionals deploying Microsoft Windows server and client applications and technologies.
  
  
  Advanced Search 


September 2007

Create Custom Events with a Single Command

RSS
Subscribe to Windows IT Pro | See More Systems Administration Articles Here | Reprints | Or get the Monthly Online Pass—only $5.95 a month!

Executive Summary:
The Windows Event Viewer is a tool that can provide you with useful information regarding your computer's health. Although many events are logged in the Windows Event Viewer, it's sometimes useful to create and log custom events. Using the Windows Eventcreate command, you can easily create and log custom events.


The Windows Event Viewer is a tool that can provide you with useful information regarding your computer's health. It contains at least three logs: the Application log (which contains events generated by applications), the Security log (which contains security-related events generated by Windows), and the System log (which contains system-wide events generated by Windows). Each log displays Information, Warning, and Error events, which are accompanied by the name of the source component that raised the event, a brief event description, and an event ID. Administrators rely on these logs not only for information about problems (e.g., failure to start a service) but also for information about successful operations (e.g., successful RAS connections).

Sometimes it's useful to log your own events. For example, I have a startup script that I've scheduled to run every night. I recently found a way to log its events so that I could make sure it was successfully executing. You can log events by using the Eventcreate command. The basic syntax that I use is:

Eventcreate /ID EventID 
  /L LogName /T Type 
/SO Source /D Description 

where

  • EventID is the ID you want to give the event. You can use any number from 1 to 1000.
  • LogName is the name of the log to which you want to write the event. You can write to the Application or System log but not the Security log.
  • Type defines the severity of the event. You can specify Information, Warning, or Error.
  • Source specifies the component (e.g., application, script) generating the event.
  • Description is the text you want displayed when the event appears in the log.

For example, I created the following event to be logged whenever my startup script successfully executes. Note that this command has to be entered inside the startup script:

Eventcreate /ID 123 
  /L Application /T Information
  /SO StartupScript 
/D "Startup script executed!"

You can even write events to a log on another computer by using the eventcreate command's /S Computer parameter (where Computer is the machine's name). If you need to specify alternate credentials for the remote-computer, you can use the /U User and /P Password parameters (where User and Password are the credentials). For information about these three parameters, open a command prompt and type

eventcreate /? 

The Eventcreate command works on Windows Server 2003 and Windows XP. I haven't tested it on any other OSs.

End of Article



Reader Comments

You must be a registered user or online subscriber to comment on this article. Please log on before posting a comment. Are you a new visitor? Register now




Top Viewed ArticlesView all articles
Command Prompt Tricks

One reader shares his tip for setting up the command prompt to reflect a remote path. ...

WinInfo Short Takes: Week of November 23, 2009

An often irreverent look at some of the week's other news, including some post-PDC some soul searching, a Google Chrome OS announcement and a Microsoft response, Windows 7 off to a supposedly strong start, the Jonas Brothers and Xbox 360, and so much more ...

2009 Windows IT Pro Editors' Best and Community Choice Awards

Picking a favorite product from an impressive crowd of competitive offerings is never an easy task, and such was the case with our Editors' Best and Community Choice awards this year. ...


Related Events Deep Dive into Windows Server 2008 R2 presented by John Savill

The Easiest Way to Save Time and Money on E-mail and SharePoint Management

7 Ways To Get More From Your SharePoint Deployment Now

Check out our list of Free Email Newsletters!

Windows OSs eBooks Understanding and Leveraging Code Signing Technologies

A Guide to Windows Certification and Public Keys

SQL Server Administration for Oracle DBAs

Related Windows OSs Resources Introducing Left-Brain.com, the online IT bookstore
Looking for books, CDs, toolkits, eBooks? Prime your mind at Left-Brain.com

Discover Windows IT Pro eLearning Series!
Clear & detailed technical information and helpful how-to's, all in our trademark no-nonsense format


Windows IT Pro Home Register FAQ for Windows WinInfo News
Europe Edition About Us Contact Us/Customer Service Media Kit Affiliates / Licensing  
SQL Server Magazine Office & SharePoint Pro DevProConnections IT Job Hound
Left-Brain.com Technology Resource Directory asp.netPRO ITTV Windows SuperSite 
 
 Windows IT Pro is a Division of Penton Media Inc.
 © 2009 Penton Media, Inc. Terms of Use | Privacy Statement