Sdílet prostřednictvím

New-AzServiceBusSubscription

  • Reference
Modul:
Az.ServiceBus

Vytvořte odběr tématu.

Syntaxe

New-AzServiceBusSubscription
   -Name <String>
   -NamespaceName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -TopicName <String>
   [-AutoDeleteOnIdle <TimeSpan>]
   [-ClientId <String>]
   [-DeadLetteringOnFilterEvaluationException]
   [-DeadLetteringOnMessageExpiration]
   [-DefaultMessageTimeToLive <TimeSpan>]
   [-DuplicateDetectionHistoryTimeWindow <TimeSpan>]
   [-EnableBatchedOperations]
   [-ForwardDeadLetteredMessagesTo <String>]
   [-ForwardTo <String>]
   [-IsClientAffine]
   [-IsDurable]
   [-IsShared]
   [-LockDuration <TimeSpan>]
   [-MaxDeliveryCount <Int32>]
   [-RequiresSession]
   [-Status <String>]
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzServiceBusSubscription
   -Name <String>
   -TopicName <String>
   -NamespaceInputObject <IServiceBusIdentity>
   [-AutoDeleteOnIdle <TimeSpan>]
   [-ClientId <String>]
   [-DeadLetteringOnFilterEvaluationException]
   [-DeadLetteringOnMessageExpiration]
   [-DefaultMessageTimeToLive <TimeSpan>]
   [-DuplicateDetectionHistoryTimeWindow <TimeSpan>]
   [-EnableBatchedOperations]
   [-ForwardDeadLetteredMessagesTo <String>]
   [-ForwardTo <String>]
   [-IsClientAffine]
   [-IsDurable]
   [-IsShared]
   [-LockDuration <TimeSpan>]
   [-MaxDeliveryCount <Int32>]
   [-RequiresSession]
   [-Status <String>]
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzServiceBusSubscription
   -Name <String>
   -TopicName <String>
   -NamespaceInputObject <IServiceBusIdentity>
   -Parameter <ISbSubscription>
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzServiceBusSubscription
   -Name <String>
   -TopicInputObject <IServiceBusIdentity>
   [-AutoDeleteOnIdle <TimeSpan>]
   [-ClientId <String>]
   [-DeadLetteringOnFilterEvaluationException]
   [-DeadLetteringOnMessageExpiration]
   [-DefaultMessageTimeToLive <TimeSpan>]
   [-DuplicateDetectionHistoryTimeWindow <TimeSpan>]
   [-EnableBatchedOperations]
   [-ForwardDeadLetteredMessagesTo <String>]
   [-ForwardTo <String>]
   [-IsClientAffine]
   [-IsDurable]
   [-IsShared]
   [-LockDuration <TimeSpan>]
   [-MaxDeliveryCount <Int32>]
   [-RequiresSession]
   [-Status <String>]
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzServiceBusSubscription
   -Name <String>
   -TopicInputObject <IServiceBusIdentity>
   -Parameter <ISbSubscription>
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Vytvořte odběr tématu.

Příklady

Příklad 1: Vytvoření nového předplatného ServiceBus

New-AzServiceBusSubscription -ResourceGroupName myResourceGroup -NamespaceName myNamespace -TopicName myTopic -Name mySubscription -DefaultMessageTimeToLive (New-TimeSpan -Days 6) -EnableBatchedOperations

AccessedAt                                : 1/1/0001 12:00:00 AM
AutoDeleteOnIdle                          : 10675199.02:48:05.4775807
ClientId                                  :
CountDetailActiveMessageCount             : 0
CountDetailDeadLetterMessageCount         : 0
CountDetailScheduledMessageCount          : 0
CountDetailTransferDeadLetterMessageCount : 0
CountDetailTransferMessageCount           : 0
CreatedAt                                 : 9/23/2022 2:37:46 PM
DeadLetteringOnFilterEvaluationException  : True
DeadLetteringOnMessageExpiration          : False
DefaultMessageTimeToLive                  : 6.00:00:00
DuplicateDetectionHistoryTimeWindow       :
EnableBatchedOperations                   : True
ForwardDeadLetteredMessagesTo             :
ForwardTo                                 :
Id                                        : /subscriptions/326100e2-f69d-4268-8503-075374f62b6e/resourceGroups/damorg/providers/Microsoft.ServiceBus/namespaces/testlatests
                                            bmsi/topics/a/subscriptions/testsub
IsClientAffine                            : False
IsDurable                                 :
IsShared                                  :
Location                                  : westus
LockDuration                              : 00:01:00
MaxDeliveryCount                          : 10
MessageCount                              : 0
Name                                      : testsub
RequiresSession                           : False
ResourceGroupName                         : damorg
Status                                    : Active

Vytvoří nové předplatné ServiceBus mySubscription v tématu myTopic.

Parametry

-AutoDeleteOnIdle

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

Typ:TimeSpan
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ClientId

Označuje ID klienta aplikace, která vytvořila předplatné client-affine.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Confirm

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

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DeadLetteringOnFilterEvaluationException

Hodnota, která označuje, jestli má předplatné podporu nedoručených dopisů u výjimek vyhodnocení filtru.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DeadLetteringOnMessageExpiration

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

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultMessageTimeToLive

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.

Typ:TimeSpan
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

Parametr DefaultProfile není funkční. Pokud je k dispozici spuštění rutiny pro jiné předplatné, použijte parametr SubscriptionId.

Typ:PSObject
Aliasy:AzureRMContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DuplicateDetectionHistoryTimeWindow

Definuje dobu trvání historie detekce duplicit. Výchozí hodnota je 10 minut.

Typ:TimeSpan
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-EnableBatchedOperations

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

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ForwardDeadLetteredMessagesTo

Název fronty nebo tématu pro přeposlání zprávy o nedoručených zprávách

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ForwardTo

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

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-IsClientAffine

Hodnota, která označuje, jestli má předplatné spřažení s ID klienta.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-IsDurable

U předplatných typu klient-affine označuje tato hodnota, jestli je předplatné trvalé nebo ne.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-IsShared

U předplatných typu klient-affine označuje tato hodnota, jestli je předplatné sdílené, nebo ne.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-LockDuration

Doba trvání náhledu 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.

Typ:TimeSpan
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-MaxDeliveryCount

Početmaximálních

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

Název předplatného.

Typ:String
Aliasy:SubscriptionName
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-NamespaceInputObject

Parametr identity

Typ:IServiceBusIdentity
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-NamespaceName

Název oboru názvů

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Parameter

Popis prostředku předplatného

Typ:ISbSubscription
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-RequiresSession

Hodnota označující, jestli předplatné podporuje koncept relací.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ResourceGroupName

Název skupiny prostředků v rámci předplatného Azure

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Status

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

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SubscriptionId

Přihlašovací údaje předplatného, které jednoznačně identifikují předplatné Microsoft Azure. ID předplatného tvoří součást identifikátoru URI pro každé volání služby.

Typ:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-TopicInputObject

Parametr identity

Typ:IServiceBusIdentity
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-TopicName

Název tématu.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

ISbSubscription

IServiceBusIdentity

Výstupy

ISbSubscription