Sdílet prostřednictvím


Set-AzServiceBusQueue

Aktualizace fronty ServiceBus

Syntax

SetExpanded (Výchozí)

Set-AzServiceBusQueue
    -Name <String>
    -NamespaceName <String>
    -ResourceGroupName <String>
    [-SubscriptionId <String>]
    [-AutoDeleteOnIdle <TimeSpan>]
    [-DefaultMessageTimeToLive <TimeSpan>]
    [-DuplicateDetectionHistoryTimeWindow <TimeSpan>]
    [-LockDuration <TimeSpan>]
    [-DeadLetteringOnMessageExpiration]
    [-EnableBatchedOperations]
    [-EnableExpress]
    [-ForwardTo <String>]
    [-ForwardDeadLetteredMessagesTo <String>]
    [-MaxDeliveryCount <Int32>]
    [-MaxSizeInMegabytes <Int32>]
    [-MaxMessageSizeInKilobytes <Int64>]
    [-Status <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetViaIdentityExpanded

Set-AzServiceBusQueue
    -InputObject <IServiceBusIdentity>
    [-AutoDeleteOnIdle <TimeSpan>]
    [-DefaultMessageTimeToLive <TimeSpan>]
    [-DuplicateDetectionHistoryTimeWindow <TimeSpan>]
    [-LockDuration <TimeSpan>]
    [-DeadLetteringOnMessageExpiration]
    [-EnableBatchedOperations]
    [-EnableExpress]
    [-ForwardTo <String>]
    [-ForwardDeadLetteredMessagesTo <String>]
    [-MaxDeliveryCount <Int32>]
    [-MaxSizeInMegabytes <Int32>]
    [-MaxMessageSizeInKilobytes <Int64>]
    [-Status <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Aktualizace fronty ServiceBus

Příklady

Příklad 1: Aktualizace fronty ServiceBus

Set-AzServiceBusQueue -ResourceGroupName myResourceGroup -NamespaceName myNamespace -Name myQueue -AutoDeleteOnIdle (New-TimeSpan -Days 4 -Minutes 3 -Seconds 4) -DefaultMessageTimeToLive (New-TimeSpan -Days 9)
AccessedAt                                : 1/1/0001 12:00:00 AM
AutoDeleteOnIdle                          : 4.00:03:04
CountDetailActiveMessageCount             : 0
CountDetailDeadLetterMessageCount         : 0
CountDetailScheduledMessageCount          : 0
CountDetailTransferDeadLetterMessageCount : 0
CountDetailTransferMessageCount           : 0
CreatedAt                                 : 9/22/2022 12:30:45 PM
DeadLetteringOnMessageExpiration          : False
DefaultMessageTimeToLive                  : 9.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

Aktualizuje parametry DefaultMessageTimeToLive, AutoDeleteOnIdle ve frontě myQueue ServiceBus v oboru názvů myNamespace.

Příklad 2: Aktualizace fronty ServiceBus pomocí sady parametrů InputObject

$queue = Get-AzServiceBusQueue -ResourceGroupName myResourceGroup -NamespaceName myNamespace -Name myQueue
Set-AzServiceBusQueue -InputObject $queue -AutoDeleteOnIdle (New-TimeSpan -Days 4 -Minutes 3 -Seconds 4) -DefaultMessageTimeToLive (New-TimeSpan -Days 9)
AccessedAt                                : 1/1/0001 12:00:00 AM
AutoDeleteOnIdle                          : 4.00:03:04
CountDetailActiveMessageCount             : 0
CountDetailDeadLetterMessageCount         : 0
CountDetailScheduledMessageCount          : 0
CountDetailTransferDeadLetterMessageCount : 0
CountDetailTransferMessageCount           : 0
CreatedAt                                 : 9/22/2022 12:30:45 PM
DeadLetteringOnMessageExpiration          : False
DefaultMessageTimeToLive                  : 9.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

Updates Parameters DefaultMessageTimeToLive, AutoDeleteOnIdle on a ServiceBus queue myQueue in namespace myNamespace using InputObject parameter set.

Parametry

-AsJob

Spuštění příkazu jako úlohy

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-AutoDeleteOnIdle

Interval nečinnosti timeSpan ISO 8061, po kterém se fronta automaticky odstraní. Minimální doba trvání je 5 minut.

Vlastnosti parametru

Typ:TimeSpan
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Confirm

Před spuštěním cmdletu vás vyzve k potvrzení.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:viz

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-DeadLetteringOnMessageExpiration

Hodnota, která označuje, jestli má tato fronta podporu nedoručených zpráv, když vyprší platnost zprávy.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-DefaultMessageTimeToLive

Výchozí časový rozsah zprávy ISO 8601 na hodnotu live. Jedná se o dobu, po které vyprší platnost zprávy, počínaje odesláním zprávy do služby Service Bus. Toto je výchozí hodnota použitá v případě, že TimeToLive není nastaven na samotnou zprávu.

Vlastnosti parametru

Typ:TimeSpan
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Vlastnosti parametru

Typ:PSObject
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:AzureRMContext, AzureCredential

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-DuplicateDetectionHistoryTimeWindow

Struktura ISO 8601 timeSpan, která definuje dobu trvání historie detekce duplicit. Výchozí hodnota je 10 minut.

Vlastnosti parametru

Typ:TimeSpan
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-EnableBatchedOperations

Hodnota označující, jestli jsou povolené dávkové operace na straně serveru.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-EnableExpress

Hodnota, která označuje, jestli jsou povolené expresní entity. Expresní fronta uchovává zprávu dočasně v paměti před zápisem do trvalého úložiště.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-ForwardDeadLetteredMessagesTo

Hodnota, která označuje, jestli fronta podporuje koncept relací.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-ForwardTo

Název fronty nebo tématu pro přeposílání zpráv

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-InputObject

Parametr identity. Chcete-li vytvořit, přečtěte si část NOTES pro vlastnosti INPUTOBJECT a vytvořte tabulku hash.

Vlastnosti parametru

Typ:IServiceBusIdentity
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

SetViaIdentityExpanded
Position:Named
Povinné:True
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-LockDuration

Doba trvání časového intervalu ISO 8601 pro náhled zámku; to znamená, že doba, po kterou je zpráva uzamčena pro ostatní příjemce. Maximální hodnota lockDuration je 5 minut; výchozí hodnota je 1 minuta.

Vlastnosti parametru

Typ:TimeSpan
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-MaxDeliveryCount

Maximální počet doručení. Po tomto počtu dodávek se zpráva automaticky zamřená. výchozí hodnota je 10.

Vlastnosti parametru

Typ:Int32
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-MaxMessageSizeInKilobytes

Maximální velikost datové části zprávy (v kB), kterou může fronta přijmout. Tato vlastnost se dnes používá jenom v Premium a výchozí hodnota je 1024.

Vlastnosti parametru

Typ:Int64
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-MaxSizeInMegabytes

Maximální počet doručení. Po tomto počtu dodávek se zpráva automaticky zamřená. výchozí hodnota je 10.

Vlastnosti parametru

Typ:Int32
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Name

Název fronty.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:QueueName

Sady parametrů

SetExpanded
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-NamespaceName

Název oboru názvů ServiceBus

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

SetExpanded
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-NoWait

Asynchronní spuštění příkazu

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-ResourceGroupName

Název skupiny prostředků. Název nerozlišuje malá a velká písmena.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

SetExpanded
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Status

Vytvoří výčet možných hodnot pro stav entity zasílání zpráv.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-SubscriptionId

ID cílového předplatného.

Vlastnosti parametru

Typ:String
Default value:(Get-AzContext).Subscription.Id
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

SetExpanded
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Wi

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

IServiceBusIdentity

Výstupy

ISbQueue