Einführung
Erstellt oder aktualisiert einen Registrierungsschlüsselwert auf einem Windows-Gerät während eines Automatisierungslaufs. Verwenden Sie diese Aktion, um Konfigurationseinstellungen durchzusetzen, Richtlinien anzuwenden oder das Anwendungsverhalten in großem Maßstab zu ändern.
🖥️ PLATTFORMHINWEIS: Diese Aktion ist nur für Windows verfügbar. 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 Aktionsfeld öffnet sich mit den Konfigurationsfeldern für die Registrierung.
Registrierungspfad
Der vollständige Pfad zum Registrierungsschlüssel. Erforderlich.
Verwenden Sie die PowerShell-Pfadsyntax für die Registrierung mit dem Hive-Präfix.
Beispiel: HKEY_LOCAL_MACHINE:\Software\MyApp\Settings
Häufige Hive-Präfixe:
Präfix | Vollständiger Hive |
| HKEY_LOCAL_MACHINE |
| HKEY_CURRENT_USER |
| HKEY_CLASSES_ROOT |
Klicken Sie auf (x) um eine Variable, Systemvariable oder einen benutzerdefinierten Feldreferenz einzufügen. Der Wert wird zur Laufzeit aufgelöst.
Schlüsselname
Der Name des Werts, der innerhalb des Registrierungspfads gesetzt werden soll. Erforderlich.
Beispiel: DisableTelemetry, MaxConnections, InstallDir
Klicken Sie auf (x) um eine Variable, Systemvariable oder einen benutzerdefinierten Feldreferenz einzufügen.
Werttyp
Der Datentyp für diesen Registrierungswert. Erforderlich.
Typ | Beschreibung |
Zeichenkette | Nur Text (REG_SZ) |
Erweiterbare Zeichenkette | Text mit Umgebungsvariablenreferenzen, z. B. |
Mehrfach-Zeichenkette | Mehrere Zeichenketten, die als Liste gespeichert sind (REG_MULTI_SZ) |
DWORD | 32-Bit-Ganzzahl (REG_DWORD) |
QWORD | 64-Bit-Ganzzahl (REG_QWORD) |
Binär | Binäre Rohdaten (REG_BINARY) |
Wert
Der Wert, der in den Registrierungsschlüssel geschrieben werden soll. Erforderlich.
Klicken Sie auf (x) um eine Variable, Systemvariable oder einen benutzerdefinierten Feldreferenz einzufügen – nützlich, wenn der Wert dynamisch sein muss, z. B. beim Festlegen eines Installationspfads, der aus einer vorherigen Aktion stammt.
Bedingungen
Der Bedingungen Abschnitt ermöglicht es Ihnen, einzuschrä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 Aktionsname, Fehlerverhalten, Ausgabevariablenzuweisung, Wiederholungen und den Aktivierungsschalter.
Siehe Aktionsübersicht für die vollständige Referenz zu zusätzlichen Optionen, die bei jeder Aktion verfügbar sind.
Häufig gestellte Fragen
Was passiert, wenn der Registrierungspfad nicht existiert? 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 eine Erweiterung von Umgebungsvariablen erfordern, verwenden Sie den Erweiterbare Zeichenkette Werttyp. Die Standard-Zeichenkette 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 jeweiligen Gruppe zu bearbeiten. Siehe Arbeitsbereich → Berechtigungen für die Konfiguration der Zugriffskontrolle.