Erstellen oder aktualisieren Sie einen Registrierungsschlüsselwert auf einem Windows-Gerät während einer Automatisierungsausführung. Verwenden Sie diese Aktion, um Konfigurationseinstellungen durchzusetzen, Richtlinien anzuwenden oder das Verhalten von Anwendungen in großem Maßstab zu ändern.
🖥️ PLATTFORMHINWEIS: Diese Aktion ist nur für Windows. Registrierungsschlüssel existieren nicht auf macOS oder Linux.
Aktion "Registrierungsschlüssel setzen"
Klicken Sie in der Automatisierungs-Pipeline im Bearbeitungsmodus auf + und wählen Sie Registrierungsschlüssel setzen aus der Kategorie System.
Das Aktionsfenster wird mit den Registrierungskonfigurationsfeldern geöffnet.
Registrierungspfad
Der vollständige Pfad zum Registrierungsschlüssel. Erforderlich.
Verwenden Sie die PowerShell-Syntax für Registrierungspfade mit dem Hive-Präfix.
Beispiel: HKEY_LOCAL_MACHINE:\Software\MyApp\Settings
Häufige Hive-Präfixe:
Präfix | Vollständige Hive |
| HKEY_LOCAL_MACHINE |
| HKEY_CURRENT_USER |
| HKEY_CLASSES_ROOT |
Klicken Sie auf (x), um eine Variable, eine Systemvariable oder einen benutzerdefinierten Feldbezug einzufügen. Der Wert wird zur Laufzeit aufgelöst.
Schlüsselname
Der Name des Werts, der im Registrierungspfad gesetzt werden soll. Erforderlich.
Beispiel: DisableTelemetry, MaxConnections, InstallDir
Klicken Sie auf (x), um eine Variable, eine Systemvariable oder einen benutzerdefinierten Feldbezug einzufügen.
Werttyp
Der Datentyp für diesen Registrierungswert. Erforderlich.
Typ | Beschreibung |
String | Einfacher Text (REG_SZ) |
Erweiterbarer String | Text mit Umgebungsvariablenverweisen, z. B. |
Multi-String | Mehrere Strings, die als Liste gespeichert sind (REG_MULTI_SZ) |
DWORD | 32-Bit-Ganzzahl (REG_DWORD) |
QWORD | 64-Bit-Ganzzahl (REG_QWORD) |
Binär | Rohe Binärdaten (REG_BINARY) |
Wert
Der Wert, der in den Registrierungsschlüssel geschrieben werden soll. Erforderlich.
Klicken Sie auf (x), um eine Variable, eine Systemvariable oder einen benutzerdefinierten Feldbezug einzufügen — nützlich, wenn der Wert dynamisch sein muss, z. B. beim Setzen eines Installationspfads, der aus einer vorherigen Aktion erfasst wurde.
Bedingungen
Im Abschnitt Bedingungen können Sie einschränken, wann diese Aktion ausgeführt wird, basierend auf Geräteattributen oder dem Ergebnis einer vorherigen Aktion.
Siehe Aktionsbedingungen für die vollständige Referenz zu Bedingungstypen, Operatoren und Werten.
Zusätzliche Optionen
Erweitern Sie Zusätzliche Optionen für Aktionsnamen, Fehlerverhalten, Ausgabevariablenzuweisung, Wiederholungen und den Aktivierungsschalter.
Siehe Aktionsübersicht für die vollständige Referenz zu zusätzlichen Optionen, die für jede Aktion verfügbar sind.
Häufig gestellte Fragen
Was ist, wenn der Registrierungspfad nicht vorhanden ist? Level erstellt den Pfad, falls er noch nicht vorhanden ist, und setzt dann den angegebenen Wert.
Kann ich Umgebungsvariablen in den Wertfeldern verwenden? Für Werte, die Umgebungsvariablenerweiterung benötigen, verwenden Sie den Werttyp Erweiterbarer String. Standard-String speichert den wörtlichen Text ohne Erweiterung.
Wer kann Aktionen zum Setzen von Registrierungsschlüsseln hinzufügen oder ändern? Techniker mit der Berechtigung, Automatisierungen in der relevanten Gruppe zu bearbeiten. Siehe Arbeitsbereich → Berechtigungen für die Zugriffssteuerungskonfiguration.