Share via


Registry Match Targeting

Applies To: Windows 7, Windows 8, Windows 8.1, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012, Windows Server 2012 R2

A Registry Match targeting item allows a preference item to be applied to computers or users only if the registry key or value specified in the targeting item exists, if the registry value contains the data specified in the targeting item, or if the version number in the registry value is within the range specified in the targeting item. If the targeting item allows the preference item and if Get value data is selected in the targeting item, then the targeting item saves the value data of the specified registry value to the environment variable specified in the targeting item. If Is Not is selected, it allows the preference item to be applied only if the registry key or value specified in the targeting item does not exist, if the registry value does not contain the data specified in the targeting item, or if the version number in the registry value is not within the range specified in the targeting item.

Note

Match type

Key path

The registry key to be matched, omitting the hive name.

Note

The Key Path box accepts preference processing variables. Press F3 to display a list of variables from which you can select.

Value name

The value name to be matched. To specify the default value for the key, select the Default name check box.

Note

The Value name box accepts preference processing variables. Press F3 to display a list of variables from which you can select.
This option is available only if the match type is Value exists, Match value data, Decimal format, Substring match, Version match, or Get value data.

Value type

The value type to be matched. To disregard the value type, select Any.

Note

This option is available only if the match type is Value exists, Match value data, Decimal format, Substring match, Version match, or Get value data.

Value data

The value data to be matched.

Note

This option is available only if the match type is Match value data, Decimal format, or Substring match.

Variable name

The name of the environment variable to which the registry value data is saved if the targeting item allows the preference item to be applied.

Note

This option is available only if the match type is Get value data.

Version range

A version range to compare to the period-delimited or comma-delimited version string in the value data for the specified registry value. Each version segment must be greater than or equal to zero and less than or equal to 65535.

For example, to specify a version greater than or equal to 1.0 but less than 8.5.1, select >=, type 1 in the box on the left (replacing the first 0), select <, and replace the first three zeros in the box on the right with 8, 5, and 1.

Note

This option is available only if the match type is Version match.

Additional considerations

  • To reposition a targeting item within the list of targeting items that you have applied to a preference item, either drag the targeting item to a new position, or select the targeting item and then click the Move Up arrow or Move Down arrow.

  • Preference items are available only in domain-based GPOs.

Additional references