MSMQ - Set permissions |
Declaration
<AMMSMQ REMOTEMACHINE="text" QUEUENAME="text" TRANSACTIONAL="YES/NO" RESULTDATASET="text (dataset name)" /> |
Description
Adds permissions to the current set. This controls who has access rights to queue properties and messages in the queue.
Practical Usage
See Description
Parameters
General
Property |
Type |
Required |
Default |
Markup |
Description |
LDAP Path |
Text |
Yes |
(Empty) |
LDAPPATH= LDAP:// |
The Lightweight Directory Access Protocol (LDAP) path of the Active Directory object to retrieve. The LDAP is an application protocol for querying and modifying data of directory services implemented in IP networks. Click the Select Object button to launch a standard Windows Active Directory dialog box that allows for the selection an Active Directory object. Click the Select Container button to select the parent container from the domain in which to select an Active Directory object from. |
Create and populate dataset |
Text |
Yes |
(Empty) |
RESULTDATASET="theDataset" |
The name of the dataset to be created which will be populated with the Active Directory object's Property Name and Property Value. More on the field names that this dataset creates can be found below under Additional Notes. |
Credentials
Property |
Type |
Required |
Default |
Markup |
Description |
Username |
Text |
No |
(Empty) |
USERNAME="username" |
The username of the Active Directory user. NOTE: Leave the Username and Password fields blank in order to use the logon user's credentials. If only accessing Active Directory information, then any Domain user is valid. However, a Domain Administrator is required in order to modify an Active Directory user or group. We recommend using the credentials of a Domain Administrator for all Automate Active Directory actions. |
Password |
Text |
No |
(Empty) |
PASSWORD="encrypted" |
The password of the Active Directory user. NOTE: Leave the Username and Password fields blank in order to use the logon user's credentials. If only accessing Active Directory information, then any Domain user is valid. However, a Domain Administrator is required in order to modify an Active Directory user or group. We recommend using the credentials of a Domain Administrator for all Automate Active Directory actions. |
Description Properties
The Description tab allows you to customize the text description of any step as it appears in the Task Builder's Steps Pane.
More on setting custom step description
Error Causes Properties
The Error Causes tab properties allows you to instruct a task step to react only to specific errors or ignore certain errors that should cause it to fail.
More on Error Causes properties
On Error Properties
The On Error tab properties lets you determine what the task should do if a particular step encounters an error as defined in the Error Causes properties.
More about On Error properties
Additional Notes
Datasets
A dataset is a multiple column, multiple row container object. This action creates and populates a dataset with the following fields (rows):
Name |
Type |
Return Value |
theDataset.PropertyName |
Number |
Returns the Active Directory Object's Property Name. |
theDataset.PropertyValue |
Number |
Returns the Active Directory Object's Property Value. |
Example
- The sample AML code below can be copied and pasted directly into the Steps Panel of the Task Builder.
- Parameters containing user credentials, files, file paths, and/or other information specific to the task must be customized before the sample code can run successfully.
Description
This sample task gives a group full control of a queue.
<AMMSMQ ACTIVITY="set_permissions" QUEUE="vmwinvx64\Private$\myPrivateQueue" USER="Automation" />