logman update api
Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2 e Windows Server 2012
Atualiza as propriedades de um coletor de dados de rastreamento de API existente.
Sintaxe
logman update api <[-n] <name>> [options]
Parâmetros
| Parâmetro | Descrição |
|---|---|
-s <computer name> |
Executa o comando no computador remoto especificado. |
-config <value> |
Especifica o arquivo de configurações que contém as opções de comando. |
[-n] <name> |
O nome do objeto de destino. |
-f <bin|bincirc> |
Especifica o formato de log para o coletor de dados. |
-[-]u <user [password]> |
Especifica o usuário para Executar como. Inserir um * da senha produz um prompt para a senha. A senha não é exibida quando você a digita no prompt de senha. |
-m <[start] [stop] [[start] [stop] [...]]> |
Alterado para iniciar ou parar manualmente em vez de em uma hora de início ou término agendada. |
-rf <[[hh:]mm:]ss> |
Executa o coletor de dados no período de tempo especificado. |
-b <M/d/yyyy h:mm:ss[AM|PM]> |
Inicia a coleta de dados no momento especificado. |
-e <M/d/yyyy h:mm:ss[AM|PM]> |
Encerra a coleta de dados no momento especificado. |
-si <[[hh:]mm:]ss> |
Especifica o intervalo de amostra para os coletores de dados do contador de desempenho. |
-o <path|dsn!log> |
Especifica o arquivo de log de saída ou o DSN e o nome do conjunto de logs em um banco de dados SQL. |
| -[-]r | Repete o coletor de dados diariamente nos horários de início e término especificados. |
| -[-]a | Acrescenta um arquivo de log existente. |
| -[-]ow | Substitui um arquivo de log existente. |
-[-]v <nnnnnn|mmddhhmm> |
Anexa informações de controle de versão do arquivo ao final do nome do arquivo de log. |
-[-]rc <task> |
Executa o comando especificado sempre que o log for fechado. |
-[-]max <value> |
O tamanho máximo do arquivo de log em MB ou o número máximo de registros para os logs SQL. |
-[-]cnf <[[hh:]mm:]ss> |
Quando o tempo for especificado, cria-se um arquivo quando esse tempo especificado tiver transcorrido. Quando o tempo não for especificado, cria-se um arquivo quando o tamanho máximo for excedido. |
| -y | Responder sim a todas as perguntas sem solicitar. |
-mods <path [path [...]]> |
Especifica a lista de módulos dos quais as chamadas à API serão registradas. |
-inapis <module!api [module!api [...]]> |
Especifica a lista de chamadas à API a serem incluídas no registro em log. |
-exapis <module!api [module!api [...]]> |
Especifica a lista de chamadas à API a serem excluídas do registro em log. |
| -[-]ano | Registrar somente nomes de API (-ano) ou não registrar apenas nomes de API (-ano). |
| -[-]recursive | Registrar log (-recursivo) ou não registrar APIS (recursivas) recursivamente além da primeira camada. |
-exe <value> |
Especifica o caminho completo para um executável para rastreamento de API. |
| /? | Exibe uma ajuda contextual. |
Comentários
- Onde [-] está listado, adicionar um hífen extra (-) nega a opção.
Exemplos
Para atualizar um contador de rastreamento de API existente chamado trace_notepad, no arquivo executável c:\windows\notepad.exe, excluindo a chamada à API TlsGetValue produzida pelo módulo kernel32.dll, digite:
logman update api trace_notepad -exe c:\windows\notepad.exe -exapis kernel32.dll!TlsGetValue