Compartir a través de


Update-AzEventGridTopicEventSubscription

Actualice una suscripción de eventos existente para un tema.

Sintaxis

Update-AzEventGridTopicEventSubscription
      -EventSubscriptionName <String>
      -ResourceGroupName <String>
      [-SubscriptionId <String>]
      -TopicName <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-AzEventGridTopicEventSubscription
      -EventSubscriptionName <String>
      -ResourceGroupName <String>
      [-SubscriptionId <String>]
      -TopicName <String>
      -JsonString <String>
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzEventGridTopicEventSubscription
      -EventSubscriptionName <String>
      -ResourceGroupName <String>
      [-SubscriptionId <String>]
      -TopicName <String>
      -JsonFilePath <String>
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzEventGridTopicEventSubscription
      -EventSubscriptionName <String>
      -TopicInputObject <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>]
Update-AzEventGridTopicEventSubscription
      -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>]

Description

Actualice una suscripción de eventos existente para un tema.

Ejemplos

Ejemplo 1: Actualizar una suscripción de eventos existente para un tema.

$obj = New-AzEventGridWebHookEventSubscriptionDestinationObject -EndpointUrl "https://azpsweb.azurewebsites.net/api/updates"
Update-AzEventGridTopicEventSubscription -EventSubscriptionName azps-eventsub -ResourceGroupName azps_test_group_eventgrid -TopicName azps-topic -FilterIsSubjectCaseSensitive:$false -FilterSubjectBeginsWith "ExamplePrefix" -FilterSubjectEndsWith "ExampleSuffix" -EventDeliverySchema CloudEventSchemaV1_0 -Destination $obj

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

Actualice una suscripción de eventos existente para un tema.

Parámetros

-AsJob

Ejecución del comando como trabajo

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DeadLetterWithResourceIdentityType

Tipo de identidad administrada usada. El tipo "SystemAssigned, UserAssigned" incluye una identidad creada implícitamente y un conjunto de identidades asignadas por el usuario. El tipo "None" quitará cualquier identidad.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DeadLetterWithResourceIdentityUserAssignedIdentity

Identidad de usuario asociada al recurso.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultProfile

El parámetro DefaultProfile no es funcional. Use el parámetro SubscriptionId cuando esté disponible si ejecuta el cmdlet en otra suscripción.

Tipo:PSObject
Alias:AzureRMContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DeliveryWithResourceIdentityDestination

Información sobre el destino en el que se deben entregar los eventos para la suscripción de eventos. Usa la identidad de Azure Event Grid para adquirir los tokens de autenticación que se usan durante la entrega o mensajes fallidos.

Tipo:IEventSubscriptionDestination
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DeliveryWithResourceIdentityType

Tipo de identidad administrada usada. El tipo "SystemAssigned, UserAssigned" incluye una identidad creada implícitamente y un conjunto de identidades asignadas por el usuario. El tipo "None" quitará cualquier identidad.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DeliveryWithResourceIdentityUserAssignedIdentity

Identidad de usuario asociada al recurso.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Destination

Información sobre el destino en el que se deben entregar los eventos para la suscripción de eventos. Usa la identidad de Azure Event Grid para adquirir los tokens de autenticación que se usan durante la entrega o mensajes fallidos.

Tipo:IEventSubscriptionDestination
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EventDeliverySchema

Esquema de entrega de eventos para la suscripción de eventos.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EventSubscriptionName

Nombre de la suscripción de eventos que se va a actualizar.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ExpirationTimeUtc

Información sobre la hora de expiración de la suscripción de eventos.

Tipo:DateTime
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-FilterAdvancedFilter

Matriz de filtros avanzados que se usan para filtrar suscripciones de eventos.

Tipo:IAdvancedFilter[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-FilterEnableAdvancedFilteringOnArray

Permite evaluar filtros avanzados en una matriz de valores en lugar de esperar un valor singular.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-FilterIncludedEventType

Lista de tipos de eventos aplicables que deben formar parte de la suscripción de eventos. Si desea suscribirse a todos los tipos de eventos predeterminados, establezca IncludedEventTypes en null.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-FilterIsSubjectCaseSensitive

Especifica si las propiedades SubjectBeginsWith y SubjectEndsWith de los filtros se deben comparar de forma confidencial entre mayúsculas y minúsculas.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-FilterSubjectBeginsWith

Cadena opcional para filtrar eventos de una suscripción de eventos en función de un prefijo de ruta de acceso de recurso. El formato de esto depende del publicador de los eventos. Los caracteres comodín no se admiten en esta ruta de acceso.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-FilterSubjectEndsWith

Cadena opcional para filtrar eventos de una suscripción de eventos en función de un sufijo de ruta de acceso de recurso. Los caracteres comodín no se admiten en esta ruta de acceso.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InputObject

Parámetro de identidad

Tipo:IEventGridIdentity
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-JsonFilePath

Ruta de acceso del archivo Json proporcionado a la operación de actualización

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-JsonString

Cadena JSON proporcionada a la operación de actualización

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Label

Lista de etiquetas definidas por el usuario.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-NoWait

Ejecutar el comando de forma asincrónica

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PassThru

Devuelve true cuando el comando se ejecuta correctamente.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ResourceGroupName

Nombre del grupo de recursos dentro de la suscripción del usuario.

Tipo:String
Alias:ResourceGroup
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RetryPolicyEventTimeToLiveInMinute

Período de vida (en minutos) para eventos.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RetryPolicyMaxDeliveryAttempt

Número máximo de reintentos de entrega para eventos.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SubscriptionId

Credenciales de suscripción que identifican de forma única una suscripción de Microsoft Azure. El identificador de suscripción forma parte del URI para cada llamada al servicio.

Tipo:String
Posición:Named
Valor predeterminado:(Get-AzContext).Subscription.Id
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-TopicInputObject

Parámetro de identidad

Tipo:IEventGridIdentity
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-TopicName

Nombre del dominio.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

IEventGridIdentity

Salidas

IEventSubscription