New-AzEventGridNamespaceTopicEventSubscription

  • Riferimento
Modulo:
Az.EventGrid

Creare in modo asincrono una sottoscrizione di eventi di un argomento dello spazio dei nomi con i parametri specificati. Le sottoscrizioni di eventi esistenti verranno aggiornate con questa API.

Sintassi

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>]

Descrizione

Creare in modo asincrono una sottoscrizione di eventi di un argomento dello spazio dei nomi con i parametri specificati. Le sottoscrizioni di eventi esistenti verranno aggiornate con questa API.

Esempio

Esempio 1: Creare in modo asincrono una sottoscrizione di eventi di un argomento dello spazio dei nomi con i parametri specificati.

$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

Creare in modo asincrono una sottoscrizione di eventi di un argomento dello spazio dei nomi con i parametri specificati. Le sottoscrizioni di eventi esistenti verranno aggiornate con questa API.

Parametri

-AsJob

Eseguire il comando come processo

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

Il parametro DefaultProfile non è funzionale. Usare il parametro SubscriptionId quando disponibile se si esegue il cmdlet su una sottoscrizione diversa.

Tipo:PSObject
Alias:AzureRMContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DeliveryConfigurationDeliveryMode

Modalità di recapito della sottoscrizione di eventi.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EventDeliverySchema

Schema di recapito degli eventi per la sottoscrizione di eventi.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EventSubscriptionName

Nome della sottoscrizione di eventi da creare. I nomi delle sottoscrizioni di eventi devono avere una lunghezza compresa tra 3 e 100 caratteri e usare solo lettere alfanumerici.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-FilterConfigurationFilter

Matrice di filtri usati per filtrare le sottoscrizioni di eventi.

Tipo:IFilter[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-FilterConfigurationIncludedEventType

Elenco dei tipi di evento applicabili che devono far parte della sottoscrizione di eventi. Se si desidera sottoscrivere tutti i tipi di evento predefiniti, impostare IncludedEventTypes su null.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-IdentityType

Tipo di identità gestita usata. Il tipo 'SystemAssigned, UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo 'Nessuno' rimuoverà qualsiasi identità.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Parametro Identity

Tipo:IEventGridIdentity
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-JsonFilePath

Percorso del file JSON fornito all'operazione di creazione

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-JsonString

Stringa JSON fornita all'operazione di creazione

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NamespaceInputObject

Parametro Identity

Tipo:IEventGridIdentity
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-NamespaceName

Nome dello spazio dei nomi.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NoWait

Eseguire il comando in modo asincrono

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-QueueEventTimeToLive

Durata dell'intervallo di tempo nel formato ISO 8601 che determina per quanto tempo i messaggi sono disponibili per la sottoscrizione dal momento in cui il messaggio è stato pubblicato. Questo valore di durata viene espresso usando il formato seguente: 'P(n)Y(n)M(n)DT(n)H(n)M(n)S', dove: - (n) viene sostituito dal valore di ogni elemento temporale che segue (n).

  • P è l'operatore di durata (o periodo) e viene sempre posizionato all'inizio della durata.
  • Y è l'iniziatore dell'anno e segue il valore per il numero di anni.
  • M è l'iniziatore del mese e segue il valore per il numero di mesi.
  • W è l'iniziatore della settimana e segue il valore per il numero di settimane.
  • D è l'iniziatore del giorno e segue il valore per il numero di giorni.
  • T è l'iniziatore dell'ora e precede i componenti dell'ora.
  • H è l'operatore di progettazione dell'ora e segue il valore per il numero di ore.
  • M è l'iniziatore dei minuti e segue il valore per il numero di minuti.
  • S è il secondo designatore e segue il valore per il numero di secondi. Questo valore di durata non può essere impostato maggiore di EventRetentionInDays dell'argomento. Si tratta di un campo facoltativo in cui il valore minimo è 1 minuto e il valore massimo è determinato dal valore EventRetentionInDays dell'argomento. Di seguito sono riportati esempi di valori validi: - 'P0DT23H12M' o 'PT23H12M': per durata di 23 ore e 12 minuti.
  • 'P1D' o 'P1DT0H0M0S': per la durata di 1 giorno.
Tipo:TimeSpan
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-QueueMaxDeliveryCount

Numero massimo di recapito degli eventi.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-QueueReceiveLockDurationInSecond

Periodo massimo in secondi in cui il messaggio viene ricevuto (dal client) e in attesa di essere accettato, rilasciato o rifiutato. Se questo tempo è trascorso dopo che un messaggio è stato ricevuto dal client e non è stato convertito in accettato (non elaborato), rilasciato o rifiutato, il messaggio è disponibile per la fase di rollforward. Si tratta di un campo facoltativo, in cui il valore predefinito è 60 secondi, minimo è 60 secondi e massimo è 300 secondi.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ResourceGroupName

Nome del gruppo di risorse all'interno della sottoscrizione dell'utente.

Tipo:String
Alias:ResourceGroup
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SubscriptionId

Credenziali di sottoscrizione che identificano in modo univoco una sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata di servizio.

Tipo:String
Posizione:Named
Valore predefinito:(Get-AzContext).Subscription.Id
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TopicInputObject

Parametro Identity

Tipo:IEventGridIdentity
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-TopicName

Nome dell'argomento dello spazio dei nomi.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UserAssignedIdentity

Identità utente associata alla risorsa.

Tipo:String
Alias:IdentityId
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

IEventGridIdentity

Output

ISubscription