PackageDeployment Module Help

Package Deployment Module

Search-RegistryKey Cmdlet

Version 4.0.0.5

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 in Service context.
Computer: Execution under user account; logging in HKEY_CURRENT_MACHINE, i.e. for the computer.
ComputerPerService: Execution in service context; 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>

By default, the PackageDeployment module assumes to run in a 64-bit PowerShell process on 64-bit systems, and therefore defaults to the 64-bit application location (if different from the 32-bit application location) for file and registry accesses. If you want to access the 32-bit counterparts (in the file system %WinDir%\SysWOW64 instead of %WinDir%\System32, in the registry HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node instead of HKEY_LOCAL_MACHINE\SOFTWARE), use the -Wow64 switch.

Required

False

Position

Named

Accepts pipeline input

False

<CommonParameters>

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