COMMAND EVERYTHING.

New-MsmqMessage

Creates a message object.

PowerShell · Risk: High · Documentation Verified

Last verified: 2026-10-26

Microsoft MSMQ reference: Creates a message object. The syntax and selected example below are adapted from the pinned Windows Server 2025 reference. Module availability, target configuration and delegated permissions determine whether it can run in your environment. Documentation and parameter text: Microsoft, CC BY 4.0; formatting adapted by Cmdlet World. No execution testing is claimed.

New-MsmqMessage [[-Body] <Object>] [-Recoverable] [-Authenticated] [-Journaling] [-Label <String>]
 [-AdminQueuePath <String>] [-AcknowledgeType <AcknowledgeTypes>] [-ResponseQueuePath <String>]
 [-TimeToReachQueue <TimeSpan>] [-TimeToBeReceived <TimeSpan>] [<CommonParameters>]

Copied 0 times

Required permissions

Use an account with the target resource permissions documented for New-MsmqMessage. Modifying administrative cmdlets may require elevation or delegated administration. This catalog does not assert that ordinary users can execute the command.

Supported environments

Windows / MSMQ · Windows Server 2025 documentation; feature/module prerequisites apply

Parameters

-AcknowledgeType: Specifies the type of acknowledgement messages that can be returned by Messaging Queuing.
-AdminQueuePath: Specifies a path. The queue that the path specifies receives the acknowledgement messages that Message Queuing generates.
-Authenticated: Indicates that the cmdlet sends the message as an authenticated message.
-Body: Specifies the body of the message. The default value is an empty body.
-Journaling: Indicates that the originating computer keeps a copy of the message in a journal.
-Label: Specifies a label. The label that this parameter specifies describes the message. The default value is an empty string.
-Recoverable: Indicates that the cmdlet sets the recoverable property of a message object.
-ResponseQueuePath: Specifies a path. The queue that this parameter specifies receives application-generated response messages.
-TimeToBeReceived: Specifies the maximum amount of time, in milliseconds, for the message to be received from the destination queue. The default value is 49.17:02:47.295.
-TimeToReachQueue: Specifies the maximum amount of time, in milliseconds, for the message to reach the queue. The default value is 49.17:02:47.295.

Prerequisites

Windows with the MSMQ module and the Windows feature or management tools that provide it. Confirm target connectivity and version compatibility using the linked Microsoft reference.

Security considerations

This cmdlet changes system state. Review every target and parameter in the official reference, test outside production, and prepare an appropriate backup or rollback. Do not execute the example automatically.

Examples

Example 1: Create a test message

New-MsmqMessage -Body "Test Message" -AdminQueuePath ".\private$\adminqueue" -Recoverable

This command creates a test message. The command specifies the queue that receives the acknowledgement message. Source: Microsoft, CC BY 4.0; transcript prompt/output removed. This example was not executed.

Sources

https://github.com/MicrosoftDocs/windows-powershell-docs/blob/b7645dd8c687139b28e845119da30ec670526507/docset/winserver2025-ps/MSMQ/New-MsmqMessage.md

https://learn.microsoft.com/powershell/module/msmq/new-msmqmessage?view=windowsserver2025-ps

Personal collections

Explain or customize this command with AI

Related commands