wevtutil - Inspeccionar registros de eventos
Tabla de contenidos
El comando wevtutil permite ver, exportar y borrar los registros de eventos de Windows desde el símbolo del sistema.
Cuando un equipo se reinicia de repente o una aplicación se cierra, el registro de eventos suele contener pistas sobre la causa. Normalmente se consulta en el Visor de eventos, pero con wevtutil puede extraer solo los eventos que necesita, guardar el resultado en un archivo o investigar automáticamente desde un archivo por lotes.
Sintaxis básica del comando wevtutil
wevtutil <subcomando> [argumentos] [opciones]
El subcomando que se indica primero determina lo que hace el comando. Los más usados son:
| Subcomando | Forma corta | Descripción |
|---|---|---|
enum-logs | el | Muestra la lista de nombres de registros |
query-events | qe | Busca y muestra eventos de un registro |
get-log | gl | Muestra la configuración del registro (tamaño máximo, etc.) |
export-log | epl | Exporta un registro a un archivo |
clear-log | cl | Elimina los eventos de un registro |
Aquí se tratan los principales. Consulte wevtutil /? para el resto.
Listar los registros (el)
Use el para ver qué registros existen.
wevtutil el
Se muestra una lista de varios cientos de líneas. Los tres registros más representativos son:
| Nombre | Contenido |
|---|---|
Application | Eventos registrados por las aplicaciones |
System | Eventos registrados por Windows, los controladores y los servicios |
Security | Eventos de seguridad, como inicios de sesión correctos o fallidos (auditoría) |
Para buscar un registro concreto, canalice la salida a find.
wevtutil el | find "PowerShell"
Mostrar eventos (qe)
Indique un nombre de registro después de qe para mostrar sus eventos.
wevtutil qe System /c:3 /rd:true /f:text
| Opción | Significado |
|---|---|
/c:<n> | Número máximo de eventos que se muestran |
/rd:true | Muestra primero los eventos más recientes (por defecto, los más antiguos) |
/f:text | Muestra en formato de texto legible (por defecto es XML) |
La salida anterior es solo un ejemplo. El contenido de los eventos y los nombres de los campos varían según el estado del equipo y el idioma de visualización del sistema.
Si solo indica /c:, se muestra el número indicado de eventos desde el principio del registro (los más antiguos). Para investigar algo reciente, combínelo siempre con /rd:true.
Filtrar por condición (/q)
Si indica una consulta XPath en la opción /q:, solo se devuelven los eventos que la cumplen.
Filtrar por nivel
Muestra los 5 errores más recientes (nivel 2).
wevtutil qe System /q:"*[System[(Level=2)]]" /c:5 /rd:true /f:text
Los valores de Level son:
| Valor | Nivel |
|---|---|
1 | Crítico |
2 | Error |
3 | Advertencia |
4 | Información |
Para obtener tanto eventos críticos como errores, únalos con or.
wevtutil qe System /q:"*[System[(Level=1 or Level=2)]]" /c:10 /rd:true /f:text
Filtrar por ID de evento
Indique el ID del evento. Por ejemplo, el ID 41 (Kernel-Power) se registra cuando el equipo se reinició sin apagarse correctamente.
wevtutil qe System /q:"*[System[(EventID=41)]]" /c:3 /rd:true /f:text
Filtrar por intervalo de tiempo
timediff(@SystemTime) devuelve el tiempo transcurrido desde que se registró el evento, en milisegundos. Este ejemplo consulta los errores y advertencias de las últimas 24 horas (86 400 000 ms).
wevtutil qe System /q:"*[System[(Level=2 or Level=3) and TimeCreated[timediff(@SystemTime) <= 86400000]]]" /rd:true /f:text
Puede combinar condiciones con and. Intervalos habituales:
| Intervalo | Milisegundos |
|---|---|
| 1 hora | 3600000 |
| 24 horas | 86400000 |
| 7 días | 604800000 |
Filtrar por proveedor
También puede filtrar por el nombre del proveedor que registró el evento. Como toda la consulta va entre ", use ' en su interior.
wevtutil qe System /q:"*[System[Provider[@Name='Microsoft-Windows-Kernel-Power']]]" /c:3 /rd:true /f:text
En el Visor de eventos, defina las condiciones con «Crear vista personalizada» y abra la pestaña «XML» para ver la consulta XPath de esas mismas condiciones. Puede reutilizarla en /q:.
Respaldar un registro (epl)
epl exporta un registro a un archivo .evtx. Puede abrir el archivo exportado en el Visor de eventos.
wevtutil epl System "%USERPROFILE%\Desktop\System-backup.evtx"
Si ya existe un archivo con el mismo nombre, se produce un error. Añada /ow:true para sobrescribirlo.
wevtutil epl System "%USERPROFILE%\Desktop\System-backup.evtx" /ow:true
Para leer un archivo .evtx guardado, añada /lf:true a qe y use la ruta del archivo en lugar del nombre del registro.
wevtutil qe "%USERPROFILE%\Desktop\System-backup.evtx" /lf:true /c:3 /rd:true /f:text
Borrar un registro (cl)
cl elimina todos los eventos de un registro.
wevtutil cl Application
Con /bu:<archivo>, se guarda una copia de seguridad como archivo .evtx antes de borrar el registro.
wevtutil cl Application /bu:"%USERPROFILE%\Desktop\Application-backup.evtx"
Si borra un registro sin copia de seguridad, se pierden también los datos que podría necesitar para investigar un problema. En particular, el registro Security puede tener que conservarse como prueba de auditoría. Antes de ejecutarlo, haga una copia con epl o /bu:.
Cuando se necesitan permisos de administrador
Mostrar System y Application funciona con permisos normales, pero mostrar el registro Security y borrar registros requieren un símbolo del sistema ejecutado como administrador. Si faltan permisos, aparece un error como Access is denied. (Acceso denegado).
Para saber cómo iniciarlo como administrador, consulte
.Uso en archivos por lotes
Este ejemplo guarda en un archivo los errores de las últimas 24 horas.
@echo off
set "OUT=%~dp0recent-errors.txt"
wevtutil qe System /q:"*[System[(Level=1 or Level=2) and TimeCreated[timediff(@SystemTime) <= 86400000]]]" /rd:true /f:text > "%OUT%"
if errorlevel 1 (
echo No se pudo obtener el registro de eventos.
exit /b 1
)
echo Resultado guardado en: %OUT%
> (redirección) escribe la salida en un archivo. %~dp0 representa la carpeta donde está el propio archivo por lotes.
Si ningún evento cumple las condiciones, no se muestra nada, pero no es un error. El archivo de resultado simplemente queda vacío.