Registry - Rename Value

Declaration

<AMREGISTRY ACTIVITY="rename_value" KEY="text" 
VALUE="text" VALUEDATA="text" />

Description: Renames the current value of an existing registry key.

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

Commonly used to change registry values.

NOTE: Many of the keys that control Windows itself have access restrictions and can be modified only by an Administrator.

General Parameters

Property

Type

Required

Default

Markup

Description

Registry key

Text

Yes

(Empty)

KEY="HKEY_CURRENT_USER\Software

\NetAuto\AutoMate\\AMSERVICES"

The registry which contains the value to rename.

Value name

Text

Yes

(Empty)

VALUE="Width"

The name of the value to rename.

New name

Text

Yes

(Empty)

VALUEDATA="HKEY_CURRENT_USER\Software

\NetAuto\AutoMate\\AMSUPPORT"

The new name for the value 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 value "bogusName" in key "HKEY_LOCAL_MACHINE\SOFTWARE\Network Automation\10\bugusKeyName" to "Whatever".

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