Read-RegistryValue

PackageDeployment Modul Hilfe	Package Deployment Module
Read-RegistryValue Cmdlet	Version 3.1.0.0

Read-RegistryValue

Übersicht

Variable aus Registry lesen

Syntax

Read-RegistryValue [-KeyPath] <String> [[-ValueName] <String>] [-ValueVariable] <String> [-ContinueOnError] [-Wow64] [[-Context] <String>] [<CommonParameters>]

Beschreibung

Dieser Befehl liest Informationen aus der Registry.
Im Dialogfeld wird spezifiziert, welcher Schlüssel aus welchem Abschnitt in welcher Registry-Datei gelesen werden soll.
Durch die Speicherung in einer Variablen (frei definierbare, lokale Variable) steht der gelesene Wert im gesamten Installationspaket und in allen aus diesem Installationspaket aufgerufenen Installationspaketen zur Verfügung.
Für den Fall, dass bei der Ausführung dieses Befehls ein Fehler auftritt, können Sie im Skript-Editor die Ausführungsoption Skript bei Fehler beenden setzen. Im Fehlerfall wird dann die Ausführung des Skripts beendet, mögliche Folgefehler werden somit vermieden, und die zugehörige Policy wird als nicht compliant angezeigt.
Dasselbe Verhalten gilt auch ohne sichtbare Ausführungsoption, wenn die Paket-Eigenschaft Fehlerbehandlung auf Skript bei Fehler immer beenden gesetzt ist (Vorgabe für neue Pakete).

Parameter

-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	3
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 lesende Schlüssel in der Registry.

Erforderlich	Ja
Position	0
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

-ValueVariable <String>

Die Variable, die gesetzt werden soll. Die Angabe erfolgt ohne %.

Erforderlich	Ja
Position	2
Pipeline-Eingaben akzeptieren	Nein

-Wow64 <SwitchParameter>

WOW64 auf x64-Computer verwenden.

Erforderlich	Nein
Position	Named
Pipeline-Eingaben akzeptieren	Nein

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