Share via


POLICY

Identifies a policy to be made available for modification by an administrator. The policy appears in a dialog box with an associated control that an administrator can use to set its state. A policy is specified as follows. Brackets indicate optional parameters.

POLICY name

[KEYNAME key name]

EXPLAIN help string

[VALUENAME value name]

[VALUENAME value name]

[CLIENTEXT guid]

[part definition statements]

END POLICY

name

Policy name as it should appear in the Group Policy Object Editor.

key name

Optional path to the registry key to use for the category. Do not include HKEY_LOCAL_MACHINE or HKEY_CURRENT_USER in the registry path. The preceding CLASS statement determines which of these keys will be used.

If a key name is specified, it will be used by all part definition statements, unless they specifically provide a key name of their own.

help string

Help string that will be displayed in the Explain tab of the policy's dialog box.

value name

Registry value that will be modified. If the administrator selects the option, the value is a REG_DWORD set to 1. If the administrator clears the option, the registry value is removed. To specify values other than the default values, use the VALUEON and VALUEOFF statements directly following the corresponding VALUENAME statement. These statements are specified as follows:

VALUEON on value

VALUEOFF off value

When you use these statements, the behavior is modified such that if the administrator selects the option, the value is set to on value. If the administrator clears the option, the value is set to off value.

guid

Optional value that specifies the GUID of the snap-in extension.

part definition statements

Each policy can contain zero or more PART statements.

Group Policy Overview

Group Policy File Formats