Edit

Share via

Set-MsmqQueueManager

Module:
MSMQ Module

Configures the queue manager.

Syntax

All (Default) 

Set-MsmqQueueManager
    [-RenewEncryptionKey]
    [-MsgStore <String>]
    [-MsgLogStore <String>]
    [-TransactionLogStore <String>]
    [-MessageQuota <Int64>]
    [-JournalQuota <Int64>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Connect 

Set-MsmqQueueManager
    [-Connect]
    [-RenewEncryptionKey]
    [-MsgStore <String>]
    [-MsgLogStore <String>]
    [-TransactionLogStore <String>]
    [-MessageQuota <Int64>]
    [-JournalQuota <Int64>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Disconnect 

Set-MsmqQueueManager
    [-Disconnect]
    [-RenewEncryptionKey]
    [-MsgStore <String>]
    [-MsgLogStore <String>]
    [-TransactionLogStore <String>]
    [-MessageQuota <Int64>]
    [-JournalQuota <Int64>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

The Set-MsmqQueueManager cmdlet configures the properties of the Message Queuing (also known as MSMQ) queue manager. This cmdlet returns a QueueManager object that represents the modified local queue manager. If you specify the RenewEncryptionKey parameter to renew keys, you must restart the Message Queuing service for the new keys to become effective.

Examples

Example 1: Configure the queue manager

PS C:\> Set-MsmqQueueManager -MessageQuota 2048576 -MsgStore "C:\MSMQ\MessageFiles" -TransactionLogStore "C:\MSMQ\TransactionLogs"

This command configures properties of the Message Queuing queue manager.

Parameters

-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

-Connect

Indicates that this cmdlet connects the computer to the network and to the directory service. If you specify this parameter, you cannot specify the Disconnect parameter.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Connect
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Disconnect

Indicates that this cmdlet disconnects the computer from the network and from the directory service. If you specify this parameter, you cannot specify the Connect parameter.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Disconnect
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-JournalQuota

Specifies the total Journal Message Storage quota for Message Queuing.

Parameter properties

Type:Int64
Default value:None
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

-MessageQuota

Specifies the total Message Storage quota for Message Queuing.

Parameter properties

Type:Int64
Default value:None
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

-MsgLogStore

Indicates that this cmdlet changes the message logger storage location and moves over all the message logger files to the new location.

Parameter properties

Type:String
Default value:None
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

-MsgStore

Specifies a new message storage location. The cmdlet moves all the message files to the new location.

Parameter properties

Type:String
Default value:None
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

-RenewEncryptionKey

Indicates that this cmdlet renews the public encryption key.

Parameter properties

Type:SwitchParameter
Default value:None
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

-TransactionLogStore

Specifies a new transaction logger storage location. This cmdlet moves all the transaction logger files to the new location.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:XactLogStore

Parameter sets

(All)
Position:Named
Mandatory:False
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