Zum Hauptinhalt springen

Aktion: Registrierungsschlüssel setzen

Create or update a Windows registry key value as part of an automation pipeline.

Einführung

Erstellen oder aktualisieren Sie einen Registrierungsschlüsselwert auf einem Windows-Gerät während eines Automatisierungslaufs. Verwenden Sie diese Aktion, um Konfigurationseinstellungen durchzusetzen, Richtlinien anzuwenden oder das Anwendungsverhalten im großen 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

Wenn die Arbeitsfläche noch keine Aktionen enthält, wählen Sie Eine Aktion hinzufügen. Um diesen Schritt zu einer Arbeitsfläche hinzuzufügen, die bereits Aktionen enthält, klicken Sie auf das eingebettete + wo Sie sie einfügen möchten, und wählen Sie Eine weitere Aktion hinzufügen. Wählen Sie dann Registrierungsschlüssel setzen aus System.

Action Picker - Set Registry Key Action

Das Aktionsfenster öffnet sich mit den Feldern zur Registrierungskonfiguration.

Set Registry Key Action

Registrierungspfad

Der vollständige Pfad zum Registrierungsschlüssel. Erforderlich.

Verwenden Sie die PowerShell-Registrierungspfad-Syntax mit dem Hive-Präfix.

Beispiel: HKEY_LOCAL_MACHINE:\Software\MyApp\Settings

Gängige Hive-Präfixe:

Präfix

Vollständiger Hive

HKLM:

HKEY_LOCAL_MACHINE

HKCU:

HKEY_CURRENT_USER

HKCR:

HKEY_CLASSES_ROOT

Klicken Sie auf (x) um eine Variable, eine 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, eine Systemvariable oder einen benutzerdefinierten Feldreferenz einzufügen.

Werttyp

Der Datentyp für diesen Registrierungswert. Erforderlich.

Typ

Beschreibung

Zeichenfolge

Nur-Text (REG_SZ)

Erweiterbare Zeichenfolge

Text mit Umgebungsvariablenverweisen, z. B. %SystemRoot% (REG_EXPAND_SZ)

Mehrfachzeichenfolge

Mehrere Zeichenfolgen, 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 Feldreferenz einzufügen — nützlich, wenn der Wert dynamisch sein muss, beispielsweise 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, Wiederholungsversuche und den Aktivierungsschalter.

Siehe Aktionsübersicht für die vollständige Referenz zu den 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 Umgebungsvariablenerweiterung benötigen, verwenden Sie den Erweiterbare Zeichenfolge Werttyp. Eine Standard-Zeichenfolge 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 zur Konfiguration der Zugriffskontrolle.

Hat dies deine Frage beantwortet?