Registry - Get Values
Declaration
<AMREGISTRY KEY="text" />
Description: Retrieves the values contained in the specified registry key and populates a dataset with results.
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.
General Parameters
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 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: 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" />