Cómo utilizar Logevent.exe para registrar los sucesos de un archivo por lotes

Seleccione idioma Seleccione idioma
Id. de artículo: 131008 - Ver los productos a los que se aplica este artículo
Expandir todo | Contraer todo

En esta página

Resumen

Logevent.exe, una utilidad de línea de comandos, puede utilizarse para registrar un identificador de evento proporcionado por el usuario en el registro de eventos de aplicación. Esto permite al usuario registrar errores y datos informativos desde archivos por lotes, secuencias de comandos de inicio de sesión y Monitor. El registro de sucesos de aplicación después se pueda ver y manipular con las herramientas estándar que se utilizan para trabajar con registros de sucesos.

En Windows NT 4.0, LOGEVENT también puede utilizarse para realizar entradas en el registro de sucesos de Windows NT en un equipo local o remoto. Resulta especialmente útil para almacenar información histórica de la ejecución de programas por lotes ejecutar desde secuencias de comandos de inicio de sesión o el comando AT. Su capacidad para almacenar entradas en el registro de sucesos de otros equipos permite este datos se recopilan de forma centralizada, si es necesario.

Más información

Windows NT 3.51

Instalar Logevent.exe copiarlo en el directorio % SystemRoot%\System32.

LOGEVENT requiere que se puede modificar el registro con una clave adicional. Ejecutar LOGEVENT sin parámetros para crear la clave requerida en el registro. Se creará la siguiente clave:
   \HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\EventLog
   \Application\CommandLog
				

y creará los siguientes valores en esta clave:
   EventMessageFile
   TypesSupported
				

Todos los sucesos registrados por LOGEVENT mostrará CommandLog como el origen del evento cuando se ve en Visor de sucesos.

La sintaxis del comando Logevent.exe es:
LOGEVENT xxxxx cadena1 cadena2 string3 string4 string5

donde xxxxx es el identificador de evento que desea registrar (en decimal) y cadena1 mediante string5 son cadenas de inserción de 1 a 5

Si LOGEVENT se ejecuta sin parámetros creará la clave requerida en el registro (como se ha descrito anteriormente). Si se ejecuta sin parámetros y la clave del registro ya existe se asignará el siguiente uso:
 [e:\ntbin]logevent
   Usage: LogEvent xxxx string1 string2 string3 string4 string5
   Where xxxx = numeric ID and stringX is "multiple word string" | single_word
				

Sólo se permiten cadenas de inserción 5, pero esto debería ser suficiente para la mayoría de las aplicaciones porque el doble de la oferta carácter ("") puede utilizarse para pasar tanta información como sea necesario en una sola cadena. El caso donde las cadenas adicionales son útiles es donde las variables de entorno se pasarán como parámetros desde un archivo por lotes. El suceso siempre se debe proporcionar en caso contrario, la utilidad proporcionará el uso del comando y se cerrará sin registro nada en el registro.

Por ejemplo, se podría utilizar LOGEVENT desde un archivo por lotes para informar de la ejecución correcta de un comando y registrar en el registro de sucesos de aplicación con los comandos de ejemplo siguientes:
   LOGEVENT 9876 "program failure in batch file" %0
      (to report failure of program execution from a batch file)
				

   LOGEVENT 1234 "Program CAPTURE.EXE" "ran successfully to completion"
      (from the batch file after successful execution of the program)
				

   LOGEVENT 2222 "Program failed for user" %USERNAME% "with a path of" %PATH%
      (from a batch file showing use of environment variables)
				

Otro ejemplo es el uso de LOGEVENT desde el Monitor de rendimiento. Si se ha configurado PerfMon para generar alertas, es posible que estas alertas que se registran en el registro de sucesos. Sin embargo, la versión actual de PerfMon registra todos los sucesos generados por una alerta como el mismo ID de evento en el registro de sucesos de aplicación. Si varias alertas se supervisa el evento que ID en el registro no puede utilizarse para distinguir qué alerta provocó el evento (aunque los detalles para el evento mostrará esta información).

Si se utiliza la característica NVAlert del servidor SNA para pasar estas alertas en NetView (mainframe) es necesario poder utilizar su identificador para distinguir qué alerta genera el evento en el registro. Mediante LOGEVENT es posible hacerlo. Por ejemplo, desde PerfMon, podría configurar la alerta que desea supervisar y, a continuación, se coloca en el comando siguiente que se va a ejecutar cuando se desencadene la alerta:
   LOGEVENT 2001 "Alert generated from Perfmon" "disk usage on D: exceeded 70%%"
				

Cuando ver el registro de sucesos para esta ejemplo, verá lo siguiente:
   Date:      4/13/95      Event ID:  2001
   Time:      9:16:40 AM   Source:    CommandLog
   User:      N/A          Type:      Information
   Computer:  SPYMASTER    Category:  None
				

   Description:
   The description for Event ID ( 2001 ) in Source ( CommandLog ) could not
   be found. It contains the following insertion string(s): Alert generated
   from  Perfmon, disk usage on D: exceeded 70%.
				

Primero se pasarán las cadenas que se proporcionan y, a continuación, se pasarán los parámetros proporcionados por PerfMon. Los parámetros pasados desde PerfMon realmente están igual a la información registrada para PerfMon propio. Si se registrarán en el uso de registro de sucesos de la misma línea como el anterior pero colocar todos los parámetros pasados desde PerfMon, "(coma y comilla doble) o, (coma) en el extremo de la línea (para NT 3.5 y NT 3.51 respectivamente). En este caso se deben pasar sólo cadenas de inserción de 1-4 junto con el "o, en el extremo. Por ejemplo:
   LOGEVENT 2001 "Alert generated from Perfmon" "disk usage on D: exceeded 70%%"
				

pasará los 2 stings proporcionados a LOGEVENT y, a continuación, pasará todo de la información de rendimiento como cadena de inserción 3. Tenga en cuenta la coma (,) al final de la línea (Esto es para NT 3.51). Para NT 3.1 o NT 3.5 utilice, "caracteres.

Como visto en el registro de sucesos, se notificará que no se encontró la descripción para este ID de evento. Esto es porque no hay ningún archivo que contiene las cadenas de descripción Logevent.exe puesto que no hay ninguna manera de saber qué identificadores de suceso en el usuario se puede colocar en el registro de sucesos. El propio programa Logevent.exe apuntará EventMessageFile en el registro. Sin embargo, esto es simplemente una entrada de marcador de posición en el registro que Logevent.exe no contenga las cadenas de descripción.

Los identificadores de sucesos registra realmente le sólo tienen significado para el usuario o aplicación que va a supervisar el registro de sucesos (como NV alerta). Además, en este ejemplo el %% es necesaria para el % aparezca en el registro de sucesos (Esto es debido el significado especial del carácter % en el tratamiento de cadena de inserción).

Además, porque estos eventos se generan por el usuario, se pensó que es suficiente poner en el registro como sólo los mensajes de tipo de información. Actualmente no hay forma (o necesario) para registrar eventos de tipo advertencia o error mediante esta utilidad.

Windows NT 4.0

Para permitir que el Visor de registro de sucesos para mostrar correctamente la entrada, la aplicación debe instalarse en el equipo se utiliza para ver el registro de sucesos. Instalación se realiza automáticamente cuando se utiliza el programa LOGEVENT por primera vez.

La sintaxis de Logevent.exe es:
   LOGEVENT [-m \\MACHINENAME] [-s SIWEF] [-c CategoryNumber] "Event Text"
   Severity is one of (S)uccess, (I)nformation, (W)arning, (E)rror or
   (F)ailure.
				

Propiedades

Id. de artículo: 131008 - Última revisión: miércoles, 1 de noviembre de 2006 - Versión: 1.2
La información de este artículo se refiere a:
  • Microsoft Windows NT Workstation 3.51
  • Microsoft Windows NT Workstation 4.0 Developer Edition
  • Microsoft Windows NT Server 3.51
  • Microsoft Windows NT Server 4.0 Standard Edition
Palabras clave: 
kbmt kbinfo kbnetwork KB131008 KbMtes
Traducción automática
IMPORTANTE: Este artículo ha sido traducido por un software de traducción automática de Microsoft (http://support.microsoft.com/gp/mtdetails) en lugar de un traductor humano. Microsoft le ofrece artículos traducidos por un traductor humano y artículos traducidos automáticamente para que tenga acceso en su propio idioma a todos los artículos de nuestra base de conocimientos (Knowledge Base). Sin embargo, los artículos traducidos automáticamente pueden contener errores en el vocabulario, la sintaxis o la gramática, como los que un extranjero podría cometer al hablar el idioma. Microsoft no se hace responsable de cualquier imprecisión, error o daño ocasionado por una mala traducción del contenido o como consecuencia de su utilización por nuestros clientes. Microsoft suele actualizar el software de traducción frecuentemente.
Haga clic aquí para ver el artículo original (en inglés): 131008

Enviar comentarios

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com