Write-RegistryMultiString

PackageDeployment Modul Hilfe	Package Deployment Module
Write-RegistryMultiString Cmdlet	Version 3.1.0.0

Write-RegistryMultiString

Übersicht

Multi_SZ-Wert in der Registry ändern

Syntax

Write-RegistryMultiString [-KeyPath] <String> [[-ValueName] <String>] [[-Value] <String[]>] [-ContinueOnError] [-Wow64] [[-Action] <String>] [[-Position] <String>] [[-Context] <String>] [<CommonParameters>]

Beschreibung

Ändert oder ergänzt einen Wert vom Typ Multi_SZ in der Registry.
Dieser Befehl kann zum Erstellen, Löschen und Ändern der mehrteiligen Zeichenketten verwendet werden. Der NetInstall Spy erkennt Änderungen an diesen Werten und erstellt automatisch einen passenden Befehl.
MULTI_SZ-Werte: ClosedHintergrundinformation. In der Registry befinden sich neben den Zeichenketten-Werten auch mehrteilige Zeichenketten-Werte. Im Registrierungseditor sind diese mit REG_MULTI_SZ gekennzeichnet, sie werden z. B. im Zusammenhang mit Protokollen verwendet.
Verwenden Sie diesen Befehl nur mit äußerster Vorsicht. Fehlerhafte Angaben können leicht zu irreparablen Schäden am Betriebssystem führen.
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: Werte ersetzen.
SetAt: Werte ab unten genannter Position ersetzen.
Prepend: Werte am Anfang einfügen.
Append: Wert am Ende einfügen.
InsertAscending: Werte alphabetisch einfügen.
InsertDescending: Werte umgekehrt alphabetisch einfügen.
InsertAt: Werte an unten genannter Position einfügen.
Remove: Werte aus dem vorhandenen String löschen.

Erforderlich	Nein
Position	3
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

-Position <String>

Position.

Erforderlich	Nein
Position	4
Pipeline-Eingaben akzeptieren	Nein

-Value <String[]>

Der zu setzende Wert. Die Aktion, die für diesen Wert ausgeführt werden soll wird über die Optionsschaltflächen ausgewählt..

Erforderlich	Nein
Position	2
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

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