Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

New-MsmqQueue

New-MsmqQueue

Creates a new queue.

Syntax

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




Detailed Description

This cmdlet will create new public or private queues with the properties passed as parameters. The cmdlet will return System.Messaging.MessageQueue objects representing the newly created queues. If the queue type parameter is not explicitly provided, the cmdlet defaults to creating a private queue.

Parameters

-Authenticate

Sets a value that indicates whether the queue accepts only authenticated messages. Default is False.


Aliases

none

Required?

false

Position?

named

Default Value

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-JournalQuota<Int64>

Sets the maximum size of the journal queue in KB. If no value is specified the default journal queue quota is used.


Aliases

none

Required?

false

Position?

named

Default Value

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Journaling

Sets a value that indicates whether received messages are copied to the journal queue. Default is False.


Aliases

none

Required?

false

Position?

named

Default Value

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Label<String>

Sets the queue description. Default is empty string.s


Aliases

none

Required?

false

Position?

named

Default Value

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-MulticastAddress<String>

Sets the multicast address associated with the queue. If no value is specified no multicast address is assigned to this queue.


Aliases

none

Required?

false

Position?

named

Default Value

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Name<String[]>

The friendly name of a queue. Doesn’t support Wildcard characters.


Aliases

none

Required?

true

Position?

1

Default Value

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-PrivacyLevel<EncryptionRequired>

Sets the privacy level associated with the queue. Default is Optional.


Aliases

none

Required?

false

Position?

named

Default Value

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-QueueQuota<Int64>

Sets the maximum size of the queue in KB. If no value is specified the default queue quota is used.


Aliases

none

Required?

false

Position?

named

Default Value

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-QueueType<QueueType>

If specified as Private, creates a new private queue with the queue name as specified by the –Name parameter.If specified as Public, creates a new public queue with the queue name as specified by the –Name parameter.Default is Private.


Aliases

none

Required?

false

Position?

named

Default Value

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Transactional

If specified, creates a transactional queue at the specified path. Default is Off. Alias: Xact


Aliases

none

Required?

false

Position?

named

Default Value

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters

Examples

Usage Scenario

PS C:\> New-MsmqQueue –Name OrderQueue –QueueType Public
New-MsmqQueue –Name OrderQueue –Authenticate true –QueueQuota 200000 –MulticastAddress 234.12.3:8001

 

 

 



Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.