Using Group Policy with Enterprise Library

Group Policy provides a centralized one-to-many management capability for Windows that allows administrators to define settings that apply to a group of computers, systems, services, or applications. Group Policy relies on the Active Directory® service to manage the settings applied at run time to members of the Active Directory forest, domain, or subgroup. For more information about Group Policy, see Group Policy on MSDN.

Enterprise Library includes a manageable configuration source. This allows you to use Group Policy to manage an Enterprise Library application. You do not need to write any application code to use these features. This topic provides information about the following tasks for using Group Policy:

  • Adding a Manageable Configuration Source
  • Generating and Installing Group Policy Templates
  • Troubleshooting Group Policy

Adding a Manageable Configuration Source

If you want to use Group Policy with an application, you must first add a manageable configuration source. Although the procedures shown here use the configuration console, you can use the same procedures with the configuration editor that is integrated with Visual Studio. For more information about the configuration editor, see Using the Configuration Tools.

To add a manageable configuration source

  1. Start the Enterprise Library configuration console or the Visual Studio configuration editor.

  2. On the Blocks menu click Add Configuration Settings.

  3. In the Sources pane click the plus sign icon, point to Add Sources and click Add Manageable Configuration Source.

    Ff664644.de4c10e5-0c74-4144-9198-6b159233ec22(en-us,PandP.50).png

  4. Click the chevron arrow in the Configuration Sources title bar to display the properties pane.

  5. In the properties pane, set the Selected Source property by selecting Manageable Configuration Source from the drop-down list.

  6. Next, you must set the properties of the manageable configuration source. You can view these properties by clicking the Selected Source expander arrow in the Configuration Sources section, or within the section for the manageable configuration source itself.

    Ff664644.5836dc0c-7981-432d-b6f3-f4c52519eaf1(en-us,PandP.50).png

  7. Enter a unique value for the Application Name property to identify your application within the Group Policy rules.

  8. Provide an entry for the File Path property.

  9. Check that Group Policy Enabled is set to True. This is the default.

  10. Right-click the System Configuration Source item and then click Delete System Configuration Source. This is not strictly necessary, but it tidies up the configuration.

  11. On the File menu, click Save or Save As to save your configuration.

Note

Do not use a password in a connection string or other sensitive information with Group Policy; the values can be exposed in an unencrypted format. Although the password and other information can be encrypted in the configuration file, the configuration file information is used in an unencrypted format by Group Policy and could be exposed.

Generating and Installing Group Policy Templates

To use Group Policy to manage an Enterprise Library application, you must first generate a Group Policy template and then use Group Policy to configure the application. Although the procedures in this section use the configuration console, you can use the same procedures with the configuration editor that is integrated with Visual Studio.

To generate a Group Policy template for the application

  1. Ensure that you have completed all other configuration tasks for the application.
  2. Open the configuration console.
  3. In the left pane of the Enterprise Library configuration console, right-click Manageable Configuration Source, and then click Generate ADM Template.
  4. In the Save As box, type a name for the template, and then click Save.

Note

The templates generated by the configuration tools use the Windows Server® 2003 ADM format for maximum compatibility with all existing operating system versions. Windows Vista® and Windows Server 2008 use the new ADMX format for Group Policy templates. However, they will also read and use ADM format templates.

To configure the application using Group Policy

  1. Ensure that you have administrative privileges to configure the application.
  2. Ensure that you have installed a suitable version of the Group Policy management console (GPMC), as shown in the following list:
  3. Click Start, and then click Run. In the Run dialog box, type gpmc.msc, and then click OK. This opens the Group Policy Management Console (GPMC) and shows the complete forest for your domain.
  4. Expand the Domains node to show the Group Policy Objects section within your domain.
  5. Right-click Group Policy Objects, click New, type a name for the new Group Policy object, and then click OK.
  6. In the left tree view, right-click your new Group Policy object entry, and then click Edit.
  7. Expand the Computer Configuration or User Configuration section of the Group Policy Object. Right-click Administrative Templates, and then click Add/Remove Templates.
  8. In the Add/Remove templates dialog box, click Add.
  9. Browse to the template you created in the Enterprise Library Configuration Console, select it, and then click Open. The template appears in the Add/Remove templates dialog box.
  10. In the Add/Remove templates dialog box, click Close.
  11. Expand the Administrative Templates section, and then locate the section corresponding to the template that you just added. Expand this section and each section within it. As you select a section, the settings available for that section appear in the right-side window.
  12. To open the Settings dialog box, double-click the setting you want to edit.
  13. The Settings dialog box allows you to enter an initial value if you have not already configured it, or enable or disable an existing setting.
  14. When you select Enabled, the controls in the central section of the dialog box allow you to specify the setting. Depending on the type of value and the way the ADM file declares the setting details, you will see a text box, a drop-down list, or another standard Windows control.
  15. Use the Previous Setting and Next Setting buttons to navigate through the settings without having to open each one individually from the main Group Policy window, or click OK to commit this setting and close the Settings dialog box.

Troubleshooting Group Policy

This section discusses the following problems that you may encounter while using Group Policy with Enterprise Library:

  • Administrator Enters Invalid Values.
  • Application Is Modified Without Generating New Group Policy Template.
  • Policies Conflict to Produce Invalid Configuration.
  • Other Errors.

Administrator Enters Invalid Values

Group Policy administrative tools, such as the Group Policy Editor and the Group Policy management console, do not perform custom validations, so they will allow an administrator to enter an invalid value in a string field, such as an incorrect type name.

Only policies having valid values on all settings are applied, so when an invalid value is detected, an entry is written to the event log and the entire policy is ignored. The problem is logged to the event log.

Application Is Modified Without Generating New Group Policy Template

If the application is modified, some configuration elements may be replaced with new elements that have the same names, but different types. In this case, the manageable configuration source will look for the policies of the new element, but it will find policy settings for the original configuration elements, which may not match. Typically, this will result in missing values.

Policies Conflict to Produce Invalid Configuration

It is possible for different policies to conflict with one another. If this is the case, it will result in an invalid configuration after the Group Policy overrides are applied. This type of problem can easily occur, because different polices may be applied in different Group Policy Objects. In this case, the ManageableConfigurationSource instance does not detect an error. Typically, the consumer of the configuration settings logs the error.

Other Errors

An entry is written to the event log every time an error is detected, unless the application does not have the permissions required to write to the event log. In this case, no information about the error is available.