Partilhar via

Sintaxe do comando PnPUtil

PnPUtil (PnPUtil.exe) está incluído em todas as versões do Windows a partir do Windows Vista, no diretório %windir%\system32.

Para executar o PnPUtil, abra uma janela de prompt de comando (Executar como administrador) e digite um comando usando a sintaxe e os parâmetros a seguir.

PNPUTIL [/add-driver <...> | /delete-driver <...> |
         /export-driver <...> | /enum-drivers |
         /enum-devices [<...>] | /enum-devicetree [<...>] |
         /disable-device <...> | /enable-device <...> |
         /restart-device <...> | /remove-device <...> |
         /scan-devices [<...>] | /enum-classes [<...>] |
         /enum-interfaces [<...>] | /enum-containers [<...>] |
         /?]

Commands

/add-driver

Adiciona pacote(s) de driver ao repositório de drivers. Comando disponível a partir do Windows 10, versão 1607.

PNPUTIL /add-driver <filename.inf | *.inf> [/subdirs] [/install] [/reboot]

Sinalizadores disponíveis a partir do Windows 10, versão 1607:

  • /subdirs - subdiretórios transversais para pacotes de drivers
  • /install - instalar/atualizar drivers em qualquer dispositivo correspondente
  • /reboot - reiniciar o sistema, se necessário para concluir a operação

Observação

Se o driver não for o driver mais bem classificado no sistema, o PnPUtil não o forçará no dispositivo. Para verificar os drivers correspondentes e sua classificação, execute o seguinte a partir de um prompt de comando elevado: pnputil /enum-devices /instanceid <devgen device instance ID ROOT\DEVGEN{...}> /drivers.

/delete-driver

Exclui um pacote de driver do armazenamento de driver. Comando disponível a partir do Windows 10, versão 1607.

PNPUTIL /delete-driver <oem#.inf> [/uninstall] [/force] [/reboot]

Sinalizadores disponíveis a partir do Windows 10, versão 1607:

  • /uninstall - desinstalar o pacote de driver de qualquer dispositivo usando-o
  • /force - excluir pacote de driver mesmo quando ele está em uso por dispositivos
  • /reboot - reiniciar o sistema, se necessário para concluir a operação

/export-driver

Exporta pacote(s) de driver do armazenamento de driver para um diretório de destino. Comando disponível a partir do Windows 10, versão 1607.

PNPUTIL /export-driver <oem#.inf | *> <target directory>

/enum-drivers

Enumera todos os pacotes de driver de terceiros no repositório de drivers. Comando disponível a partir do Windows 10, versão 1607.

PNPUTIL /enum-drivers [/class <name | GUID>] [/files]

Sinalizadores disponíveis a partir do Windows 11, versão 21H2:

  • /class <name | GUID> - filtrar por nome de classe de driver ou GUID

Sinalizadores disponíveis a partir do Windows 11, versão 22H2:

  • /files - enumerar todos os arquivos do pacote de driver

/disable-device

Desativa dispositivos no sistema. Comando disponível a partir do Windows 10, versão 2004.

PNPUTIL /disable-device [<instance ID> | /deviceid <device ID>]
                        [/class <name | GUID>]
                        [/bus <name | GUID>]
                        [/reboot] [/force]

Sinalizadores disponíveis a partir do Windows 10, versão 2004:

  • /reboot - reiniciar o sistema, se necessário para concluir a operação

Sinalizadores disponíveis a partir do Windows 11, versão 21H2:

  • /deviceid <device ID> - desativar todos os dispositivos com ID de dispositivo correspondente

Sinalizadores disponíveis a partir do Windows 11, versão 22H2:

  • /class <name | GUID> - filtrar por nome de classe de dispositivo ou GUID
  • /bus <name | GUID> - filtrar por nome do enumerador de barramento ou GUID do tipo de barramento
  • /force - desativar mesmo se o dispositivo fornece funcionalidade crítica do sistema

/enable-device

Habilita dispositivos no sistema. Comando disponível a partir do Windows 10, versão 2004.

PNPUTIL /enable-device [<instance ID> | /deviceid <device ID>]
                       [/class <name | GUID>] [/bus <name | GUID>]
                       [/reboot]

Sinalizadores disponíveis a partir do Windows 10, versão 2004:

  • /reboot - reiniciar o sistema, se necessário para concluir a operação

Sinalizadores disponíveis a partir do Windows 11, versão 21H2:

  • /deviceid <device ID> - ativar todos os dispositivos com ID de dispositivo correspondente

Sinalizadores disponíveis a partir do Windows 11, versão 22H2:

  • /class <name | GUID> - filtrar por nome de classe de dispositivo ou GUID
  • /bus <name | GUID> - filtrar por nome do enumerador de barramento ou GUID do tipo de barramento

/restart-device

Reinicia dispositivos no sistema. Comando disponível a partir do Windows 10, versão 2004.

PNPUTIL /restart-device [<instance ID> | /deviceid <device ID>]
                        [/class <name | GUID>] [/bus <name | GUID>]
                        [/reboot]

Sinalizadores disponíveis a partir do Windows 10, versão 2004:

  • /reboot - reiniciar o sistema, se necessário para concluir a operação

Sinalizadores disponíveis a partir do Windows 11, versão 21H2:

  • /deviceid <device ID> - reiniciar todos os dispositivos com ID de dispositivo correspondente

Sinalizadores disponíveis a partir do Windows 11, versão 22H2:

  • /class <name | GUID> - filtrar por nome de classe de dispositivo ou GUID
  • /bus <name | GUID> - filtrar por nome do enumerador de barramento ou GUID do tipo de barramento.

/remove-device

Tenta remover um dispositivo do sistema. Comando disponível a partir do Windows 10, versão 2004.

PNPUTIL /remove-device [<instance ID> | /deviceid <device ID>]
                       [/class <name | GUID>] [/bus <name | GUID>]
                       [/subtree] [/reboot] [/force]

Sinalizadores disponíveis a partir do Windows 10, versão 2004:

  • /subtree - remover toda a subárvore do dispositivo, incluindo quaisquer dispositivos filho
  • /reboot - reiniciar o sistema, se necessário para concluir a operação

Sinalizadores disponíveis a partir do Windows 11, versão 21H2:

  • /deviceid <device ID> - remover todos os dispositivos com ID de dispositivo correspondente

Sinalizadores disponíveis a partir do Windows 11, versão 22H2:

  • /class <name | GUID> - filtrar por nome de classe de dispositivo ou GUID
  • /bus <name | GUID> - filtrar por nome do enumerador de barramento ou GUID do tipo de barramento
  • /force - remover mesmo se o dispositivo fornece funcionalidade crítica do sistema

/scan-devices

Verifica o sistema em busca de alterações de hardware do dispositivo. Comando disponível a partir do Windows 10, versão 2004.

/scan-devices [/instanceid <instance ID>] [/async]

Sinalizadores disponíveis a partir do Windows 10, versão 2004:

  • /instanceid <instance ID> - verificar a subárvore do dispositivo em busca de alterações
  • /async - verificar alterações de forma assíncrona

/enum-devices

Enumere todos os dispositivos no sistema. Comando disponível a partir do Windows 10, versão 1903.

PNPUTIL /enum-devices [/connected | /disconnected]
                      [/instanceid <instance ID> | /deviceid <device ID>]
                      [/class <name | GUID>] [/problem [<code>]]
                      [/bus [<name | GUID>]] [/deviceids] [/relations]
                      [/services] [/stack] [/drivers] [/interfaces]
                      [/properties] [/resources]

Sinalizadores disponíveis a partir do Windows 10, versão 1903:

  • /connected - Filtrar por dispositivos conectados
  • /disconnected - filtrar por dispositivos desligados
  • /instanceid <instance ID> - filtrar por ID de instância do dispositivo
  • /class <name | GUID> - filtrar por nome de classe de dispositivo ou GUID
  • /problem [<code>] - filtrar por dispositivos com problemas ou filtrar por código de problema específico
  • /relations - exibir relações de dispositivo pai e filho

Sinalizadores disponíveis a partir do Windows 10, versão 2004:

  • /drivers - Exibir correspondência e drivers instalados

Sinalizadores disponíveis a partir do Windows 11, versão 21H2:

  • /bus [<name | GUID>] - exibir nome do enumerador de barramento e GUID do tipo de barramento ou filtrar por nome do enumerador de barramento ou GUID do tipo de barramento
  • /deviceids - hardware de exibição e IDs compatíveis
  • /services - Serviços de dispositivos de exibição
  • /stack - exibir informações de pilha de dispositivos eficazes
  • /interfaces - Interfaces de dispositivos de visualização
  • /properties - exibir todas as propriedades do dispositivo

Sinalizadores disponíveis a partir do Windows 11, versão 22H2:

  • /deviceid <device ID> - filtro por hardware do dispositivo e ID compatível
  • /resources - recursos do dispositivo de exibição

/enum-devicetree

Enumera a árvore de dispositivos.

Comando disponível a partir do Windows 11, versão 23H2.

/enum-devicetree [root device instance ID] [/connected] [/services]
                 [/stack] [/drivers] [/interfaces]

root device instance ID - exibir a árvore do dispositivo a partir do ID da instância do dispositivo raiz especificado.

Flags

  • /connected - Filtrar por dispositivos conectados
  • /services - Serviços de dispositivos de exibição
  • /stack - exibir informações de pilha de dispositivos eficazes
  • /drivers - Exibir correspondência e drivers instalados
  • /interfaces - Interfaces de dispositivos de visualização

/enum-interfaces

Enumera todas as interfaces de dispositivo no sistema.

Comando disponível a partir do Windows 10, versão 1903.

PNPUTIL /enum-interfaces [/enabled | /disabled] [/class <GUID>] [/properties]

Sinalizadores disponíveis a partir do Windows 10, versão 1903:

  • /enabled - filtrar por interfaces ativadas
  • /disabled - filtro por interfaces desativadas
  • /class <GUID> - filtro por GUID de classe de interface

Sinalizadores disponíveis a partir do Windows 11, versão 22H2:

  • /properties - exibir todas as propriedades da interface

/enum-classes

Enumera todas as classes de dispositivo no sistema.

Comando disponível a partir do Windows 11, versão 22H2.

PNPUTIL /enum-classes [/class <name | GUID>] [/services]

Sinalizadores disponíveis a partir do Windows 11, versão 22H2:

  • /class <name | GUID> - filtrar por nome de classe de dispositivo ou GUID
  • /services - Serviços de classe de dispositivo de exibição

/enum-containers

Enumera todos os contêineres de dispositivo no sistema.

Comando disponível a partir do Windows 11, versão 23H2.

PNPUTIL /enum-containers [/containerid <container id>] [/connected | /disconnected]
                         [/problem] [/devices] [/format <txt | xml | csv>]
                         [/output-file [<filename>]]

Flags

/containerid <container id> - filtrar por ID do contentor.

/connected | /disconnected - filtrar por recipientes de dispositivos conectados ou filtrar por recipientes de dispositivos desconectados

/problem - filtrar por recipientes de dispositivo com problemas

/devices - dispositivos de recipiente de exibição

/format - formatar a saída como texto, XML ou CSV

/output-file [<filename>] - escrever saída para nome de arquivo opcional

/?

Exibe a sintaxe da linha de comando.

PNPUTIL /?

Mapeamento de comandos herdados

Os comandos a seguir ainda são suportados, mas são legados. Recomendamos que você use a sintaxe up-to-date.

  -a [-i]  <filename.inf> ==> /add-driver <filename.inf> [/install]

  -d [-f]  <oem#.inf>     ==> /delete-driver <oem#.inf> [/force]

  -e                      ==> /enum-drivers

Examples

Para obter exemplos de como usar a ferramenta PnPUtil, consulte PnPUtil Examples.

Consulte também

PnPUtil

  • Last updated on