Freigeben über

New-AzServiceBusQueue

  • Referenz
Modul:
Az.ServiceBus

Erstellen Sie eine Service Bus-Warteschlange. Dieser Vorgang ist idempotent.

Syntax

New-AzServiceBusQueue
   -Name <String>
   -NamespaceName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   [-AutoDeleteOnIdle <TimeSpan>]
   [-DeadLetteringOnMessageExpiration]
   [-DefaultMessageTimeToLive <TimeSpan>]
   [-DuplicateDetectionHistoryTimeWindow <TimeSpan>]
   [-EnableBatchedOperations]
   [-EnableExpress]
   [-EnablePartitioning]
   [-ForwardDeadLetteredMessagesTo <String>]
   [-ForwardTo <String>]
   [-LockDuration <TimeSpan>]
   [-MaxDeliveryCount <Int32>]
   [-MaxMessageSizeInKilobytes <Int64>]
   [-MaxSizeInMegabytes <Int32>]
   [-RequiresDuplicateDetection]
   [-RequiresSession]
   [-Status <String>]
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzServiceBusQueue
   -Name <String>
   -NamespaceInputObject <IServiceBusIdentity>
   [-AutoDeleteOnIdle <TimeSpan>]
   [-DeadLetteringOnMessageExpiration]
   [-DefaultMessageTimeToLive <TimeSpan>]
   [-DuplicateDetectionHistoryTimeWindow <TimeSpan>]
   [-EnableBatchedOperations]
   [-EnableExpress]
   [-EnablePartitioning]
   [-ForwardDeadLetteredMessagesTo <String>]
   [-ForwardTo <String>]
   [-LockDuration <TimeSpan>]
   [-MaxDeliveryCount <Int32>]
   [-MaxMessageSizeInKilobytes <Int64>]
   [-MaxSizeInMegabytes <Int32>]
   [-RequiresDuplicateDetection]
   [-RequiresSession]
   [-Status <String>]
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzServiceBusQueue
   -Name <String>
   -NamespaceInputObject <IServiceBusIdentity>
   -Parameter <ISbQueue>
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Erstellen Sie eine Service Bus-Warteschlange. Dieser Vorgang ist idempotent.

Beispiele

Beispiel 1: Erstellen einer neuen ServiceBus-Warteschlange

New-AzServiceBusQueue -ResourceGroupName myResourceGroup -NamespaceName myNamespace -Name myQueue -AutoDeleteOnIdle (New-TimeSpan -Days 1 -Minutes 3 -Seconds 4) -DefaultMessageTimeToLive (New-TimeSpan -Days 5) -EnablePartitioning

AccessedAt                                : 1/1/0001 12:00:00 AM
AutoDeleteOnIdle                          : 1.00:03:04
CountDetailActiveMessageCount             : 0
CountDetailDeadLetterMessageCount         : 0
CountDetailScheduledMessageCount          : 0
CountDetailTransferDeadLetterMessageCount : 0
CountDetailTransferMessageCount           : 0
CreatedAt                                 : 9/22/2022 12:30:45 PM
DeadLetteringOnMessageExpiration          : False
DefaultMessageTimeToLive                  : 5.00:00:00
DuplicateDetectionHistoryTimeWindow       : 00:10:00
EnableBatchedOperations                   : True
EnableExpress                             : False
EnablePartitioning                        : True
ForwardDeadLetteredMessagesTo             :
ForwardTo                                 :
Id                                        : /subscriptions/326100e2-f69d-4268-8503-075374f62b6e/resourceGroups/myResourceGroup/providers/Microsoft.ServiceBus/namespaces/myNamespace/queues/myQueue
Location                                  : westus
LockDuration                              : 00:01:00
MaxDeliveryCount                          : 10
MaxMessageSizeInKilobytes                 : 1024
MaxSizeInMegabytes                        : 1024
MessageCount                              : 0
Name                                      : myQueue
RequiresDuplicateDetection                : False
RequiresSession                           : False
ResourceGroupName                         : myResourceGroup
SizeInByte                                : 0
Status                                    : Active

Erstellt eine ServiceBus-Warteschlange myQueue im Namespace myNamespace.

Parameter

-AutoDeleteOnIdle

Leerlaufintervall, nach dem die Warteschlange automatisch gelöscht wird. Die Mindestdauer ist fünf Minuten.

Typ:TimeSpan
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliases:cf
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-DeadLetteringOnMessageExpiration

Ein Wert, der angibt, ob diese Warteschlange unterstützung für inaktive Briefe hat, wenn eine Nachricht abläuft.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultMessageTimeToLive

Dies ist die Dauer, nach der die Nachricht ab dem Senden der Nachricht an Service Bus abläuft. Dies ist der Standardwert, der verwendet wird, wenn TimeToLive nicht für eine Nachricht selbst festgelegt ist.

Typ:TimeSpan
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Der Parameter DefaultProfile ist nicht funktionsfähig. Verwenden Sie den Parameter "SubscriptionId", wenn sie verfügbar ist, wenn Sie das Cmdlet für ein anderes Abonnement ausführen.

Typ:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-DuplicateDetectionHistoryTimeWindow

Definiert die Dauer des Doppelten Erkennungsverlaufs. Der Standardwert ist 10 Minuten

Typ:TimeSpan
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableBatchedOperations

Wert, der angibt, ob serverseitige Batchvorgänge aktiviert sind.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableExpress

Ein Wert, der angibt, ob Express-Entitäten aktiviert sind. Eine Expresswarteschlange enthält eine Nachricht vorübergehend im Arbeitsspeicher, bevor sie in beständigen Speicher geschrieben wird.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-EnablePartitioning

Ein Wert, der angibt, ob die Warteschlange über mehrere Nachrichtenbroker verteilt werden soll.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-ForwardDeadLetteredMessagesTo

Warteschlangen-/Themenname zum Weiterleiten der Nachricht "Inaktiver Buchstabe"

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-ForwardTo

Warteschlangen-/Themenname zum Weiterleiten der Nachrichten

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-LockDuration

Dauer eines Zeitbereichs einer Vorschausperre; d. h. die Zeitspanne, in der die Nachricht für andere Empfänger gesperrt ist. Der Maximalwert für LockDuration beträgt 5 Minuten; Der Standardwert ist 1 Minute.

Typ:TimeSpan
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxDeliveryCount

Die maximale Lieferanzahl. Eine Nachricht wird nach dieser Anzahl von Lieferungen automatisch inaktiviert. Der Standardwert ist 10.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxMessageSizeInKilobytes

Maximale Größe (in KB) der Nachrichtennutzlast, die von der Warteschlange akzeptiert werden kann. Diese Eigenschaft wird heute nur in Premium verwendet, und der Standardwert ist 1024.

Typ:Int64
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxSizeInMegabytes

Die maximale Größe der Warteschlange in Megabyte, bei der es sich um die Größe des für die Warteschlange zugewiesenen Arbeitsspeichers handelt. Der Standardwert ist 1024.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Der Warteschlangenname.

Typ:String
Aliases:QueueName
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:False
Accept wildcard characters:False

-NamespaceInputObject

Identity-Parameter

Typ:IServiceBusIdentity
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:True
Accept wildcard characters:False

-NamespaceName

Der Namespacename

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:False
Accept wildcard characters:False

-Parameter

Beschreibung der Warteschlangenressource.

Typ:ISbQueue
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:True
Accept wildcard characters:False

-RequiresDuplicateDetection

Ein Wert, der angibt, ob diese Warteschlange eine duplizierte Erkennung erfordert.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-RequiresSession

Ein Wert, der angibt, ob die Warteschlange das Konzept von Sitzungen unterstützt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

Name der Ressourcengruppe innerhalb des Azure-Abonnements.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:False
Accept wildcard characters:False

-Status

Listet die möglichen Werte für den Status einer Nachrichtenentität auf.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-SubscriptionId

Abonnementanmeldeinformationen, die ein Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.

Typ:String
Position:Named
Standardwert:(Get-AzContext).Subscription.Id
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliases:wi
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

ISbQueue

IServiceBusIdentity

Ausgaben

ISbQueue