Set-MsmqQueueManagerACL
Modifies the access rights of a queue manager.
Syntax
Set-MsmqQueueManagerACL
-UserName <String[]>
[-Allow <QueueManagerAccessRights>]
[-Deny <QueueManagerAccessRights>]
[-Remove <QueueManagerAccessRights>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
The Set-MsmqQueueManagerACL cmdlet modifies the access rights of the local queue manager. This cmdlet returns the updated MsmqQueueManagerAcl object.
Examples
Example 1: Modify access rights for the local queue manager
PS C:\> Set-MsmqQueueManagerAcl -UserName "CONTOSO\DavidChew" -Allow DeleteMessage,PeekMessage -Deny TakeOwnership,SetPermissionsThis command modifies the access rights of the local queue manager.
Parameters
-Allow
Specifies an array of permissions that this cmdlet grants to a 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 system dead letter queue and transactional dead letter queue.
- PeekJournal. Peek a message from the specified queue manager system journal queue.
- ReceiveDeadLetter. Receive a message from the specified queue manager system dead letter queue and transactional dead letter queue.
- ReceiveJournal. Receive a message from the specified queue manager 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.
| Type: | QueueManagerAccessRights |
| Accepted values: | FullControl, CreateQueue, ReceiveDeadLetter, ReceiveComputerJournal, GetProperties, SetProperties, GetPermissions, SetPermissions, TakeOwnership, Delete, PeekDeadLetter, PeekComputerJournal, AllExtendedRights, CreateAllChildObjects, DeleteAllChildObjects, ListObjects |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Prompts you for confirmation before running the cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Deny
Specifies an array of permissions that the cmdlet revokes from a 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 system dead letter queue and transactional dead letter queue.
- PeekJournal. Peek a message from the specified queue manager system journal queue.
- ReceiveDeadLetter. Receive a message from the specified queue manager system dead letter queue and transactional dead letter queue.
- ReceiveJournal. Receive a message from the specified queue manager 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.
| Type: | QueueManagerAccessRights |
| Accepted values: | FullControl, CreateQueue, ReceiveDeadLetter, ReceiveComputerJournal, GetProperties, SetProperties, GetPermissions, SetPermissions, TakeOwnership, Delete, PeekDeadLetter, PeekComputerJournal, AllExtendedRights, CreateAllChildObjects, DeleteAllChildObjects, ListObjects |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Remove
Specifies an array of permissions that this cmdlet removes from a 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 system dead letter queue and transactional dead letter queue.
- PeekJournal. Peek a message from the specified queue manager system journal queue.
- ReceiveDeadLetter. Receive a message from the specified queue manager system dead letter queue and transactional dead letter queue.
- ReceiveJournal. Receive a message from the specified queue manager 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.
| Type: | QueueManagerAccessRights |
| Accepted values: | FullControl, CreateQueue, ReceiveDeadLetter, ReceiveComputerJournal, GetProperties, SetProperties, GetPermissions, SetPermissions, TakeOwnership, Delete, PeekDeadLetter, PeekComputerJournal, AllExtendedRights, CreateAllChildObjects, DeleteAllChildObjects, ListObjects |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserName
Specifies the user account or group whose permissions the cmdlet changes.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Inputs
None
Outputs
Related Links
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for