PackageDeployment Modul Hilfe

Package Deployment Module (DSM eScript Commands)

Search-RegistryKey Cmdlet

Version 1.0.0.3

Search-RegistryKey

Übersicht

Registry Schlüssel suchen

Syntax

Search-RegistryKey [-KeyPath] <String> [[-ValueName] <String>] [[-Value] <String>] [-ContinueOnError] [-FullPathResult] [-Wow64] [[-ParentIndex] <Int32>] [-ResultVariable] <String> [[-ValueKind] <RegistryValueKind>] [[-Context] <String>] [<CommonParameters>]

Beschreibung

Dieser Befehl sucht unterhalb des angegebenen Registry-Schlüssels nach dem Schlüssel, in dem der angegebene Wert gesetzt ist.

Parameter

-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

6

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

-FullPathResult <SwitchParameter>

Es wird der volle Pfad in der Variable gespeichert.

Erforderlich

Nein

Position

Named

Pipeline-Eingaben akzeptieren

Nein

-KeyPath <String>

Geben Sie hier den Registry-Schlüssel ein, nach dem der angegebene Wert gesucht wird.

Erforderlich

Ja

Position

0

Pipeline-Eingaben akzeptieren

Nein

-ParentIndex <Int32>

Nullbasierter Index in umgekehrter Reihenfolge. Es werden so viele Registry-Schlüssel rechts abgeschnitten, wie als Indexnummer angegeben ist. Beispiel: Gefundener Schlüssel ist HKEY_CURRENT_USER\Software\Test\Sub1\Sub2\Sub3\Sub4. Wenn als Parent Index die Zahl 1 angegeben wird, wird der übergeordnete Ordner Sub3 in der Ergebnisvariable ausgegeben. Wenn 0 angegeben wäre, wäre das Ergebnis Sub4.

Erforderlich

Nein

Position

3

Pipeline-Eingaben akzeptieren

Nein

-ResultVariable <String>

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

Erforderlich

Ja

Position

4

Pipeline-Eingaben akzeptieren

Nein

-Value <String>

Suche nach einem bestimmten Wert. Dies ist sinnvoll, wenn es mehrere Werte gibt.

Erforderlich

Nein

Position

2

Pipeline-Eingaben akzeptieren

Nein

-ValueKind <RegistryValueKind>

String: Wertetyp Zeichenfolge.
DWord: Wertetyp DWORD.
String:
DWord:

Erforderlich

Nein

Position

5

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>

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

<CommonParameters>

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