Dela via


New-AzEventGridNamespaceTopicEventSubscription

Skapar eller uppdaterar asynkront en händelseprenumeration för ett namnområdesämne med de angivna parametrarna. Befintliga händelseprenumerationer uppdateras med det här API:et.

Syntax

New-AzEventGridNamespaceTopicEventSubscription
   -EventSubscriptionName <String>
   -NamespaceName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -TopicName <String>
   [-DeliveryConfigurationDeliveryMode <String>]
   [-EventDeliverySchema <String>]
   [-FilterConfigurationFilter <IFilter[]>]
   [-FilterConfigurationIncludedEventType <String[]>]
   [-IdentityType <String>]
   [-QueueEventTimeToLive <TimeSpan>]
   [-QueueMaxDeliveryCount <Int32>]
   [-QueueReceiveLockDurationInSecond <Int32>]
   [-UserAssignedIdentity <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzEventGridNamespaceTopicEventSubscription
   -EventSubscriptionName <String>
   -NamespaceName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -TopicName <String>
   -JsonString <String>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzEventGridNamespaceTopicEventSubscription
   -EventSubscriptionName <String>
   -NamespaceName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -TopicName <String>
   -JsonFilePath <String>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzEventGridNamespaceTopicEventSubscription
   -EventSubscriptionName <String>
   -TopicInputObject <IEventGridIdentity>
   [-DeliveryConfigurationDeliveryMode <String>]
   [-EventDeliverySchema <String>]
   [-FilterConfigurationFilter <IFilter[]>]
   [-FilterConfigurationIncludedEventType <String[]>]
   [-IdentityType <String>]
   [-QueueEventTimeToLive <TimeSpan>]
   [-QueueMaxDeliveryCount <Int32>]
   [-QueueReceiveLockDurationInSecond <Int32>]
   [-UserAssignedIdentity <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzEventGridNamespaceTopicEventSubscription
   -EventSubscriptionName <String>
   -TopicName <String>
   -NamespaceInputObject <IEventGridIdentity>
   [-DeliveryConfigurationDeliveryMode <String>]
   [-EventDeliverySchema <String>]
   [-FilterConfigurationFilter <IFilter[]>]
   [-FilterConfigurationIncludedEventType <String[]>]
   [-IdentityType <String>]
   [-QueueEventTimeToLive <TimeSpan>]
   [-QueueMaxDeliveryCount <Int32>]
   [-QueueReceiveLockDurationInSecond <Int32>]
   [-UserAssignedIdentity <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzEventGridNamespaceTopicEventSubscription
   -InputObject <IEventGridIdentity>
   [-DeliveryConfigurationDeliveryMode <String>]
   [-EventDeliverySchema <String>]
   [-FilterConfigurationFilter <IFilter[]>]
   [-FilterConfigurationIncludedEventType <String[]>]
   [-IdentityType <String>]
   [-QueueEventTimeToLive <TimeSpan>]
   [-QueueMaxDeliveryCount <Int32>]
   [-QueueReceiveLockDurationInSecond <Int32>]
   [-UserAssignedIdentity <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Skapar eller uppdaterar asynkront en händelseprenumeration för ett namnområdesämne med de angivna parametrarna. Befintliga händelseprenumerationer uppdateras med det här API:et.

Exempel

Exempel 1: Asynkront Skapa en händelseprenumeration för ett namnområdesämne med de angivna parametrarna.

$TimeSpan = New-TimeSpan -Hours 1 -Minutes 25
New-AzEventGridNamespaceTopicEventSubscription -EventSubscriptionName azps-eventsubname -NamespaceName azps-eventgridnamespace -ResourceGroupName azps_test_group_eventgrid -TopicName azps-topic -DeliveryConfigurationDeliveryMode Queue -QueueReceiveLockDurationInSecond 60 -QueueMaxDeliveryCount 4 -QueueEventTimeToLive $TimeSpan -EventDeliverySchema CloudEventSchemaV1_0

Name              ResourceGroupName
----              -----------------
azps-eventsubname azps_test_group_eventgrid

Asynkront Skapa en händelseprenumeration för ett namnområdesämne med de angivna parametrarna. Befintliga händelseprenumerationer uppdateras med det här API:et.

Parametrar

-AsJob

Kör kommandot som ett jobb

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

-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

-DeliveryConfigurationDeliveryMode

Leveransläge för händelseprenumerationen.

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

-EventDeliverySchema

Händelseleveransschemat för händelseprenumerationen.

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

-EventSubscriptionName

Namnet på den händelseprenumeration som ska skapas. Namn på händelseprenumerationer måste vara mellan 3 och 100 tecken långa och endast använda alfanumeriska bokstäver.

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

-FilterConfigurationFilter

En matris med filter som används för att filtrera händelseprenumerationer.

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

-FilterConfigurationIncludedEventType

En lista över tillämpliga händelsetyper som måste ingå i händelseprenumerationen. Om du vill prenumerera på alla standardhändelsetyper anger du IncludedEventTypes till null.

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

-IdentityType

Den typ av hanterad identitet som används. Typen "SystemAssigned, UserAssigned" innehåller både en implicit skapad identitet och en uppsättning användartilldelade identiteter. Typen "Ingen" tar bort alla identiteter.

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

-InputObject

Identitetsparameter

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

-JsonFilePath

Sökväg till Json-fil som angetts för åtgärden Skapa

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

-JsonString

Json-sträng som har angetts för åtgärden Skapa

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

-NamespaceInputObject

Identitetsparameter

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

-NamespaceName

Namnområdets namnområde.

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

-NoWait

Kör kommandot asynkront

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

-QueueEventTimeToLive

Varaktighet för tidsperiod i ISO 8601-format som avgör hur länge meddelanden är tillgängliga för prenumerationen från den tidpunkt då meddelandet publicerades. Det här varaktighetsvärdet uttrycks med följande format: "P(n)Y(n)M(n)DT(n)H(n)M(n)S", där: - (n) ersätts med värdet för varje tidselement som följer (n).

  • P är designatorn för varaktighet (eller period) och placeras alltid i början av varaktigheten.
  • Y är årets designator och följer värdet för antalet år.
  • M är månadsdesignaren och den följer värdet för antalet månader.
  • W är veckans designator och den följer värdet för antalet veckor.
  • D är dagdesignaren och följer värdet för antalet dagar.
  • T är tidsdesignaren och den föregår tidskomponenterna.
  • H är timdesignatorn och den följer värdet för antalet timmar.
  • M är minutdesignaren och följer värdet för antalet minuter.
  • S är den andra designatorn och följer värdet för antalet sekunder. Det här varaktighetsvärdet kan inte anges som större än ämnets EventRetentionInDays. Det är ett valfritt fält där dess minsta värde är 1 minut och dess maxvärde bestäms av ämnets EventRetentionInDays-värde. Följande är exempel på giltiga värden: - "P0DT23H12M" eller "PT23H12M": under 23 timmar och 12 minuter.
  • "P1D" eller "P1DT0H0M0S": under en dag.
Typ:TimeSpan
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-QueueMaxDeliveryCount

Det maximala leveransantalet för händelserna.

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

-QueueReceiveLockDurationInSecond

Maximal period i sekunder då meddelandet har tagits emot (av klienten) och väntar på att accepteras, släppas eller avvisas. Om den här tiden förflutit efter att ett meddelande har tagits emot av klienten och inte övergått till godkänd (inte bearbetad), släppt eller avvisad, är meddelandet tillgängligt för omleverans. Det här är ett valfritt fält där standardvärdet är 60 sekunder, minst 60 sekunder och högst 300 sekunder.

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

-ResourceGroupName

Namnet på resursgruppen i användarens prenumeration.

Typ:String
Alias:ResourceGroup
Position:Named
Standardvärde:None
Obligatorisk:True
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:IEventGridIdentity
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-TopicName

Namn på namnområdesämnet.

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

-UserAssignedIdentity

Användaridentiteten som är associerad med resursen.

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. 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

IEventGridIdentity

Utdata

ISubscription