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.

Match type

Criteria by which to evaluate a registry value or key:

  • Key exists: Allows the preference item to be applied if the specified registry key exists.

  • Value exists: Allows the preference item to be applied if the specified registry value exists.

  • Match value data: Allows the preference item to be applied if the specified registry value exists and matches the specified value.

    Value data match type: Allows the preference item to be applied if:

    • Any: The registry value exists and matches the specified value.

    • Substring match: The registry value exists and contains the specified substring.

    • Version match: The string version number found in the registry value specified falls within the range specified.

  • Get value data: Allows the preference item to be applied if the registry value exists and matches the specified value type. Additionally, saves the value data for that registry value to the specified environment variable.

Hive

The registry hive for the value or key to be matched.

Note

You can click the Browse button in the targeting item to select an existing registry hive, key path, and value.

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.

Notes
  • 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