Write-IniFileValue

PackageDeployment Modul Hilfe	Package Deployment Module (DSM eScript Commands)
Write-IniFileValue Cmdlet	Version 1.0.0.3

Write-IniFileValue

Übersicht

INI-Dateiänderung

Syntax

Write-IniFileValue [-FileName] <String> [-SectionName] <String> [-KeyName] <String> [-ConfirmChanges] [-ContinueOnError] [-Wow64] [-Value] <String> [[-Action] <String>] [[-Context] <String>] [<CommonParameters>]

Beschreibung

Dieser Befehl bearbeitet einzelne Werte in INI-Dateien.

Parameter

-Action <String>

Möglichkeit zur Befehlsausführung.

Erforderlich	Nein
Position	4
Pipeline-Eingaben akzeptieren	Nein

-ConfirmChanges <SwitchParameter>

Wenn angewählt, muss der Benutzer die Änderung des bestehenden Eintrags in einem Dialogfeld bestätigen.

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 mit DSM Runtime Service
Computer: Ausführung unter Benutzerkonto; Protokollierung in HKEY_LOCAL_MACHINE, also für den Computer.
Computer: Ausführung mit DSM Runtime Service; 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

-FileName <String>

Name der Datei. Die Angabe erfolgt mit der Erweiterung .INI und kann sich sowohl auf eine bestehende als auch auf eine noch nicht bestehende Datei beziehen. Eine noch nicht bestehende Datei wird angelegt.

Erforderlich	Ja
Position	0
Pipeline-Eingaben akzeptieren	Nein

-KeyName <String>

Name des Schlüssels. Die Angabe erfolgt ohne das Gleichheitszeichen.
Die Angabe einer leeren Zeichenfolge löscht den Abschnitt mit allen darin enthaltenen Schlüsseln.

Erforderlich	Ja
Position	2
Pipeline-Eingaben akzeptieren	Nein

-SectionName <String>

Name des Abschnitts. Die Angabe erfolgt ohne die eckigen Klammern und kann sich sowohl auf einen bestehenden als auch auf einen noch nicht bestehenden Abschnitt beziehen. Ein noch nicht bestehender Abschnitt wird angelegt.

Erforderlich	Ja
Position	1
Pipeline-Eingaben akzeptieren	Nein

-Value <String>

Wert des angegebenen Schlüssels.
Die Angabe einer leeren Zeichenfolge löscht den Schlüssel.

Erforderlich	Ja
Position	3
Pipeline-Eingaben akzeptieren	Nein

-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.

Erforderlich	Nein
Position	Named
Pipeline-Eingaben akzeptieren	Nein

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