Configure an Ini File Item

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

Ini File preference items allow you to add or replace a property in a configuration settings (.ini) file or setup information (.inf) file, or to delete a property, section, or entire .ini or .inf file. (To copy any type of file to a new location or to modify its attributes, see the Files Extension.)

Each section in an .ini or .inf file uses the following format:

[SectionName]
PropertyName1=PropertyValue1
PropertyName2=PropertyValue2

Before you create an Ini File preference item, you should review the behavior of each action possible with this extension.

Creating an Ini File item

To create a new Ini File preference item

  1. Open the Group Policy Management Console . Right-click the Group Policy object (GPO) that should contain the new preference item, and then click Edit .

  2. In the console tree under Computer Configuration or User Configuration , expand the Preferences folder, and then expand the Windows Settings folder.

  3. Right-click the Ini Files node, point to New , and select Ini File .

  4. In the New Ini File Properties dialog box, select an Action for Group Policy to perform. (For more information, see "Actions" in this topic.)

  5. Enter configuration settings (.ini) or setup information (.inf) file settings for Group Policy to configure or remove. (For more information, see "Ini file settings" in this topic.)

  6. Click the Common tab, configure any options, and then type your comments in the Description box. (For more information, see Configure Common Options.)

  7. Click OK . The new preference item appears in the details pane.

Actions

This type of preference item provides a choice of four actions: Create , Replace , Update , and Delete . The behavior of the preference item varies with the action selected and whether the property already exists.

Create

Add and configure a property in an .ini or .inf file for computers or users. If the file does not exist, it is created.

Delete

Remove a property or a section from an .ini or .inf file, or delete an .ini or .inf file for computers or users.

Replace

Delete and recreate a property in an .ini or .inf file for computers or users. The net result of the Replace action is to overwrite the property. If the property does not exist, then the Replace action creates the property.

Update

This action has the same effect as Replace .

Ini file settings

Important

File Path

Additional considerations

  • The Section Name , Property Name , and Property Value fields are each disabled until you type text in the preceding field.

  • You can use item-level targeting to change the scope of preference items.

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

Additional references