WMIC: utilitário de linha de comando WMI
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
Sai do WMIC.
Exemplo: wmic exit
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows Vista |
Servidor mínimo com suporte | Windows Server 2008 |