Introduction
Créer ou mettre à jour une valeur de clé de registre sur un appareil Windows lors de l'exécution d'une automation. Utilisez cette action pour appliquer les paramètres de configuration, mettre en œuvre les politiques ou modifier le comportement de l'application à grande échelle.
🖥️ REMARQUE SUR LA PLATEFORME : Cette action est uniquement pour Windows. Les clés de registre n'existent pas sur macOS ou Linux.
Action Définir la clé de registre
À partir du pipeline d'automation en mode édition, cliquez sur + et sélectionnez Définir la clé de registre dans la catégorie Système.
Le panneau d'action s'ouvre avec les champs de configuration du registre.
Chemin du registre
Le chemin complet de la clé de registre. Obligatoire.
Utilisez la syntaxe du chemin du registre de style PowerShell avec le préfixe de ruche.
Exemple : HKEY_LOCAL_MACHINE:\Software\MyApp\Settings
Préfixes de ruche courants :
Préfixe | Ruche complète |
| HKEY_LOCAL_MACHINE |
| HKEY_CURRENT_USER |
| HKEY_CLASSES_ROOT |
Cliquez sur (x) pour insérer une variable, une variable système ou une référence de champ personnalisé. La valeur est résolue au moment de l'exécution.
Nom de la clé
Le nom de la valeur à définir dans le chemin du registre. Obligatoire.
Exemple : DisableTelemetry, MaxConnections, InstallDir
Cliquez sur (x) pour insérer une variable, une variable système ou une référence de champ personnalisé.
Type de valeur
Le type de données pour cette valeur de registre. Obligatoire.
Type | Description |
Chaîne | Texte brut (REG_SZ) |
Chaîne développable | Texte avec références de variables d'environnement, par exemple |
Chaîne multiple | Plusieurs chaînes stockées sous forme de liste (REG_MULTI_SZ) |
DWORD | Entier 32 bits (REG_DWORD) |
QWORD | Entier 64 bits (REG_QWORD) |
Binaire | Données binaires brutes (REG_BINARY) |
Valeur
La valeur à écrire dans la clé de registre. Obligatoire.
Cliquez sur (x) pour insérer une variable, une variable système ou une référence de champ personnalisé — utile quand la valeur doit être dynamique, comme définir un chemin d'installation capturé à partir d'une action antérieure.
Conditions
La section Conditions vous permet de restreindre le moment où cette action s'exécute en fonction des attributs de l'appareil ou du résultat d'une action antérieure.
Voir Conditions d'action pour la référence complète sur les types de conditions, les opérateurs et les valeurs.
Options supplémentaires
Développez Options supplémentaires pour le nom de l'action, le comportement en cas d'échec, l'attribution de la variable de sortie, les tentatives et le basculement activé.
Voir Aperçu des actions pour la référence complète sur les options supplémentaires disponibles sur chaque action.
FAQ
Que se passe-t-il si le chemin du registre n'existe pas ? Level créera le chemin s'il n'existe pas déjà, puis définira la valeur spécifiée.
Puis-je utiliser des variables d'environnement dans les champs de valeur ? Pour les valeurs qui ont besoin d'une expansion de variable d'environnement, utilisez le type de valeur Chaîne développable. Chaîne stocke le texte littéral sans expansion.
Qui peut ajouter ou modifier les actions Définir la clé de registre ? Les techniciens autorisés à éditer les automations dans le groupe pertinent. Voir Espace de travail → Autorisations pour la configuration du contrôle d'accès.