PackageDeployment Module Help

Package Deployment Module (DSM eScript Commands)

Search-RegistryKey Cmdlet

Version 1.0.0.3

Search-RegistryKey

Synopsis

Find registry key

Syntax

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

Description

With this command you can find the registry key where a specific value has been set.

Parameters

-Context <String>

User: Execution under user account; logging in HKEY_CURRENT_USER, i.e. for the user.
UserPerService: User-related command, execution with DSM Runtime Service.
Computer: Execution under user account; logging in HKEY_CURRENT_MACHINE, i.e. for the computer.
Computer: Execution with DSM Runtime Service; logging in HKEY_LOCAL_MACHINE, i.e. for the computer.

Required

False

Position

6

Accepts pipeline input

False

-ContinueOnError <SwitchParameter>

Continues script execution in spite of errors in the respective command

Required

False

Position

Named

Accepts pipeline input

False

-FullPathResult <SwitchParameter>

The full path is returned to the variable.

Required

False

Position

Named

Accepts pipeline input

False

-KeyPath <String>

Enter the registry key under which you want to find the specified value.

Required

True

Position

0

Accepts pipeline input

False

-ParentIndex <Int32>

Zero-based index in reverse order. This index number determines how many registry keys are 'cut'. Example: matching key is HKEY_CURRENT_USER\Software\Test\Sub1\Sub2\Sub3\Sub4. If the parent index is 1, the parent folder Sub3 is returned as result in the variable. If you specify 0, the result would be Sub4.

Required

False

Position

3

Accepts pipeline input

False

-ResultVariable <String>

Enter the name of the variable omitting the % sign.

Required

True

Position

4

Accepts pipeline input

False

-Value <String>

Search for a specific value. This is useful if there are several values.

Required

False

Position

2

Accepts pipeline input

False

-ValueKind <RegistryValueKind>

String: Value type String.
DWord: Value type DWORD.
String:
DWord:

Required

False

Position

5

Accepts pipeline input

False

-ValueName <String>

This can be the default value of the key or a name. Make sure that the name of the value you enter actually exists on the computer.

Required

False

Position

1

Accepts pipeline input

False

-Wow64 <SwitchParameter>

For reasons of compatibilty, Ivanti DSM maps file and registry access to the default storage location for 32 bit applications (provided that the storage location differs from that of 64-bit applications). File access: whenever a 32-bit application attempts to access %windir%\System32, the access is redirected to %windir%\SysWOW64. Registry commands: when accessing HKEY_LOCAL_MACHINE\SOFTWARE the calls are redirected to HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node. The x64-switch stops this redirection of file and registry accesses when running the script command on a x64 computer; the eScript command runs on the specified path. CallScript command: the script runs in a 64-bit process.

Required

False

Position

Named

Accepts pipeline input

False

<CommonParameters>

For more information about common parameters, type "Get-Help about_CommonParameters".