WMIC: utilitário de linha de comando WMI

Artigo
08/07/2024

Importante

O WMIC foi preterido a partir de Windows 10, versão 21H1; e e a partir da versão semestral do canal 21H1 do Windows Server. Esse utilitário foi substituído pelo Windows PowerShell para WMI; confira Capítulo 7 – Como trabalhar com o WMI. Essa substituição se aplica apenas ao utilitário WMIC. O WMI (Instrumentação de Gerenciamento do Windows) em si não foi afetado. Confira também os recursos do Windows 10 que não estamos mais desenvolvendo.

O utilitário WMIC (linha de comando WMI) fornece uma interface de linha de comando para a Instrumentação de Gerenciamento do Windows (WMI). O WMIC é compatível com shells e comandos utilitários já existentes. As informações seguintes são um guia de referência geral para o WMIC. Para obter mais informações e diretrizes sobre como usar o WMIC, incluindo informações adicionais sobre aliases, verbos, opções e comandos, consulte Usando a linha de comando da Instrumentação de Gerenciamento do Windows e WMIC - Assumir o controle da linha de comando sobre o WMI.

Alias

Um alias é uma renomeação fácil de uma classe, propriedade ou método que torna o WMI mais fácil de usar e ler. Você pode determinar quais aliases estão disponíveis para o WMIC por meio do comando /?. Você também pode determinar os aliases para uma classe específica usando o comando <className> /?. Para obter mais informações, consulte Alias do WMIC.

Comutador

Um switch é uma opção WMIC que você pode definir em termos gerais ou opcionais. Para obter uma lista de opções disponíveis, consulte Opções do WMIC.

Verbos

Para usar verbos no WMIC, digite o nome do alias e o verbo em seguida. Se um alias não tiver suporte a um verbo, você receberá a mensagem "o provedor não pode executar a tentativa de operação". Para obter mais informações, consulte Verbos do WMIC.

A maioria dos aliases tem suporte para os seguintes verbos:

ASSOC

Retorna o resultado da consulta Associators of (<wmi_object>) em que <wmi_object> é o caminho dos objetos retornados pelos comandos PATH ou CLASS. Os resultados são as instâncias associadas ao objeto. Quando ASSOC é usado com um alias, são retornadas as classes com a classe subjacente ao alias. Por padrão, a saída é retornada em formato HTML.

O verbo ASSOC tem as seguintes opções:

Switch	Descrição
`/RESULTCLASS:<classname>`	Os pontos de extremidade retornados associados ao objeto original devem pertencer ou ser derivados da classe especificada.
`/RESULTROLE:<rolename>`	Os pontos de extremidade retornados devem desempenhar um papel específico nas associações com o objeto de origem.
`/ASSOCCLASS:<assocclass>`	Os pontos de extremidade retornados devem ser associados à origem por meio da classe especificada ou de uma das classes derivadas.

Exemplo: os assoc

CALL

Executa um método.

Exemplo: service where caption="telnet" call startservice

Observação

Para determinar os métodos disponíveis para certa classe, use /?. Por exemplo, service where caption="telnet" call /? apresenta as funções disponíveis para a classe de serviço.

CREATE

Cria uma nova instância e define os valores da propriedade. CREATE não pode ser usado para criar uma classe.

Exemplo: environment create name="temp"; variablevalue="new"

DELETE

Exclui a instância ou o conjunto atual de instâncias. DELETE pode ser usado para excluir classes.

Exemplo: process where name="calc.exe" delete

GET

Recupera os valores de propriedade específicos.

GET tem as seguintes opções:

Switch	Descrição
`/VALUE`	A saída é formatada com cada valor apresentado em uma linha separada e com o nome da propriedade.
`/ALL`	A saída é formatada como tabela.
`/TRANSLATE:<translation table>`	Converte a saída utilizando a tabela de tradução nomeada pelo comando. As tabelas de tradução BasicXml e NoComma estão incluídas no WMIC.
`/EVERY:<interval>`	Repete o comando a cada <intervalo> de segundos.
`/FORMAT:<format specifier>`	Especifica uma palavra-chave ou nome de arquivo XSL para formatar os dados.

Exemplo: process get name

LISTA

Mostra os dados. LIST é o verbo padrão.

LIST tem os seguintes advérbios:

Advérbio	Descrição
`BRIEF`	Conjunto principal das propriedades
`FULL`	Conjunto completo de propriedades. Esse é o advérbio padrão de `LIST`.
`INSTANCE`	Somente caminhos de instância
`STATUS`	Status dos objetos
`SYSTEM`	Propriedades do sistema

LIST tem as seguintes opções:

Switch	Descrição
`/TRANSLATE:<translation table>`	Converter a saída utilizando a tabela de conversão nomeada pelo comando. As tabelas de tradução BasicXml e NoComma estão incluídas no WMIC.
`/EVERY:<interval>`	Repetir o comando a cada <intervalo> de segundos.
`/FORMAT:<format specifier>`	Especifica uma palavra-chave ou nome de arquivo XSL para formatar os dados.

Exemplo: process list brief

SET

Atribuir valores às propriedades.

Exemplo: environment set name="temp", variablevalue="new"

Comutadores

As opções globais são usadas para definir padrões para o ambiente WMIC. Você pode visualizar o valor atual das condições definidas por essas opções inserindo o comando CONTEXT.

/NAMESPACE

Namespace que normalmente o alias usa. O padrão é root\cimv2.

Exemplo: /namespace:\\root

/ROLE

O Namespace que o WMIC normalmente procura em busca de aliases e outras informações do WMIC.

Exemplo: /role:\\root

/NODE

Nomes de computador, delimitados por vírgula. Todos os comandos são executados de forma síncrona em todos os computadores apresentados neste valor. Os nomes de arquivos devem ser prefixados com &. Os nomes de computadores em um arquivo devem ser delimitados por vírgulas ou em linhas separadas.

/IMPLEVEL

Nível de representação.

Exemplo: /implevel:Anonymous

/AUTHLEVEL

Nível de autenticação.

Exemplo: /authlevel:Pkt

/LOCALE

Localidade.

Exemplo: /locale:ms_411

/PRIVILEGES

Habilita ou desabilita todos os privilégios.

Por exemplo: /privileges:enable ou /privileges:disable

/TRACE

Apresenta o sucesso ou a falha de todas as funções usadas para executar comandos WMIC.

Por exemplo: /trace:on ou /trace:off

/RECORD

Registra todas as saídas em um arquivo de XML. A saída também é apresentada no prompt de comando.

Exemplo: /record:MyOutput.xml

/INTERACTIVE

Geralmente, os comandos delete são confirmados.

Por exemplo: /interactive:on ou /interactive:off

/FAILFAST on|off|TimeoutInMilliseconds

Se estiver ativado (ON), os computadores /NODE receberão ping antes de enviar comandos WMIC para eles. Se um computador não responder, os comandos WMIC não lhe serão enviados.

Por exemplo: /failfast:on ou /failfast:off

/USER

Nome de usuário usado pelo WMIC ao acessar os computadores /NODE ou os computadores especificados nos aliases. Você receberá uma solicitação de senha. Um nome de usuário não pode ser utilizado com o computador local.

Exemplo: /user:JSMITH

/PASSWORD

Senha usada pelo WMIC ao acessar os computadores /NODE. A senha não está visível na linha de comando.

Exemplo: /password:password

/OUTPUT

Especifica um modo para todos os redirecionamentos da saída. A saída não é apresentada na linha de comando e o destino é apagado antes do início da saída. Os valores válidos são STDOUT, CLIPBOARD ou nome de arquivo.

Exemplo: /output:clipboard

/APPEND

Especifica um modo para todos os redirecionamentos da saída. A saída não é mostrada na linha de comando e o destino não é apagado antes do início da saída e a saída é anexada ao final do conteúdo atual do destino. Os valores válidos são STDOUT, CLIPBOARD ou nome de arquivo.

Exemplo: /append:clipboard

/AGGREGATE

Usado com o switch LIST e GET /EVERY. Se AGGREGATE estiver ativado (ON), LIST e GET mostram seus resultados quando todos os computadores no /NODE tiverem respondido ou expirado. Se AGGREGATE estiver OFF (desligado), LIST e GET mostrarem seus resultados assim que forem recebidos.

Por exemplo: /aggregate:off ou /aggregate:on

Comandos

Os seguintes comandos WMIC estão disponíveis o tempo todo. Para obter mais informações, confira Comandos WMIC.

CLASS

Escapa do modo de alias padrão do WMIC para acessar classes no esquema WMI diretamente. Para obter mais informações sobre as classes WMI disponíveis, consulte Classes do WMI.

Exemplo: wmic /output:c:\ClassOutput.htm class Win32_SoundDevice

PATH

Escapa do modo de alias padrão do WMIC para acessar instâncias no esquema WMI diretamente.

Exemplo: wmic /output:c:\PathOutput.txt path Win32_SoundDevice get /value

CONTEXTO

Exibe os valores atuais de todos os comutadores globais.

Exemplo: wmic context

QUIT

Sai do WMIC.

Exemplo: wmic quit

EXIT