Compartilhar via


reg query

Retorna uma lista da próxima camada de subchaves e entradas localizadas em uma subchave especificada no registro.

Sintaxe

reg query <keyname> [{/v <valuename> | /ve}] [/s] [/se <separator>] [/f <data>] [{/k | /d}] [/c] [/e] [/t <Type>] [/z] [/reg:32] [/reg:64]

Parâmetros

Parâmetro Descrição
<keyname> Especifica o caminho completo da subchave. Para especificar um computador remoto, inclua o nome do computador (no formato \\<computername>\) como parte do nome da chave. Omitir \\<computername>\ faz com que o padrão da operação seja o computador local. O nome da chave deve incluir uma chave-raiz válida. As chaves-raiz válidas para o computador local são: HKLM, HKCU, HKCR, HKU e HKCC. Se um computador remoto for especificado, as chaves-raiz válidas serão: HKLM e HKU. Se o nome da chave do registro contiver um espaço, coloque o nome entre aspas.
/v <valuename> Especifica o nome do valor do registro que deve ser consultado. Se omitido, todos os nomes de valor para keyname serão retornados. Valuename para esse parâmetro será opcional se a opção /f também for usada.
/ve Executa uma consulta de nomes de valor que estão vazios.
/s Instrui a consultar todas as subchaves e nomes de valor recursivamente.
/se <separator> Especifica o separador de valor único a ser pesquisado no tipo de nome de valor REG_MULTI_SZ. Se separator são for especificado, \0 será usado.
/f <data> Especifica os dados ou o padrão a serem pesquisados. Use aspas duplas se uma cadeia de caracteres contiver espaços. Se não for especificado, um curinga (*) será usado como o padrão de pesquisa.
/k Especifica a pesquisa somente em nomes de chave. Precisa ser usado com /f.
/d Especifica a pesquisa somente em dados.
/c Especifica que a consulta diferencie maiúsculas de minúsculas. Por padrão, as consultas não diferenciam maiúsculas de minúsculas.
/e Especifica que apenas correspondências exatas sejam retornadas. Por padrão, todas as correspondências são retornadas.
/t <Type> Especifica os tipos de registro a serem pesquisados. Os tipos válidos são: REG_SZ, REG_MULTI_SZ, REG_EXPAND_SZ, REG_DWORD, REG_BINARY, REG_NONE. Se não for especificado, todos os tipos serão pesquisados.
/z Especifica a inclusão do equivalente numérico para o tipo de registro nos resultados da pesquisa.
/reg:32 Especifica que a chave deve ser acessada usando a exibição do registro de 32 bits.
/reg:64 Especifica que a chave deve ser acessada usando a exibição do registro de 64 bits.
/? Exibe a ajuda no prompt de comando.

Comentários

  • Os valores retornados para a operação reg query são:

    Valor Descrição
    0 Êxito
    1 Falha

Exemplos

Para exibir o valor da versão do valor de nome na chave HKLM\Software\Microsoft\ResKit, digite:

reg query HKLM\Software\Microsoft\ResKit /v Version

Para exibir todas as subchaves e os valores na chave HKLM\Software\Microsoft\ResKit\Nt\Setup em um computador remoto chamado ABC, digite:

reg query \\ABC\HKLM\Software\Microsoft\ResKit\Nt\Setup /s

Para exibir todas as subchaves e os valores do tipo REG_MULTI_SZ usando # como separador, digite:

reg query HKLM\Software\Microsoft\ResKit\Nt\Setup /se #

Para exibir a chave, o valor e os dados para correspondências exatas e que diferenciam maiúsculas de minúsculas de SYSTEM na raiz HKLM do tipo de dados REG_SZ, digite:

reg query HKLM /f SYSTEM /t REG_SZ /c /e

Para exibir a chave, o valor e os dados que correspondem a 0F nos dados sob a chave raiz HKCU do tipo de dados REG_BINARY, digite:

reg query HKCU /f 0F /d /t REG_BINARY

Para exibir as chaves, os valores e os dados que correspondem a asp.net na chave HKLM\SOFTWARE\Microsoft e a todas as subchaves, digite:

reg query HKLM\SOFTWARE\Microsoft /s /f asp.net

Para exibir somente as chaves que correspondem a asp.net na chave HKLM\SOFTWARE\Microsoft e a todas as subchaves, digite:

reg query HKLM\SOFTWARE\Microsoft /s /f asp.net /k

Para exibir o valor e os dados para nomes de valor nulos (padrão) em HKLM\SOFTWARE, digite:

reg query HKLM\SOFTWARE /ve