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