reg add
Ajoute une nouvelle sous-clé ou entrée au Registre.
Syntaxe
reg add <keyname> [/v valuename | /ve] [/t datatype] [/s separator] [/d data] [/f] [/reg:32 | /reg:64]
Paramètres
Paramètre | Description |
---|---|
<keyname> |
Spécifie le chemin complet de la sous-clé ou de l’entrée à ajouter. Pour spécifier un ordinateur distant, ajoutez le nom de l’ordinateur (au format \\<computername>\ ) dans le keyname. Si vous n’indiquez pas \\<computername>\ , l’opération par défaut est appliquée sur l’ordinateur local. Le keyname doit avoir une clé racine valide. Les clés racines valides pour l’ordinateur local sont les suivantes :
Si un ordinateur distant est spécifié, les clés racines valides sont : HKLM et HKU. Si le nom de la clé de Registre contient un espace, placez le nom de la clé entre guillemets. |
/v <Valuename> |
Spécifie le nom de l’entrée de Registre ajoutée. |
/ve | Spécifie que l’entrée de Registre ajoutée a une valeur Null. |
/t <Type> |
Spécifie le type de l’entrée de Registre. Type doit avoir une des valeurs suivantes :
|
/s <Separator> |
Spécifie le caractère à utiliser pour séparer plusieurs instances de données quand le type de données REG_MULTI_SZ est spécifié et que plusieurs entrées sont listées. S’il n’est pas spécifié, le séparateur par défaut est \0. |
/d <Data> |
Spécifie les données de la nouvelle entrée de Registre. |
/f | Ajoute l’entrée de Registre sans demander de confirmation. |
/reg:32 | Spécifie que la clé doit être consultée dans la vue de Registre 32 bits. |
/reg:64 | Spécifie que la clé doit être consultée dans la vue de Registre 64 bits. |
/? | Affiche l'aide à l'invite de commandes. |
Notes
Les sous-arborescences ne peuvent pas être ajoutées avec cette opération. Cette version de reg ne demande pas de confirmation pour ajouter une sous-clé.
Les valeurs de retour de l’opération reg add sont :
Valeur | Description |
---|---|
0 | Opération réussie |
1 | Échec |
- Pour le type de clé REG_EXPAND_SZ, utilisez le symbole caret (^) avec % à l’intérieur du paramètre /d.
Exemples
Pour ajouter la clé HKLM\Software\MyCo sur l’ordinateur distant ABC, tapez :
reg add \\ABC\HKLM\Software\MyCo
Pour ajouter une entrée de Registre à HKLM\Software\MyCo avec une valeur nommée Data, le type REG_BINARY et les données de fe340ead, tapez :
reg add HKLM\Software\MyCo /v Data /t REG_BINARY /d fe340ead
Pour ajouter une entrée de Registre à plusieurs valeurs HKLM\Software\MyCo avec une valeur nommée MRU, le type REG_MULTI_SZ et les données de fax\0mail\0, tapez :
reg add HKLM\Software\MyCo /v MRU /t REG_MULTI_SZ /d fax\0mail\0
Pour ajouter une entrée de Registre développée à HKLM\Software\MyCo avec une valeur nommée Path, le type REG_EXPAND_SZ et les données de %systemroot%, tapez :
reg add HKLM\Software\MyCo /v Path /t REG_EXPAND_SZ /d ^%systemroot^%