Edit

Move-MsmqMessage

  • Reference
Module:
MSMQ

Moves messages between subqueues or between the main queue and a subqueue.

Syntax

Move-MsmqMessage
    -InputObject <MessageQueue>
    -DestinationQueue <MessageQueue>
    -Message <Message>
    [-Transactional]
    [<CommonParameters>]

Description

The Move-MsmqMessage cmdlet moves messages between subqueues of the same queue or between the main queue and one of its subqueues. This cmdlet returns a Message object that represents the moved message. Move and open operations implicitly create subqueues. You can get subqueues by using the Get-MsmqQueue cmdlet.

Examples

Example 1

PS C:\> $srcQueue = Get-MsmqQueue -QueueType Private -Name "Myqueue" 
PS C:\> $dstQueue = Get-MsmqQueue -QueueType Private -Name "Myqueue" -SubQueue "MySubqueue"
PS C:\> $Message = $srcQueue | Receive-MsmqQueue -Peek
PS C:\> $srcQueue | Move-MsmqMessage -DestinationQueue $dstQueue -Message $Message

Parameters

-DestinationQueue

Specifies a MsmqQueue object that represents the destination queue to which to move the message. The destination queue can be a subqueue or the main queue.

Type:MessageQueue
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Specifies a MsmqQueue object. The cmdlet moves the message from the source queue that this parameter specifies. The source queue can be a subqueue or the main queue. This parameter accepts pipeline input.

Type:MessageQueue
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Message

Specifies a Message object that represents the message to move.

Type:Message
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Transactional

Indicates that this cmdlet moves the message within a transaction context.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False