VSPerfCmd

O VSPerfCmd.exe ferramenta é usada para iniciar e interromper a coleta de dados de desempenho.Ela usa a sintaxe a seguir:

VSPerfCmd [/U] [/options]

As tabelas a seguir descrevem VSPerfCmd.exe opções de ferramenta.

Opção	Descrição
U	A saída redirecionada do console está escrito como Unicode.Devem ser a primeira opção especificada.
Iniciar:mode	Inicia o serviço de criação de perfil no modo especificado.
Saída:filename	Especifica o nome do arquivo de saída.Use somente com Start.
CrossSession|CS	Permite o perfil em sessões do Windows.Use only with Start, Attach, or Launch.
User:domain\username	Permite o acesso da conta especificada para o serviço do profiler.Use somente com Start.
WaitStart[:n]	Aguarda a coleção dados do agente de log se inicializar.Se n for especificado, VSPerfCmd aguardará no máximo n segundos.Se n não for especificado, VSPerfCmd aguardará indefinidamente.Isso facilitará o uso de VSPerfCmd como parte de um processo em lotes.
Contador:cfg	Quando o método de criação de perfil de exemplo é usado, especifica um contador de CPU e o número de eventos para usar como o intervalo de amostragem.Você pode obter amostra apenas um valor de contador. Quando é usada a método de criação de perfil de instrumentação, especifica um contador de CPU a serem coletados em cada ponto de instrumentação.Use only with Start:Trace, Attach,or Launch.
QueryCounters	Exibe uma lista de contadores de CPU válido na máquina atual.
WinCounter:caminho	Especifica um evento de contador de desempenho do Windows para incluir dados de marca de perfil.Use somente com Start.
Com AutoMarcação:n	Especifica o intervalo de tempo (em milissegundos) entre eventos de coleta de dados do contador de desempenho Windows.Use with WinCounter.
Eventos:option	Coleção de controles de eventos de rastreamento de eventos para Windows (ETW) especificados.Dados ETW são coletados para um arquivo de .itl que não é o arquivo de dados (Vsp) de criação de perfil.
Status	Exibe o estado do profiler, informações sobre processos que estão atualmente sendo perfilados e contas que têm autoridade para controlar o profiler.
Desligamento[:n]	Fecha o arquivo de dados de criação de perfil e desativa o profiler.
GlobalOn	Reinicia a coleta de dados após uma chamada para VSPerfCmdGlobalOff.
GlobalOff	Pára a coleta de todos os dados, mas não termina a sessão de criação de perfil.
ProcessOn:pid	Reinicia a coleta de dados para o processo especificado após a criação de perfil foi interrompida por uma chamada para VSPerfCmdProcessOff.
ProcessOff:pid	Pára a coleta de dados para o processo especificado.
ThreadOn e ThreadOff:TID	Reinicia o profiling para o processo especificado após a criação de perfil foi interrompida por uma chamada para VSPerfCmdThreadOff.Use ThreadOn somente ao criar o perfil com o método de instrumentação.
ThreadOn e ThreadOff:TID	Pausa a criação de perfil para o segmento especificado.Use ThreadOff somente ao criar o perfil com o método de instrumentação.
Marca:MarkNum[,MarkText]	Insere uma marca para o arquivo de dados de criação de perfil, com um texto opcional.

Opções de método de amostragem

As seguintes opções estão disponíveis apenas quando você estiver usando a método de criação de perfil de amostragem.

Opção	Descrição
Lançamento:Executável	Inicia o aplicativo especificado e começa a criação de perfil.
Args:Argumentos	Especifica os argumentos de linha de comando para passar para o aplicativo iniciado.
Console	Inicia o comando especificado em uma nova janela do prompt de comando.
Anexar:PID,PID	Inicia os processos especificados de criação de perfil.Processos podem ser identificados pelo id do processo ou o nome do processo.
Desanexar:PID,PID]	Pára o profiling os processos especificados.Processos podem ser identificados pelo id do processo ou o nome do processo.Se nenhum processo for especificado, a criação de perfil é interrompida para todos os processos.
GC[:{Allocation|Lifetime}]	Coleta.NET alocação e object lifetime dados da memória.Use somente com o VSPerfCmdLaunch opção.

Opções de intervalo de amostragem

As seguintes opções de especificam o tipo e a duração de intervalos de amostragem.O padrão é Timer.Você também pode especificar um contador de CPU como o intervalo usando o Counter opção.Essas opções só podem ser especificadas com Launch ou com o primeiro Attach de uma sessão de criação de perfil.

Opção	Descrição
PF:n	Exemplos em cada enésima falha de página (padrão = 10).
Sys (VSPerfCmd):n	Exemplos em cada enésima chamada do sistema (Padrão = 10).
Timer:n	Amostras em cada processador enésima ciclo (padrão = 10000000).

Componente de serviço e opções do dispositivo de modo de Kernel

As seguintes opções de administração oferecem suporte a componentes de criação de perfil de serviços ou drivers de dispositivo de modo de kernel.As opções do administrador definir permissões de criação de perfil e controlam com perfil de serviço ou driver de dispositivo.

Opções de administração devem ser executadas em um prompt de comando que está sendo executado com credenciais administrativas.

Opção	Descrição
Admin:Security <ALLOW|DENY> RightRight<User|Grupo>	Permite ou nega o usuário especificado ou o grupo acesso a serviços de perfil. Rightpode ser: CrossSession - dá ao usuário acesso ao serviço para cruzar a sessão de criação de perfil. SampleProfiling - dá ao usuário acesso ao driver para habilitar a criação de perfil de amostragem.Também é usado para acessar as informações de transição do kernel durante a criação de perfil de rastreamento. FullAccess - dá ao usuário acesso CrossSession e o SampleProfiling.
Admin:Security, List	Lista o estado atual dos serviços de criação de perfil e listas de permissões de usuário.
Admin:<Service|Driver><START|STOP|INSTALL|UNINSTALL>	Inicia, pára, instala ou desinstala o componente do serviço de criação de perfil (serviço) ou um driver de dispositivo de modo kernel (driver).
Admin:<Service|Driver>AutoStart<ON|OFF>	Habilita ou desabilita a inicie automaticamente a criação de perfil (serviço) ou um driver de dispositivo de modo kernel (driver) após uma reinicialização.

VSPerfCmd /Driver

O VSPerfCmd /Driver opção é agora obsoleta.Use o VsPerfCmdAdmin opções para essa funcionalidade.

Consulte também

Referência

VSInstr

VSPerfMon

VSPerfReport