The Action - Registry Edit dialog box lets you configure the registry file to apply. We recommend that you back up the registry before applying the specified registry file, and ensure that the file is properly formatted and well tested. You can also specify the specific requirements that a device must meet for the action to be executed on the device.
To access this dialog box in ZENworks Control Center, click the Bundles tab. Click the underlined link of a bundle in the Name column of the Bundles list, click the Actions tab, click one of the action set tabs (Distribute, Install, Launch, Repair, Uninstall, Terminate, or Preboot), click the Add drop-down list, then select an available action.
The following sections contain additional information:
The General page lets you configure the registry file to apply. You can select hives in the tree to which you want to add values and keys, rename or remove sections, or import a registry file. We recommend that you back up the registry before applying the specified registry file, and ensure that the file is properly formatted and well tested.
NOTE:It is recommended that you do not create a registry key with Default as value. If you create a registry key with Default as value and try to perform a registry update, then the registry edit action will update the Windows Default registry value and not the user created Default registry value.
The following table lists the tasks you can perform to manage registry tree changes:
Task |
Steps |
---|---|
Add a registry key |
|
Add a Value |
|
|
|
Rename an entry |
|
Select all the objects of a parent folder |
|
Deselect all the objects of a parent folder |
|
Clear Selection |
|
Remove an entry |
|
Import the contents of a registry file |
NOTE:A .reg file does not allow you to store the Data Type information of the value being deleted. For more information, see Deleting Registry Keys and Values at Microsoft Support Site. Consequently, when you import a registry file that has a value marked for deletion in the file, the value defaults to a String Data Type. However, this behavior does not affect the deletion of values from the Windows Registry of the managed device. |
Export the contents to a registry file |
|
Search for a Value name, registry key, or both. |
|
The Advanced page lets you specify how you want the action to run (as system or user) and to back up the registry file before applying the modified registry file
Select the check box, then specify the path to the backup file, for example, c:\BackupFile.reg.
If you select this option, the entire registry is backed up before importing the configured registry file. The backup process is performed every time this action executes. This can be a time-consuming operation and the backup file can be large.
Before you edit the registry, export the keys in the registry that you plan to edit, or back up the entire registry by selecting this option. If a problem occurs, you can then restore the registry to its previous state.
NOTE:On a non-XP Windows device, if you apply a bundle for which Backup registry before applying changes is selected and Run Action As is set to User, then the following occurs:
The registry backup action fails.
The bundle execution fails.
Specify how you want the action to run:
System: The action is run under the Local System user and inherits Administrator-level credentials. For example, the action has full rights to the HKEY_LOCAL_MACHINE hive.
Select the Apply HKEY_CURRENT_USER changes to the logged in user's hive instead of .DEFAULT option to enable the changes to be made in the user’s hive instead of the DEFAULT hive of HKEY_USERS.
Select the Resolve the environment variables specified in registry edit value in the user context option to resolve the environment variables that you have specified in the registry edit value, in the user context. If there are no logged in users available, then the environment variables will be resolved in the system context.
User: The registry file is applied using the logged-in user’s credentials. For example, the action has the same rights to the registry and the file system as the logged-in user. If you are changing keys in the HKEY_CURRENT_USER hive, you must run the action as User. Depending on the rights assigned to the user, the action might or might not have rights to the HKEY_LOCAL_MACHINE hive. If you select User, the user must be logged in to the device or the action fails.
The Requirements page lets you define specific requirements that a device must meet for the action to be enforced on it. For information about the requirements, see Requirements.