Dela via

New-AzServiceBusSubscription

  • Referens
Modul:
Az.ServiceBus

Skapa en ämnesprenumeration.

Syntax

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

Skapa en ämnesprenumeration.

Exempel

Exempel 1: Skapa en ny ServiceBus-prenumeration

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

Skapar en ny ServiceBus-prenumeration mySubscription under ämne myTopic.

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

-ClientId

Anger klient-ID för programmet som skapade klientaffinprenumerationen.

Typ:String
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

-DeadLetteringOnFilterEvaluationException

Värde som anger om en prenumeration har stöd för obeställbara filtreringsutvärderingar.

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

-DeadLetteringOnMessageExpiration

Värde som anger om en prenumeration 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

-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

-IsClientAffine

Värde som anger om prenumerationen har en tillhörighet till klient-ID:t.

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

-IsDurable

För klientaffinprenumerationer anger det här värdet om prenumerationen är beständig eller inte.

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

-IsShared

För klientaffinprenumerationer anger det här värdet om prenumerationen delas eller inte.

Typ:SwitchParameter
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

Antal maximala leveranser.

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

-Name

Prenumerationsnamnet.

Typ:String
Alias:SubscriptionName
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 prenumerationsresurs.

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

-RequiresSession

Värde som anger om en prenumeration 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

-TopicInputObject

Identitetsparameter

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

-TopicName

Ämnesnamnet.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
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

ISbSubscription

IServiceBusIdentity

Utdata

ISbSubscription