Registry - Create Value

Declaration

<AMREGISTRY ACTIVITY="write_value" KEY="text" VALUE="text" VALUEDATA="text" TYPE="text (options)" />

Description:

Sets the specified name/value pair on the specified registry key.

IMPORTANT: 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 write a value and optional data to the registry. Necessary keys will be automatically created.

Parameters

General

Property

Type

Required

Default

Markup

Description

Value type

Text (options)

Yes

string

  1. TYPE="string"

  2. TYPE="dword"

The registry data type to create. The available options are:

  • String (default) - Create a STRING value, which consists of plain readable text. All data types ending with SZ are STRING values. All STRING values are indicated by an AB icon.

  • Dword- Create a DWORD value, which consists of binary data. System policy settings, device drivers, and services use DWORD values the most.

Registry key

Text

Yes

(Empty)

  1. PDFDOCUMENTFROM="new_file"

  2. PDFDOCUMENTFROM="existing_file"

The registry key (folder) in which to set the new value. Click the folder icon to open a standard registry viewer that you can use to navigate to the desired registry key.

Value name

Text

Yes

(Empty)

SOURCE="C:\PDFFileName.pdf"

The name of the registry value to create.

NOTE: When you add a registry value to a registry key, the new registry value name and data type are saved with default data.

Value data

Text

Yes

(Empty)

NEWPDF="C:\PDFFileName.pdf"

The registry value data to write. The Registry key and Value name must be specified along with this value for proper functionality.

Description

Error Causes

On Error

Examples

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

Description: Write "theData" to value "temp" in key "HKEY_LOCAL_MACHINE\SOFTWARE\Network Automation\AutoMate 10\TaskService" as a String.

<AMREGISTRY ACTIVITY="write_value" KEY="HKEY_LOCAL_MACHINE\SOFTWARE\Network Automation\AutoMate 10\TaskService" VALUE="temp" VALUEDATA="theData" />