Dela via

New-AzServiceBusQueue

  • Referens
Modul:
Az.ServiceBus

Skapa en Service Bus-kö. Den här åtgärden är 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>]

Description

Skapa en Service Bus-kö. Den här åtgärden är idempotent.

Exempel

Exempel 1: Skapa en ny ServiceBus-kö

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

Skapar en ServiceBus-kö myQueue i namnområdet myNamespace.

Parametrar

-AutoDeleteOnIdle

Inaktivt intervall efter vilket kön tas bort automatiskt. Den minsta varaktigheten är 5 minuter.

Typ:TimeSpan
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DeadLetteringOnMessageExpiration

Ett värde som anger om den här kön har stöd för obeställbara meddelanden när ett meddelande upphör att gälla.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultMessageTimeToLive

Det här är varaktigheten efter vilken meddelandet upphör att gälla, från och med när meddelandet skickas till Service Bus. Det här är standardvärdet som används när TimeToLive inte har angetts för själva meddelandet.

Typ:TimeSpan
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

Parametern DefaultProfile fungerar inte. Använd parametern SubscriptionId när den är tillgänglig om du kör cmdleten mot en annan prenumeration.

Typ:PSObject
Alias:AzureRMContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DuplicateDetectionHistoryTimeWindow

Definierar varaktigheten för dubblettidentifieringshistoriken. Standardvärdet är 10 minuter.

Typ:TimeSpan
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-EnableBatchedOperations

Värde som anger om batchåtgärder på serversidan är aktiverade.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-EnableExpress

Ett värde som anger om Express Entiteter är aktiverade. En expresskö innehåller ett meddelande i minnet tillfälligt innan det skrivs till beständig lagring.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-EnablePartitioning

Ett värde som anger om kön ska partitioneras över flera meddelandeköer.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ForwardDeadLetteredMessagesTo

Kö-/ämnesnamn för att vidarebefordra meddelandet Med obeställbara meddelanden

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ForwardTo

Kö-/ämnesnamn för vidarebefordran av meddelanden

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-LockDuration

Tidsintervall för ett peek-lock; det vill: hur lång tid meddelandet är låst för andra mottagare. Det maximala värdet för LockDuration är 5 minuter. standardvärdet är 1 minut.

Typ:TimeSpan
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-MaxDeliveryCount

Maximalt antal leveranser. Ett meddelande dödas automatiskt efter det här antalet leveranser. standardvärdet är 10.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-MaxMessageSizeInKilobytes

Maximal storlek (i KB) för meddelandenyttolasten som kan accepteras av kön. Den här egenskapen används endast i Premium idag och standardvärdet är 1024.

Typ:Int64
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-MaxSizeInMegabytes

Den maximala storleken på kön i megabyte, vilket är storleken på det minne som allokerats för kön. Standardvärdet är 1024.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Name

Könamnet.

Typ:String
Alias:QueueName
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-NamespaceInputObject

Identitetsparameter

Typ:IServiceBusIdentity
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-NamespaceName

Namnområdesnamnet

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Parameter

Beskrivning av köresurs.

Typ:ISbQueue
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-RequiresDuplicateDetection

Ett värde som anger om den här kön kräver dubblettidentifiering.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-RequiresSession

Ett värde som anger om kön stöder begreppet sessioner.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ResourceGroupName

Namnet på resursgruppen i Azure-prenumerationen.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Status

Räknar upp möjliga värden för status för en meddelandeentitet.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SubscriptionId

Prenumerationsautentiseringsuppgifter som unikt identifierar en Microsoft Azure-prenumeration. Prenumerations-ID:t utgör en del av URI:n för varje tjänstanrop.

Typ:String
Position:Named
Standardvärde:(Get-AzContext).Subscription.Id
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

ISbQueue

IServiceBusIdentity

Utdata

ISbQueue