logman create api
Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2 y Windows Server 2012.
Crea un recopilador de datos de seguimiento de API.
Sintaxis
logman create api <[-n] <name>> [options]
Parámetros
| Parámetro | Descripción |
|---|---|
-s <computer name> |
Ejecuta el comando en el equipo remoto especificado. |
-config <value> |
Especifica el archivo de configuración que contiene las opciones de comando. |
[-n] <name> |
Nombre del objeto de destino. |
-f <bin|bincirc> |
Especifica el formato de registro para el recopilador de datos. |
-[-]u <user [password]> |
Especifica el usuario para Ejecutar como. Si se escribe un * como contraseña, se genera un mensaje para la contraseña. La contraseña no se muestra cuando se escribe en la solicitud de contraseña. |
-m <[start] [stop] [[start] [stop] [...]]> |
Cambia a un inicio o parada manual en lugar de una hora de inicio o finalización programadas. |
-rf <[[hh:]mm:]ss> |
Ejecuta el recopilador de datos durante el período de tiempo especificado. |
-b <M/d/yyyy h:mm:ss[AM|PM]> |
Comienza a recopilar datos en el momento especificado. |
-e <M/d/yyyy h:mm:ss[AM|PM]> |
Finaliza la recopilación de datos en el momento especificado. |
-si <[[hh:]mm:]ss> |
Especifica el intervalo de ejemplo para los recopiladores de datos del contador de rendimiento. |
-o <path|dsn!log> |
Especifica el archivo de registro de salida o el nombre del conjunto de registros y DSN en una base de datos SQL. |
| -[-]r | Repite el recopilador de datos diariamente en las horas de inicio y finalización especificadas. |
| -[-]a | Anexa un archivo de registro existente. |
| -[-]ow | Sobrescribe un archivo de registro existente. |
-[-]v <nnnnnn|mmddhhmm> |
Adjunta información de control de versiones de archivos al final del nombre del archivo de registro. |
-[-]rc <task> |
Ejecuta el comando especificado cada vez que se cierra el registro. |
-[-]max <value> |
Tamaño máximo del archivo de registro en MB o número máximo de registros para los registros de SQL. |
-[-]cnf <[[hh:]mm:]ss> |
Cuando se especifica la hora, crea un nuevo archivo cuando ha transcurrido el tiempo especificado. Cuando no se especifica la hora, crea un nuevo archivo cuando se supera el tamaño máximo. |
| -y | Responder sí a todas las preguntas sin preguntar. |
-mods <path [path [...]]> |
Especifica la lista de módulos desde los que se van a registrar las llamadas API. |
-inapis <module!api [module!api [...]]> |
Especifica la lista de llamadas API que se van a incluir en el registro. |
-exapis <module!api [module!api [...]]> |
Especifica la lista de llamadas API que se van a excluir del registro. |
| -[-]ano | Registra (-ano) solo nombres de API o no registra (-ano) solo nombres de API. |
| -[-]recursive | Registra (-recursive) o no registra (-recursive) de forma recursiva más allá de la primera capa. |
-exe <value> |
Especifica la ruta de acceso completa a un archivo ejecutable para el seguimiento de API. |
| /? | Muestra ayuda contextual. |
Comentarios
- Cuando [-] aparece en la lista, al agregar un guion adicional (-) se niega la opción.
Ejemplos
Para crear un contador de seguimiento de API denominado trace_notepad para el archivo ejecutable c:\windows\notepad.exe y colocar los resultados en el archivo c:\notepad.etl, escriba:
logman create api trace_notepad -exe c:\windows\notepad.exe -o c:\notepad.etl
Para crear un contador de seguimiento de API denominado trace_notepad para el archivo ejecutable c:\windows\notepad.exe y recopilar valores generados por el módulo en c:\windows\system32\advapi32.dll, escriba:
logman create api trace_notepad -exe c:\windows\notepad.exe -mods c:\windows\system32\advapi32.dll
Para actualizar un contador de seguimiento de API existente denominado trace_notepad para el archivo ejecutable c:\windows\notepad.exe y excluir la llamada API TlsGetValue generada por el módulo kernel32.dll, escriba:
logman create api trace_notepad -exe c:\windows\notepad.exe -exapis kernel32.dll!TlsGetValue