reg add

  • Artigo

Adiciona uma nova subchave ou entrada ao registro.

Sintaxe

reg add <keyname> [/v valuename | /ve] [/t datatype] [/s separator] [/d data] [/f] [/reg:32 | /reg:64]

Parâmetros

Parâmetro Descrição
<keyname> Especifica o caminho completo da subchave ou entrada a ser adicionada. 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 do computador local são:
  • HKCR (HKEY_CLASSES_ROOT)
  • HKCU (HKEY_CURRENT_USER)
  • HKLM (HKEY_LOCAL_MACHINE)
  • HKU (HKEY_USERS)
  • HKCC (HKEY_CURRENT_CONFIG)

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 da entrada para adicionar registro.
/ve Especifica que a entrada de registro adicionada tem um valor nulo.
/t <Type> Especifica o tipo da entrada de registro. O tipo deve ser uma das seguintes opções:
  • REG_SZ
  • REG_MULTI_SZ
  • REG_DWORD_BIG_ENDIAN
  • REG_DWORD
  • REG_BINARY
  • REG_DWORD_LITTLE_ENDIAN
  • REG_LINK
  • REG_FULL_RESOURCE_DESCRIPTOR
  • REG_EXPAND_SZ
/s <Separator> Especifica o caractere a ser usado para separar várias instâncias de dados, quando o tipo de dados REG_MULTI_SZ é especificado e mais de uma entrada é listada. Se não for especificado, o separador padrão será \0.
/d <Data> Especifica os dados para a nova entrada de registro.
/f Adiciona a entrada de registro sem solicitar confirmação.
/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

  • Não é possível adicionar subárvores com essa operação. Esta versão do reg não solicita confirmação ao adicionar uma subchave.

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

Valor Descrição
0 Êxito
1 Falha
  • Para o tipo de chave REG_EXPAND_SZ, use o símbolo de cursor (^) com % dentro do parâmetro /d.

Exemplos

Para adicionar a chave HKLM\Software\MyCo no computador remoto ABC, digite:

reg add \\ABC\HKLM\Software\MyCo

Para adicionar uma entrada de registro a HKLM\Software\MyCo com um valor chamado Data, o tipo REG_BINARY e os dados de fe340ead, digite:

reg add HKLM\Software\MyCo /v Data /t REG_BINARY /d fe340ead

Para adicionar uma entrada de registro de vários valores a HKLM\Software\MyCo com um valor chamado MRU, o tipo REG_MULTI_SZ e os dados de fax\0mail\0, digite:

reg add HKLM\Software\MyCo /v MRU /t REG_MULTI_SZ /d fax\0mail\0

Para adicionar uma entrada de registro expandida a HKLM\Software\MyCo com um valor chamado Path, o tipo REG_EXPAND_SZ e os dados de %systemroot%, digite:

reg add HKLM\Software\MyCo /v Path /t REG_EXPAND_SZ /d ^%systemroot^%