Registry - Rename Key

Declaration

<AMREGISTRY KEY="text" />

Description: Renames an existing key in the registry.

WARNING: Incorrectly editing the registry may severely damage your system. Before making changes to the registry, you should back up any valued data on your computer.

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.

General Parameters

Property

Type

Required

Default

Markup

Description

Registry key

Text

Yes

(Empty)

KEY="HKEY_CURRENT_USER\Software

\NetAuto\AutoMate\\AMSERVICES"

The registry key to rename.

New name

Text

Yes

(Empty)

VALUEDATA="HKEY_CURRENT_USER\Software

\NetAuto\AutoMate\\AMSUPPORT"

The new name for the registry key to be renamed.

Description tab - A custom description can be provided on the Description tab to convey additional information or share special notes about a task step.

Error Causes tab - Specify how this step should behave upon the occurrence of an error. (Refer to Task Builder > Error Causes Tab for details.)

On Error tab - Specify what AWE should do if this step encounters an error as defined on the Error Causes tab. (Refer to Task Builder > On Error Tab for details.)

Examples

The sample AML code below can be copied and pasted directly into the Steps panel of the Task Builder.

Description: Rename Registry Key "HKEY_LOCAL_MACHINE\SOFTWARE\Network Automation\10\bugusKeyName" to "Whatever".

<AMREGISTRY ACTIVITY="rename_key" KEY="HKEY_LOCAL_MACHINE\SOFTWARE\
Network Automation\10\bugusKeyName" VALUEDATA="Whatever" />