reg add
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:
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:
|
/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^%