PackageDeployment Modul Hilfe

Package Deployment Module

Write-IniFileValue Cmdlet

Version 3.1.0.0

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

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

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