Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Applies To: Windows Vista, Windows Server 2008, Windows Server 2012, Windows 8
Create an API tracing data collector.
For examples of how this command can be used, see Examples.
Syntax
logman create api <[-n] <name>> [options]
Parameters
Parameter |
Description |
|---|---|
/? |
Displays context-sensitive help. |
-s <computer name> |
Perform the command on the specified remote computer. |
-config <value> |
Specifies the settings file containing command options. |
[-n] <name> |
Name of the target object. |
-f <bin|bincirc|csv|tsv|sql> |
Specifies the log format for the data collector. |
-[-]u <user [password]> |
Specifies the user to Run As. Entering a * for the password produces a prompt for the password. The password is not displayed when you type it at the password prompt. |
-m <[start] [stop] [[start] [stop] [...]]> |
Change to manual start or stop instead of a scheduled begin or end time. |
-rf <[[hh:]mm:]ss> |
Run the data collector for the specified period of time. |
-b <M/d/yyyy h:mm:ss[AM|PM]> |
Begin collecting data at the specified time. |
-e <M/d/yyyy h:mm:ss[AM|PM]> |
End data collection at the specified time. |
-si <[[hh:]mm:]ss> |
Specifies the sample interval for performance counter data collectors. |
-o <path|dsn!log> |
Specifies the output log file or the DSN and log set name in a SQL database. |
-[-]r |
Repeat the data collector daily at the specified begin and end times. |
-[-]a |
Append to an existing log file. |
-[-]ow |
Overwrite an existing log file. |
-[-]v <nnnnnn|mmddhhmm> |
Attach file versioning information to the end of the log file name. |
-[-]rc <task> |
Run the command specified each time the log is closed. |
-[-]max <value> |
Maximum log file size in MB or maximum number of records for SQL logs. |
-[-]cnf <[[hh:]mm:]ss> |
When time is specified, create a new file when the specified time has elapsed. When time is not specified, create a new file when the maximum size is exceeded. |
-y |
Answer yes to all questions without prompting. |
-mods <path [path [...]]> |
Specifies the list of modules to log API calls from. |
-inapis <module!api [module!api [...]]> |
Specifies the list of API calls to include in logging. |
-exapis <module!api [module!api [...]]> |
Specifies the list of API calls to exclude from logging. |
-[-]ano |
Log (-ano) API names only, or do not log only (--ano) API names. |
-[-]recursive |
Log (-recursive) or do not log (--recursive) APIs recursively beyond the first layer. |
-exe <value> |
Specifies the full path to an executable for API Tracing. |
Remarks
Where [-] is listed, an extra - negates the option.
Examples
The following command creates an API trace counter called trace_notepad for the executable file c:\windows\notepad.exe and outputs the results to the file c:\notepad.etl.
logman create api trace_notepad -exe c:\windows\notepad.exe -o c:\notepad.etl
The following command creates an API trace counter called trace_notepad for the executable file c:\windows\notepad.exe collecting values produced by the module c:\windows\system32\advapi32.dll.
logman create api trace_notepad -exe c:\windows\notepad.exe -mods c:\windows\system32\advapi32.dll
The following command creates an API trace counter called trace_notepad for the executable file c:\windows\notepad.exe excluding the API call TlsGetValue produced by the module kernel32.dll.
logman create api trace_notepad -exe c:\windows\notepad.exe -exapis kernel32.dll!TlsGetValue