Write-RegistryMultiString
PackageDeployment Modul Hilfe |
Package Deployment Module (DSM eScript Commands) |
Write-RegistryMultiString Cmdlet |
Version 1.0.0.3 |
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. |
||||||
|
-Context <String> |
||||||
User: Ausführung unter Benutzerkonto; Protokollierung in HKEY_CURRENT_USER, also für den Benutzer. |
||||||
|
-ContinueOnError <SwitchParameter> |
||||||
Setzt das Skript trotz eines aufgetretenen Fehlers im betreffenden Befehl fort |
||||||
|
-KeyPath <String> |
||||||
Der zu ändernde Schlüssel (oft auch als Zweig bezeichnet). |
||||||
|
-Position <String> |
||||||
Position. |
||||||
|
-Value <String[]> |
||||||
Der zu setzende Wert. Die Aktion, die für diesen Wert ausgeführt werden soll wird über die Optionsschaltflächen ausgewählt.. |
||||||
|
-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. |
||||||
|
-Wow64 <SwitchParameter> |
||||||
Aus Kompatibilitätsgründen verwendet Ivanti DSM bei Datei- und Registryzugriffen standardmäßig den Ablageort für 32-Bit Anwendungen (sofern dieser sich von dem für 64-Bit Anwendungen unterscheidet). Bei Dateizugriffen hat dies zur Folge, dass bei x64-Systemen auf das %WinDir%\SysWOW64 Verzeichnis und nicht auf das %WinDir%\system32 Verzeichnis zugegriffen wird. Bei Registry-Befehlen werden (unter anderem) Zugriffe auf HKEY_LOCAL_MACHINE\SOFTWARE nach HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node umgeleitet. Der x64-Schalter bewirkt, dass bei der Ausführung des Skript-Befehls auf einem x64-Computer diese Umleitung von Datei- bzw Registryzugriffen abgeschaltet und der eScript-Befehl auf angegebenen Pfad ausgeführt wird. Beim Callscript-Befehl wird damit das Skript in einem 64-Bit Prozess ausgeführt. |
||||||
|
<CommonParameters> |
Weitere Informationen zu 'common parameters' finden Sie mit dem Kommando "Get-Help about_CommonParameters". |