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.
Practical Usage
Used to write a value and optional data to the registry. Necessary keys will be automatically created.
General Parameters
Property |
Type |
Required |
Default |
Markup |
Description |
---|---|---|---|---|---|
Value type |
Text (options) |
Yes |
string |
|
The registry data type to create. The available options are:
|
Registry key |
Text |
Yes |
(Empty) |
|
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 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: 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" />