Update-AzEventGridSubscription

  • Riferimento
Modulo:
Az.EventGrid

Aggiorna in modo asincrono una sottoscrizione di eventi esistente.

Sintassi

Update-AzEventGridSubscription
      -Name <String>
      -Scope <String>
      [-DeadLetterWithResourceIdentityType <String>]
      [-DeadLetterWithResourceIdentityUserAssignedIdentity <String>]
      [-DeliveryWithResourceIdentityDestination <IEventSubscriptionDestination>]
      [-DeliveryWithResourceIdentityType <String>]
      [-DeliveryWithResourceIdentityUserAssignedIdentity <String>]
      [-Destination <IEventSubscriptionDestination>]
      [-EventDeliverySchema <String>]
      [-ExpirationTimeUtc <DateTime>]
      [-FilterAdvancedFilter <IAdvancedFilter[]>]
      [-FilterEnableAdvancedFilteringOnArray]
      [-FilterIncludedEventType <String[]>]
      [-FilterIsSubjectCaseSensitive]
      [-FilterSubjectBeginsWith <String>]
      [-FilterSubjectEndsWith <String>]
      [-Label <String[]>]
      [-RetryPolicyEventTimeToLiveInMinute <Int32>]
      [-RetryPolicyMaxDeliveryAttempt <Int32>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzEventGridSubscription
      -Name <String>
      -Scope <String>
      -JsonString <String>
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzEventGridSubscription
      -Name <String>
      -Scope <String>
      -JsonFilePath <String>
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzEventGridSubscription
      -InputObject <IEventGridIdentity>
      [-DeadLetterWithResourceIdentityType <String>]
      [-DeadLetterWithResourceIdentityUserAssignedIdentity <String>]
      [-DeliveryWithResourceIdentityDestination <IEventSubscriptionDestination>]
      [-DeliveryWithResourceIdentityType <String>]
      [-DeliveryWithResourceIdentityUserAssignedIdentity <String>]
      [-Destination <IEventSubscriptionDestination>]
      [-EventDeliverySchema <String>]
      [-ExpirationTimeUtc <DateTime>]
      [-FilterAdvancedFilter <IAdvancedFilter[]>]
      [-FilterEnableAdvancedFilteringOnArray]
      [-FilterIncludedEventType <String[]>]
      [-FilterIsSubjectCaseSensitive]
      [-FilterSubjectBeginsWith <String>]
      [-FilterSubjectEndsWith <String>]
      [-Label <String[]>]
      [-RetryPolicyEventTimeToLiveInMinute <Int32>]
      [-RetryPolicyMaxDeliveryAttempt <Int32>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Descrizione

Aggiorna in modo asincrono una sottoscrizione di eventi esistente.

Esempio

Esempio 1: aggiorna in modo asincrono una sottoscrizione di eventi esistente.

$obj = New-AzEventGridWebHookEventSubscriptionDestinationObject -EndpointUrl "https://azpsweb.azurewebsites.net/api/updates"
Update-AzEventGridSubscription -Name azps-eventsub -Scope "subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" -Destination $obj -FilterIsSubjectCaseSensitive:$false

Name          ResourceGroupName
----          -----------------
azps-eventsub

Aggiorna in modo asincrono una sottoscrizione di eventi esistente.

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

-DeadLetterWithResourceIdentityType

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

-DeadLetterWithResourceIdentityUserAssignedIdentity

Identità utente associata alla risorsa.

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

-DeliveryWithResourceIdentityDestination

Informazioni sulla destinazione in cui devono essere recapitati gli eventi per la sottoscrizione di eventi. Usa l'identità di Griglia di eventi di Azure per acquisire i token di autenticazione usati durante il recapito o l'invio di messaggi non recapitabili.

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

-DeliveryWithResourceIdentityType

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

-DeliveryWithResourceIdentityUserAssignedIdentity

Identità utente associata alla risorsa.

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

-Destination

Informazioni sulla destinazione in cui devono essere recapitati gli eventi per la sottoscrizione di eventi. Usa l'identità di Griglia di eventi di Azure per acquisire i token di autenticazione usati durante il recapito o l'invio di messaggi non recapitabili.

Tipo:IEventSubscriptionDestination
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
Alias:DeliverySchema
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ExpirationTimeUtc

Informazioni sull'ora di scadenza per la sottoscrizione di eventi.

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

-FilterAdvancedFilter

Matrice di filtri avanzati usati per filtrare le sottoscrizioni di eventi.

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

-FilterEnableAdvancedFilteringOnArray

Consente di valutare i filtri avanzati rispetto a una matrice di valori anziché prevedere un valore singolare.

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

-FilterIncludedEventType

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[]
Alias:IncludedEventType
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-FilterIsSubjectCaseSensitive

Specifica se le proprietà SubjectBeginsWith e SubjectEndsWith dei filtri devono essere confrontate in modo con distinzione tra maiuscole e minuscole.

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

-FilterSubjectBeginsWith

Stringa facoltativa per filtrare gli eventi per una sottoscrizione di eventi in base al prefisso di un percorso della risorsa. Il formato di questo dipende dall'autore degli eventi. I caratteri jolly non sono supportati in questo percorso.

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

-FilterSubjectEndsWith

Stringa facoltativa per filtrare gli eventi per una sottoscrizione di eventi in base al suffisso del percorso della risorsa. I caratteri jolly non sono supportati in questo percorso.

Tipo:String
Alias:SubjectEndsWith
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 aggiornamento

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 aggiornamento

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

-Label

Elenco di etichette definite dall'utente.

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

-Name

Nome della sottoscrizione di eventi da aggiornare.

Tipo:String
Alias:EventSubscriptionName
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

-PassThru

Restituisce true quando il comando ha esito positivo

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

-RetryPolicyEventTimeToLiveInMinute

Durata (in minuti) per gli eventi.

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

-RetryPolicyMaxDeliveryAttempt

Numero massimo di tentativi di recapito per gli eventi.

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

-Scope

Ambito della sottoscrizione di eventi esistente. L'ambito può essere una sottoscrizione, un gruppo di risorse o una risorsa di primo livello appartenente a uno spazio dei nomi del provider di risorse o un argomento EventGrid. Ad esempio, usare '/subscriptions/{subscriptionId}/' per una sottoscrizione, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' per un gruppo di risorse, e '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}' per una risorsa e '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/topics/{topicName}' per un argomento EventGrid.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
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

IEventSubscription