Registry - Rename key

Declaration

<AMREGISTRY ACTIVITY="rename_key" KEY="text" VALUEDATA="text" />

Related Topics   

Description

Renames an existing key in the registry.

WARNING: Incorrectly editing the registry may severely damage your system. Do not edit the Windows registry unless you are confident about doing so.

Practical usage

Used to rename a registry key. Don't attempt to rename keys without a very good reason. If Windows can't find specific registry keys it needs, it might not boot or operate properly.

NOTE: To make changes to a registry key, you must have the appropriate permissions.

Parameters

General

Property Type Required Default Markup Description
Registry key Text Yes (Empty) KEY="HKEY_CURRENT_USER\Software\Fortra\Automate Desktop\AMSERVICES" The registry key to rename.
New name Text Yes (Empty) VALUEDATA="HKEY_CURRENT_USER\Software\Fortra\Automate Desktop\AMSUPPORT" The new name for the registry key to be renamed.

Description

Error Causes

On Error

Example

NOTE:
  • Copy and paste the sample AML code below directly into the Task Builder Steps Panel.
  • To successfully run the sample code, update parameters containing user credentials, files, file paths, or other information specific to the task to match your environment.

Description

This sample task renames a registry key.

Copy
<AMREGISTRY ACTIVITY="rename_key" KEY="HKEY_LOCAL_MACHINE\SOFTWARE\AutoMate\<Automate Desktop or Automate> <product version number>\bugusKeyName" VALUEDATA="Whatever" />