Compartilhar via


Comandos do console do dispositivo (DevCon.exe)

DevCon (DevCon.exe) é uma ferramenta de linha de comando que pode exibir informações detalhadas sobre dispositivos em computadores que executam o Windows. Você também pode usar o DevCon para habilitar, desabilitar, instalar, configurar e remover dispositivos. O DevCon usa a sintaxe a seguir.

devcon [/r] command [arguments]

Importante

O PnPUtil é fornecido com todas as versões do Windows e usa as APIs mais confiáveis e seguras disponíveis e seu uso é recomendado. Para obter mais informações sobre como usar PnPutil em vez de devcon, consulte Substituindo DevCon.

Parâmetros

Observação

Para alterar o status ou a configuração de um dispositivo, você deve ser membro do grupo Administradores no computador.

Os parâmetros em um comando DevCon devem aparecer na ordem mostrada na sintaxe. Se os parâmetros não estiverem em ordem, o DevCon os ignorará, mas não exibirá um erro de sintaxe. Em vez disso, ele processa o comando com os parâmetros restantes.

Para obter ajuda sobre a sintaxe de comando, você pode usar os seguintes comandos em uma janela do Prompt de Comando: Ajuda do DevCon ou Comando de ajuda do DevCon.

/r

Reinicialização condicional. Reinicializa o sistema após a conclusão de uma operação somente se uma reinicialização for necessária para efetivar uma alteração.

Esse parâmetro difere da operação de reinicialização do DevCon, que força a reinicialização do sistema. Em vez disso, o parâmetro /r determina se uma reinicialização é necessária com base no código de retorno da operação que o acompanha. Para obter mais informações, consulte Reinicializando e reiniciando.

command

Especifica um comando DevCon. Para obter informações sobre os comandos DevCon disponíveis e os argumentos de comando, use a lista a seguir.

Você também pode obter ajuda de sintaxe em uma janela do Prompt de Comando usando o comando de ajuda DevCon.

Para listar e exibir informações sobre dispositivos no computador, use os seguintes comandos:

Para pesquisar informações sobre dispositivos no computador, use os seguintes comandos:

Para manipular o dispositivo ou alterar sua configuração, use os seguintes comandos:

arguments

Especifica os argumentos para um comando DevCon.

/? ou ajuda

Exibe a ajuda. Se você especificar uma operação, o DevCon exibirá ajuda detalhada para a operação.

Os parâmetros devem aparecer na ordem especificada. Por exemplo, para exibir a ajuda para a operação DevCon Status, digite devcon /? status (ou devcon help status), não devcon status /?.

Comentários

Muitas operações DevCon exigem a ID de hardware do dispositivo. Para criar uma lista das IDs de hardware de todos os dispositivos no computador para uso em operações DevCon subsequentes, comece com um comando DevCon HwIDs. Para obter mais informações, consulte IDs de hardware e cadeias de caracteres de identificação de dispositivo.

Como o DevCon pesquisa dispositivos

O DevCon identifica os dispositivos pelo nome do computador, ID de hardware, ID compatível, ID da instância do dispositivo e/ou classe de configuração do dispositivo.

Se um comando incluir mais de uma ID ou padrão de ID (uma ID que contém caracteres curinga (*)), o DevCon retornará dispositivos cujas IDs correspondem a qualquer uma das IDs ou padrões de ID. Ou seja, ele assume um "ou" entre os argumentos ID.

Por exemplo, devcon hwids *pnp* *mou* retorna dispositivos que incluem "pnp" ou "mou" em sua ID de hardware ou ID compatível.

Se um comando incluir uma classe de configuração de dispositivo, o DevCon primeiro limitará a pesquisa à classe de instalação e, em seguida, retornará dispositivos na classe que correspondem a qualquer um dos padrões de ID, ou seja, ele pressupõe um "e" entre a classe e as IDs e um "ou" entre cada um dos argumentos de ID.

Por exemplo, devcon hwids =media *pnp* *microsoft* retorna dispositivos na classe de configuração de dispositivo de mídia que incluem "pnp" ou "microsoft" em sua ID de hardware ou ID compatível.

Reinicializando e reiniciando

O DevCon fornece dois métodos para reinicializar o sistema operacional e um método para reiniciar dispositivos.

  • O parâmetro /r é uma reinicialização condicional que reinicializa o sistema operacional somente se uma reinicialização for necessária para tornar a operação que acompanha efetiva. Esse parâmetro é válido somente em comandos que incluem uma operação DevCon. Ele pode reinicializar o sistema em um computador local.

  • A operação de reinicialização do DevCon força a reinicialização do sistema operacional. Ele é válido apenas em um computador local e não pode ser combinado com outras operações. Em vez de usar a operação de reinicialização, os usuários normalmente adicionam o parâmetro /r aos comandos.

  • A operação de reinicialização do DevCon reinicia os dispositivos especificados. Ele é válido apenas em um computador local e não pode ser combinado com outras operações.

Códigos de retorno DevCon

DevCon retorna um inteiro que pode ser usado em programas e scripts para determinar o sucesso de um comando DevCon (por exemplo, return = devcon hwids *).

A tabela a seguir lista e descreve os códigos de retorno.

Código de retorno Descrição
0 Êxito
1 Requer reinicialização
2 Falha
3 Erro de sintaxe