PackageDeployment Modul Hilfe

Package Deployment Module

Write-RegistryValue Cmdlet

Version 4.0.0.5

Write-RegistryValue

Übersicht

Wert in der Registry ändern

Syntax

Write-RegistryValue [-KeyPath] <String> [[-ValueName] <String>] [[-Value] <String>] [-AllowDuplicates] [-ContinueOnError] [-Wow64] [[-ValueKind] <RegistryValueKind>] [[-Action] <String>] [[-Context] <String>] [<CommonParameters>]

Beschreibung

Ändert oder ergänzt einen Wert vom Typ String in der Registry, bestehende Eintragungen in der Registry werden aktualisiert.
Tritt bei Ausführung dieses Befehls ein Fehler auf, wird das Skript beendet. Wollen Sie das Skript auch im Fehlerfall fortsetzen, müssen Sie im Skript-Editor die Ausführungsoption Skript bei Fehler trotzdem fortsetzen aktivieren.

Parameter

-Action <String>

Set: Evtl vorhandenen Wert ersetzen.
Remove: Wert aus bestehender Zeile anhängen.
Append: Wert an bestehende Zeile anängen.
Prepend: Wert am Anfang der Zeile einfügen.

Erforderlich

Nein

Position

4

Pipeline-Eingaben akzeptieren

Nein

-AllowDuplicates <SwitchParameter>

Bei der Aktion Anhängen wird der Wert auch dann angehängt, wenn er bereits in der Zeile enthalten ist.

Erforderlich

Nein

Position

Named

Pipeline-Eingaben akzeptieren

Nein

-Context <String>

User: Ausführung unter Benutzerkonto; Protokollierung in HKEY_CURRENT_USER, also für den Benutzer.
UserPerService: Benutzerbezogener Befehl, Ausführung im Service-Kontext
Computer: Ausführung unter Benutzerkonto; Protokollierung in HKEY_LOCAL_MACHINE, also für den Computer.
ComputerPerService: Ausführung im Service-Kontext; Protokollierung in HKEY_LOCAL_MACHINE, also für den Computer.

Erforderlich

Nein

Position

5

Pipeline-Eingaben akzeptieren

Nein

-ContinueOnError <SwitchParameter>

Setzt das Skript trotz eines aufgetretenen Fehlers im betreffenden Befehl fort

Erforderlich

Nein

Position

Named

Pipeline-Eingaben akzeptieren

Nein

-KeyPath <String>

Der zu ändernde Schlüssel (oft auch als Zweig bezeichnet).

Erforderlich

Ja

Position

0

Pipeline-Eingaben akzeptieren

Nein

-Value <String>

Der zu setzende Wert. Durch die Aktion wird näher bestimmt, wie der Wert zu setzen ist (Ersetzen, Anhängen, Einfügen oder Löschen).

Erforderlich

Nein

Position

2

Pipeline-Eingaben akzeptieren

Nein

-ValueKind <RegistryValueKind>

ExpandString: Speichert den Wert als erweiterbare Zeichenkette in der Registry
Binary: Binärwert.

Erforderlich

Nein

Position

3

Pipeline-Eingaben akzeptieren

Nein

-ValueName <String>

Wahlweise der Standardwert des Schlüssels oder der Name eines anderen Werts. Falls dieser auf der Arbeitsstation vorhanden ist, kann er ausgewählt werden.

Erforderlich

Nein

Position

1

Pipeline-Eingaben akzeptieren

Nein

-Wow64 <SwitchParameter>

Standardmäßig geht das PackageDeployment-Modul davon aus, auf 64-Bit Systemen in einem 64-Bit PowerShell-Prozess ausgeführt zu werden und greift daher bei Datei- und Registryzugriffen standardmäßig den Ablageort für 64-Bit Anwendungen (sofern dieser sich von dem für 32-Bit Anwendungen unterscheidet) zurück. Soll auf die 32-Bit Pendants (im Dateisystem %WinDir%\SysWOW64 statt %WinDir%\System32, in der Registry HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node statt HKEY_LOCAL_MACHINE\SOFTWARE) zugegriffen werden, verwenden Sie den -Wow64 Switch.

Erforderlich

Nein

Position

Named

Pipeline-Eingaben akzeptieren

Nein

<CommonParameters>

Weitere Informationen zu 'common parameters' finden Sie mit dem Kommando "Get-Help about_CommonParameters".