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