Partilhar via


Sintaxe de comando PnPUtil

O 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 do 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 [<...>] |
         /?]

Comandos

/add-driver

Adiciona pacotes de driver ao repositório de driver. 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 – percorrer subdiretórios para pacotes de driver
  • /install – instalar/atualizar drivers em qualquer dispositivo correspondente
  • /reboot – reinicializar o sistema se necessário para concluir a operação

Observação

Se o driver não for o driver mais bem classificado do sistema, o PnPUtil não o forçará no dispositivo. Para marcar drivers correspondentes e sua classificação, execute o seguinte em um prompt de comando com privilégios elevados: pnputil /enum-devices /instanceid <devgen device instance ID ROOT\DEVGEN{...}> /drivers.

/delete-driver

Exclui um pacote de driver do repositório 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 todos os dispositivos que o usam
  • /force – excluir o pacote de driver mesmo quando ele estiver em uso por dispositivos
  • /reboot – reinicializar o sistema se necessário para concluir a operação

/export-driver

Exporta pacotes de driver do repositório 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 driver. 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 de Windows 11, versão 22H2:

  • /files – enumerar todos os arquivos de pacote de driver

/disable-device

Desabilita dispositivos no sistema. Comando disponível a partir de 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 de Windows 10, versão 2004:

  • /reboot – reinicializar o sistema se necessário para concluir a operação

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

  • /deviceid <device ID> – desabilitar todos os dispositivos com a ID do dispositivo correspondente

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

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

/enable-device

Habilita dispositivos no sistema. Comando disponível a partir de 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 de Windows 10, versão 2004:

  • /reboot – reinicializar o sistema se necessário para concluir a operação

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

  • /deviceid <device ID> – habilitar todos os dispositivos com a ID do dispositivo correspondente

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

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

/restart-device

Reinicia dispositivos no sistema. Comando disponível a partir de 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 de Windows 10, versão 2004:

  • /reboot – reinicializar 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 a ID do dispositivo correspondente

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

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

/remove-device

Tenta remover um dispositivo do sistema. Comando disponível a partir de 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 de Windows 10, versão 2004:

  • /subtree – remover toda a subárvore do dispositivo, incluindo todos os dispositivos filho
  • /reboot – reinicializar 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 a ID do dispositivo correspondente

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

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

/scan-devices

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

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

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

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

/enum-devices

Enumerar todos os dispositivos no sistema. Comando disponível a partir de 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 desconectados
  • /instanceid <instance ID> – filtrar por ID da 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 de Windows 10, versão 2004:

  • /drivers – exibir drivers correspondentes e instalados

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

  • /bus [<name | GUID>] – exibir o nome do enumerador de barramento e o guid do tipo de barramento ou filtrar por guid de tipo de barramento ou nome do enumerador de barramento
  • /deviceids – exibir hardware e IDs compatíveis
  • /services – exibir serviços de dispositivo
  • /stack – exibir informações efetivas da pilha de dispositivos
  • /interfaces – exibir interfaces do dispositivo
  • /properties – exibir todas as propriedades do dispositivo

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

  • /deviceid <device ID> – filtrar por hardware do dispositivo e ID compatível
  • /resources – exibir recursos do dispositivo

/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 de dispositivos começando na ID da instância do dispositivo raiz especificada.

Flags

  • /connected – filtrar por dispositivos conectados
  • /services – exibir serviços de dispositivo
  • /stack – exibir informações efetivas da pilha do dispositivo
  • /drivers – exibir drivers correspondentes e instalados
  • /interfaces – exibir interfaces do dispositivo

/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 habilitadas
  • /disabled – filtrar por interfaces desabilitadas
  • /class <GUID> – filtrar por GUID da 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 – exibir serviços de classe de dispositivo

/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 contêiner.

/connected | /disconnected – filtrar por contêineres de dispositivo conectado ou filtrar por contêineres de dispositivo desconectados

/problem – filtrar por contêineres de dispositivo com problemas

/devices – exibir dispositivos de contêiner

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

/output-file [<filename>] – gravar saída em nome de arquivo opcional

/?

Exibe a sintaxe de linha de comando.

PNPUTIL /?

Mapeamento de comando herdado

Os comandos a seguir ainda têm suporte, mas são herdados. Recomendamos que você use a sintaxe atualizada.

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

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

  -e                      ==> /enum-drivers

Exemplos

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

Confira também

Pnputil