MSMQ - Reset permissions

Declaration

<AMMSMQ ACTIVITY="reset_permissions" QUEUE="text" REMOTEMACHINE="text" />

Related Topics   

Description

Resets the permission list to the operating system's default values. Removes any queue permissions previously appended to the default list.

IMPORTANT: MSMQ must be installed on the (local or remote) computer in order for these activities to function properly. MSMQ is bundled with most Microsoft Windows operating systems, however, it is not installed by default. For more details regarding the installation of MSMQ, see MSMQ Installation & Overview.

Practical usage

Used to retrieve the properties of a specific Active Directory object.

Parameters

Queue

Property Type Required Default Markup Description
Local computer --- --- --- --- If enabled, specifies that this activity will be performed on the local computer (enabled by default).
NOTE: This parameter does not contain markup and is only displayed in visual mode for task construction and configuration purposes.
Another computer Text No (Empty)
  • REMOTEMACHINE="CompName"
  • REMOTEMACHINE="xxx.xxx.xxx.xxx"
 If enabled, specifies the hostname or IP address of the remote computer that this activity will be performed on. When this parameter is enabled, the Local computer parameter is ignored.
Queue path Text Yes (Empty) QUEUENAME="CompName\QueueName" The name of the message queue in which to reset permissions. The message queue name consists of the compute name, an optional PRIVATE$ keyword that indicates whether it is a private queue and the name of the queue.
  • Public queue example: ComputerName\QueueName
  • Private queue example: ComputerName\PRIVATE$\QueueName

Description

Error Causes

On Error

Example

NOTE:
  • Copy and paste the sample AML code below directly into the Task Builder Steps Panel.
  • To successfully run the sample code, update parameters containing user credentials, files, file paths, or other information specific to the task to match your environment.

Description

This sample task resets permissions for a MSMQ queue.

Copy 
<AMMSMQ ACTIVITY="reset_permissions" QUEUE="vmwinvx64\Private$\myPrivateQueue" />