Registry - Get Value(s)

Declaration

<AMREGISTRY KEY="text" />

Description:

Retrieves the values contained in the specified registry key and populates a dataset with results.

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 retrieve the value associated with the specified name, in the specified registry key. Can also be used to determine whether a given value exists in a specific registry key.

Parameters

General

Property

Type

Required

Default

Markup

Description

Registry key

Text

Yes

(Empty)

KEY="HKEY_CURRENT_USER\Software

\NetAuto\AutoMate\\AMSERVICES"

The full registry path of the key to create, beginning with a valid registry root, such as "HKEY_CURRENT_USER".

Create and populate dataset with registry value(s)

Text

Yes

(Empty)

RESULTDATASET="datasetName"

The name of the dataset to create and populate with retrieved values.

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: Get all values of registry key HKEY_LOCAL_MACHINE\SOFTWARE\Network Automation\10 and populate dataset "datasetName" with results.

<AMREGISTRY ACTIVITY="get_value" KEY="HKEY_LOCAL_MACHINE\SOFTWARE\Network Automation\10" RESULTDATASET="datasetName" />