Share via

Set-MsmqQueueACL

  • Article

Set-MsmqQueueACL

Modifies access rights to queues.

Syntax

Parameter Set: Default
Set-MsmqQueueACL [-InputObject] <MessageQueue[]> -UserName <String[]> [-Allow <MessageQueueAccessRights[]> ] [-Deny <MessageQueueAccessRights[]> ] [-Remove <MessageQueueAccessRights[]> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

This cmdlet modifies the access rights of the specified queues. It returns the updated MsmqQueueAcl object. The cmdlet can be applied to private, public, journal, system journal, system dead-letter, and system transactional dead-letter queues.

Parameters

-Allow<MessageQueueAccessRights[]>

Specifies the permissions that are granted to the supplied user account or group.
Delete: Delete the specified queue.
FullControl: Full control of the specified queue.
GetPermissions: Get the permissions of the specified queue.
GetProperties: Get the properties of the specified queue.
JournalReceive: Receive a message from the specified queue’s journal queue.
Peek: Peek a message from the specified queue.
Receive: Receive a message from the specified queue.
Send: send a message to the specified queue.
SetPermissions: Set the permissions of the specified queue.
SetProperties: Set the properties of the specified queue.
SpecialPermissions: Special permissions for the specified queue.
TakeOwnership: Assign the specified queue to oneself.

Aliases

none

Required?

false

Position?

named

Default Value

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Deny<MessageQueueAccessRights[]>

Specifies the permissions that are revoked from the supplied user account or group.
Delete: Delete the specified queue.
FullControl: Full control of the specified queue.
GetPermissions: Get the permissions of the specified queue.
GetProperties: Get the properties of the specified queue.
JournalReceive: Receive a message from the specified queue’s journal queue.
Peek: Peek a message from the specified queue.
Receive: Receive a message from the specified queue.
Send: send a message to the specified queue.
SetPermissions: Set the permissions of the specified queue.
SetProperties: Set the properties of the specified queue.
SpecialPermissions: Special permissions for the specified queue.
TakeOwnership: Assign the specified queue to oneself.

Aliases

none

Required?

false

Position?

named

Default Value

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-InputObject<MessageQueue[]>

An array of MsmqQueue objects that represent the queues for which permissions are updated. Accepts pipelined input.

Aliases

none

Required?

true

Position?

1

Default Value

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-Remove<MessageQueueAccessRights[]>

Specifies the permissions that are removed from the supplied user account or group.
Delete: Delete the specified queue.
FullControl: Full control of the specified queue.
GetPermissions: Get the permissions of the specified queue.
GetProperties: Get the properties of the specified queue.
JournalReceive: Receive a message from the specified queue’s journal queue.
Peek: Peek a message from the specified queue.
Receive: Receive a message from the specified queue.
Send: send a message to the specified queue.
SetPermissions: Set the permissions of the specified queue.
SetProperties: Set the properties of the specified queue.
SpecialPermissions: Special permissions for the specified queue.
TakeOwnership: Assign the specified queue to oneself.

Aliases

none

Required?

false

Position?

named

Default Value

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-UserName<String[]>

Specifies the user account or group whose permissions are changed.

Aliases

none

Required?

true

Position?

named

Default Value

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before executing the command.

Required?

false

Position?

named

Default Value

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

Describes what would happen if you executed the command without actually executing the command.

Required?

false

Position?

named

Default Value

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters

Examples

Usage Scenario

Get-MsmqQueue –Name Order* –QueueType Private | Set-MsmqQueueAcl –UserName “REDMOND\madmax” –Allow Delete,Peek,Receive,Send –Deny TakeOwnership