New-MsmqQueue

Creates public or private queues.

Syntax

New-MsmqQueue
   [-Name] <String[]>
   [-Authenticate]
   [-JournalQuota <Int64>]
   [-Journaling]
   [-Label <String>]
   [-MulticastAddress <String>]
   [-PrivacyLevel <EncryptionRequired>]
   [-QueueQuota <Int64>]
   [-QueueType <MSMQQueueType>]
   [-Transactional]
   [<CommonParameters>]

Description

The New-MsmqQueue cmdlet creates public or private queues. The cmdlet returns System.Messaging.MessageQueue objects that represent the new queues. If you do not specify QueueType parameter, the cmdlet creates a private queue.

Examples

Example 1: Create a public queue

PS C:\> New-MsmqQueue -Name "OrderQueue" -QueueType Public

This command creates a public queue named OrderStatus.

Example 2: Create a private queue for authenticated messages

PS C:\> New-MsmqQueue -Name "OrderQueue" -Authenticate -MulticastAddress "234.12.3:8001" -QueueQuota 200000

This command creates a private queue named OrderQueue. The queue accepts only authenticated messages. The command specifies a quota size for the queue.

Required Parameters

-Name

Specifies an array of names of queues. This parameter specifies friendly names of queues. This parameter does not support wildcard characters.

Type:String[]
Position:0
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False

Optional Parameters

-Authenticate

Indicates that the queue accepts only authenticated messages.

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

Specifies the maximum size of the journal queue. Specify a value in kilobytes. If you do not specify a value, this cmdlet uses the default journal queue quota.

Type:Int64
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Journaling

Indicates that received messages are copied to the journal queue.

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

Specifies a label. The label that this parameter specifies describes the queue. The default value is an empty string.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MulticastAddress

Specifies the multicast address associated with the queue. If you do not specify a multicast address, the cmdlet does not assign a multicast address to this queue.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PrivacyLevel

Specifies the privacy level associated with the queue. The default value is Optional.

Type:EncryptionRequired
Parameter Sets:None, Optional, Body
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-QueueQuota

Specifies the maximum size, in kilobytes, of the queue. If you do not specify a value, this cmdlet uses the default queue quota.

Type:Int64
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-QueueType

Specifies a queue type. The acceptable values for this parameter are:

  • Private. The cmdlet creates a private queue with the name that the Name parameter specifies.
  • Public. The cmdlet creates a public queue with the name that the Name parameter specifies.

The default value is Private.

Type:MSMQQueueType
Parameter Sets:Private, Public
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Transactional

Indicates that the cmdlet creates a transactional queue at the specified path.

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