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
The Set-MsmqQueueManagerACL 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.
The acceptable values for this parameter are:
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 |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Deny<QueueManagerAccessRights>
Specifies the permissions that are revoked from the supplied user account or group.
The acceptable values for this parameter are:
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 |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Remove<QueueManagerAccessRights>
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
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 |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Confirm
Prompts you for confirmation before running the cmdlet.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? |
false |
Position? |
named |
Default Value |
false |
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 (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
Examples
PS C:\> Set-MsmqQueueManagerAcl –UserName "REDMOND\pattiful" –Allow DeleteMessage,PeekMessage –Deny TakeOwnership,SetPermissions