Registry-Wert setzen

Was die Aktion Registry-Wert setzen tut, welche Typen und Wertformate sie kennt und wann der Schritt fehlschlägt.

Mit Registry-Wert setzen schreibst du einen benannten Wert in die Windows-Registry des Geräts. Das Gerät muss dafür online sein.

Konfigurationsfelder

Feld	Typ	Pflicht	Standard	Beschreibung
Schlüsselpfad	Text	Ja	—	Vollständiger Pfad eines vorhandenen Schlüssels. Er beginnt mit dem ausgeschriebenen Namen der Struktur: `HKEY_LOCAL_MACHINE`, `HKEY_CURRENT_USER`, `HKEY_USERS`, `HKEY_CLASSES_ROOT` oder `HKEY_CURRENT_CONFIG`, zum Beispiel `HKEY_LOCAL_MACHINE\SOFTWARE\Example`. Kurzformen wie `HKLM` funktionieren nicht. Fehlende Schlüssel legt der Schritt nicht an. Unterstützt Variablen `${{ … }}`.
Wertname	Text	Ja	—	Name des Werts. Gibt es ihn noch nicht, wird er angelegt. Den unbenannten Standardwert eines Schlüssels kannst du nicht setzen. Unterstützt Variablen.
Typ	Auswahl	Ja	Zeichenfolge (REG_SZ)	Zeichenfolge (REG_SZ), Erweiterbare Zeichenfolge (REG_EXPAND_SZ), DWORD (32-Bit), QWORD (64-Bit) oder Mehrteilige Zeichenfolge (REG_MULTI_SZ). Binärwerte werden nicht unterstützt.
Wert	Text	Nein	leer	Die Daten, die geschrieben werden. Unterstützt Variablen. Leerzeichen am Anfang und Ende werden entfernt. Das Format hängt vom Typ ab, siehe unten.

Typ	Wertformat
Zeichenfolge (REG_SZ), Erweiterbare Zeichenfolge (REG_EXPAND_SZ)	Beliebiger Text. Ein leerer Wert schreibt eine leere Zeichenfolge.
DWORD (32-Bit)	Ganze Zahl in Dezimalschreibweise von `-2147483648` bis `2147483647`. Hexadezimalwerte wie `0x1` funktionieren nicht.
QWORD (64-Bit)	Ganze Zahl in Dezimalschreibweise von `-9223372036854775808` bis `9223372036854775807`.
Mehrteilige Zeichenfolge (REG_MULTI_SZ)	Ein Eintrag pro Zeile. Leere Zeilen werden verworfen.

Plattformunterstützung

Plattform	Unterstützt
Windows	Ja
Linux	Nein
macOS	Nein

Ausgaben

Ausgabe	Beschreibung
`success`	Erfolgreich: `true`, wenn der Wert geschrieben wurde, `false`, wenn das Gerät einen Fehler gemeldet hat.

Ergebnisverhalten

Der Schritt schreibt den Wert mit dem Windows-Systemkonto. HKEY_CURRENT_USER ist deshalb die Registry des Systemkontos, nicht die des angemeldeten Benutzers. Für Einstellungen des angemeldeten Benutzers nimmst du stattdessen einen Schritt Skript ausführen mit Angemeldeter Benutzer.

Situation	Ergebnis
Der Schlüssel existiert und der Wert wird geschrieben	Erfolgreich. Ein vorhandener Wert mit demselben Namen wird samt Typ überschrieben.
DWORD (32-Bit) oder QWORD (64-Bit) mit einem Wert, der keine ganze Zahl im gültigen Bereich ist	Fehlgeschlagen
Schlüsselpfad oder Wertname ist nach dem Auflösen der Variablen leer	Fehlgeschlagen
Der Schlüssel existiert nicht oder der Name der Struktur ist unbekannt	Fehlgeschlagen. Den Grund nennen die Schrittdetails.
Der Zugriff auf den Schlüssel wird verweigert	Fehlgeschlagen
Das Gerät läuft mit Linux oder macOS	Fehlgeschlagen
Der Agent antwortet nicht rechtzeitig	Zeitüberschreitung. Ob der Wert geschrieben wurde, ist unbekannt.
Das Gerät ist beim Start des Schritts offline	Gerät offline. Je nach Wenn Gerät offline endet der Lauf mit diesem Status oder der Schritt wird übersprungen.

Führst du den Schritt mit denselben Einstellungen noch einmal aus, schreibt er denselben Wert erneut und ist erfolgreich. Registry-Änderungen können Anwendungen und Windows selbst beeinflussen. Teste den Schritt deshalb zuerst auf einem einzelnen Gerät.

Siehe auch: Eine Automatisierung erstellen · Registrierungsänderung

War dies hilfreich?

Brauchen Sie noch Hilfe? Team fragen