Edit

Share via

Set-MsmqQueueManagerACL

Module:
MSMQ Module

Modifies the access rights of a queue manager.

Syntax

Default (Default) 

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,SetPermissions

This 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.

Parameter properties

Type:QueueManagerAccessRights
Default value:None
Accepted values:FullControl, CreateQueue, ReceiveDeadLetter, ReceiveComputerJournal, GetProperties, SetProperties, GetPermissions, SetPermissions, TakeOwnership, Delete, PeekDeadLetter, PeekComputerJournal, AllExtendedRights, CreateAllChildObjects, DeleteAllChildObjects, ListObjects
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:QueueManagerAccessRights
Default value:None
Accepted values:FullControl, CreateQueue, ReceiveDeadLetter, ReceiveComputerJournal, GetProperties, SetProperties, GetPermissions, SetPermissions, TakeOwnership, Delete, PeekDeadLetter, PeekComputerJournal, AllExtendedRights, CreateAllChildObjects, DeleteAllChildObjects, ListObjects
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:QueueManagerAccessRights
Default value:None
Accepted values:FullControl, CreateQueue, ReceiveDeadLetter, ReceiveComputerJournal, GetProperties, SetProperties, GetPermissions, SetPermissions, TakeOwnership, Delete, PeekDeadLetter, PeekComputerJournal, AllExtendedRights, CreateAllChildObjects, DeleteAllChildObjects, ListObjects
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-UserName

Specifies the user account or group whose permissions the cmdlet changes.

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

None

Outputs

Object