Set-MsmqQueueManagerACL

Set-MsmqQueueManagerACL

Modifies access rights of the local queue manager.

Syntax

Parameter Set: Default
Set-MsmqQueueManagerACL -UserName <String[]> [-Allow <QueueManagerAccessRights[]> ] [-Deny <QueueManagerAccessRights[]> ] [-Remove <QueueManagerAccessRights[]> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

This cmdlet modifies the access rights of the local queue manager. It returns the updated MsmqQueueManagerAcl object.

Parameters

-Allow<QueueManagerAccessRights[]>

Specifies the permissions that are granted to the supplied user account or group.
AllExtendedRights: All extended rights for the specified queue manager.
CreateChildObjects: Create child objects with the specified queue manager.
CreateQueue: Create a queue with the specified queue manager.
Delete: Delete queues of the specified queue manager.
DeleteChildObjects: Delete child objects from the specified queue manager.
FullControl: Full control of the specified queue manager.
GetPermissions: Get the permissions of the specified queue manager.
GetProperties: Get the properties of the specified queue manager.
ListContent: List content stored in the queues of the specified queue manager.
PeekDeadLetter: Peek a message from the specified queue manager’s system dead letter queue and transactional dead letter queue.
PeekJournal: Peek a message from the specified queue manager’s system journal queue.
ReceiveDeadLetter: Receive a message from the specified queue manager’s system dead letter queue and transactional dead letter queue.
ReceiveJournal: Receive a message from the specified queue manager’s system journal queue.
SetPermissions: Set the permissions of the specified queue manager.
SetProperties: Set the properties of the specified queue manager.
TakeOwnership: Assign a queue of the specified queue manager to oneself.

Aliases

none

Required?

false

Position?

named

Default Value

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Deny<QueueManagerAccessRights[]>

Specifies the permissions that are revoked from the supplied user account or group.
AllExtendedRights: All extended rights for the specified queue manager.
CreateChildObjects: Create child objects with the specified queue manager.
CreateQueue: Create a queue with the specified queue manager.
Delete: Delete queues of the specified queue manager.
DeleteChildObjects: Delete child objects from the specified queue manager.
FullControl: Full control of the specified queue manager.
GetPermissions: Get the permissions of the specified queue manager.
GetProperties: Get the properties of the specified queue manager.
ListContent: List content stored in the queues of the specified queue manager.
PeekDeadLetter: Peek a message from the specified queue manager’s system dead letter queue and transactional dead letter queue.
PeekJournal: Peek a message from the specified queue manager’s system journal queue.
ReceiveDeadLetter: Receive a message from the specified queue manager’s system dead letter queue and transactional dead letter queue.
ReceiveJournal: Receive a message from the specified queue manager’s system journal queue.
SetPermissions: Set the permissions of the specified queue manager.
SetProperties: Set the properties of the specified queue manager.
TakeOwnership: Assign a queue of the specified queue manager to a him or herself.

Aliases

none

Required?

false

Position?

named

Default Value

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Remove<QueueManagerAccessRights[]>

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 to be 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

PS C:\> Set-MsmqQueueManagerAcl –UserName “REDMOND\madmax” –Allow DeleteMessage,PeekMessage –Deny TakeOwnership,SetPermissions