Update-AzEventGridSubscription
Atualize de forma assíncrona uma assinatura de evento existente.
Sintaxe
UpdateExpanded (Padrão)
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>]
UpdateViaJsonString
Update-AzEventGridSubscription
-Name <String>
-Scope <String>
-JsonString <String>
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
UpdateViaJsonFilePath
Update-AzEventGridSubscription
-Name <String>
-Scope <String>
-JsonFilePath <String>
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
UpdateViaIdentityExpanded
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>]
Descrição
Atualize de forma assíncrona uma assinatura de evento existente.
Exemplos
$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
Atualiza de forma assíncrona uma assinatura de evento existente.
Parâmetros
-AsJob
Executar o comando como um trabalho
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: None
Suporta curingas: False
DontShow: False
Pseudónimos: Cf.
Conjuntos de parâmetros
(All)
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-DeadLetterWithResourceIdentityType
O tipo de identidade gerenciada usada.
O tipo 'SystemAssigned, UserAssigned' inclui uma identidade criada implicitamente e um conjunto de identidades atribuídas pelo usuário.
O tipo 'Nenhum' removerá qualquer identidade.
Propriedades dos parâmetros
Tipo: String
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
UpdateExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
UpdateViaIdentityExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-DeadLetterWithResourceIdentityUserAssignedIdentity
A identidade do usuário associada ao recurso.
Propriedades dos parâmetros
Tipo: String
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
UpdateExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
UpdateViaIdentityExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-DefaultProfile
O parâmetro DefaultProfile não é funcional.
Use o parâmetro SubscriptionId quando disponível se estiver executando o cmdlet em uma assinatura diferente.
Propriedades dos parâmetros
Tipo: PSObject
Valor padrão: None
Suporta curingas: False
DontShow: False
Pseudónimos: AzureRMContext, AzureCredential
Conjuntos de parâmetros
(All)
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-DeliveryWithResourceIdentityDestination
Informações sobre o destino onde os eventos devem ser entregues para a assinatura do evento. Usa a identidade da Grade de Eventos do Azure para adquirir os tokens de autenticação que estão sendo usados durante a entrega/dead-lettering.
Propriedades dos parâmetros
Conjuntos de parâmetros
UpdateExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
UpdateViaIdentityExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-DeliveryWithResourceIdentityType
O tipo de identidade gerenciada usada.
O tipo 'SystemAssigned, UserAssigned' inclui uma identidade criada implicitamente e um conjunto de identidades atribuídas pelo usuário.
O tipo 'Nenhum' removerá qualquer identidade.
Propriedades dos parâmetros
Tipo: String
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
UpdateExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
UpdateViaIdentityExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-DeliveryWithResourceIdentityUserAssignedIdentity
A identidade do usuário associada ao recurso.
Propriedades dos parâmetros
Tipo: String
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
UpdateExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
UpdateViaIdentityExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-Destination
Informações sobre o destino onde os eventos devem ser entregues para a assinatura do evento. Usa a identidade da Grade de Eventos do Azure para adquirir os tokens de autenticação que estão sendo usados durante a entrega/dead-lettering.
Propriedades dos parâmetros
Conjuntos de parâmetros
UpdateExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
UpdateViaIdentityExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-EventDeliverySchema
O esquema de entrega de eventos para a assinatura do evento.
Propriedades dos parâmetros
Tipo: String
Valor padrão: None
Suporta curingas: False
DontShow: False
Pseudónimos: DeliverySchema
Conjuntos de parâmetros
UpdateExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
UpdateViaIdentityExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-ExpirationTimeUtc
Informações sobre o tempo de expiração da assinatura do evento.
Propriedades dos parâmetros
Tipo: DateTime
Valor padrão: None
Suporta curingas: False
DontShow: False
Pseudónimos: ExpirationDate
Conjuntos de parâmetros
UpdateExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
UpdateViaIdentityExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-FilterAdvancedFilter
Uma matriz de filtros avançados que são usados para filtrar assinaturas de eventos.
Propriedades dos parâmetros
Tipo: IAdvancedFilter [ ]
Valor padrão: None
Suporta curingas: False
DontShow: False
Pseudónimos: AdvancedFilter
Conjuntos de parâmetros
UpdateExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
UpdateViaIdentityExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-FilterEnableAdvancedFilteringOnArray
Permite que filtros avançados sejam avaliados em relação a uma matriz de valores em vez de esperar um valor singular.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: None
Suporta curingas: False
DontShow: False
Pseudónimos: AdvancedFilteringOnArray
Conjuntos de parâmetros
UpdateExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
UpdateViaIdentityExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-FilterIncludedEventType
Uma lista de tipos de eventos aplicáveis que precisam fazer parte da assinatura do evento.
Se desejar se inscrever em todos os tipos de evento padrão, defina IncludedEventTypes como null.
Propriedades dos parâmetros
Tipo: String [ ]
Valor padrão: None
Suporta curingas: False
DontShow: False
Pseudónimos: IncludedEventType
Conjuntos de parâmetros
UpdateExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
UpdateViaIdentityExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-FilterIsSubjectCaseSensitive
Especifica se as propriedades SubjectBeginsWith e SubjectEndsWith do filtro devem ser comparadas de maneira sensível a maiúsculas e minúsculas.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: None
Suporta curingas: False
DontShow: False
Pseudónimos: AssuntoSensível a maiúsculas e minúsculas
Conjuntos de parâmetros
UpdateExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
UpdateViaIdentityExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-FilterSubjectBeginsWith
Uma cadeia de caracteres opcional para filtrar eventos para uma assinatura de evento com base em um prefixo de caminho de recurso. O formato depende do editor dos eventos. Não há suporte para caracteres curinga neste caminho.
Propriedades dos parâmetros
Tipo: String
Valor padrão: None
Suporta curingas: False
DontShow: False
Pseudónimos: AssuntoComeçaCom
Conjuntos de parâmetros
UpdateExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
UpdateViaIdentityExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-FilterSubjectEndsWith
Uma cadeia de caracteres opcional para filtrar eventos para uma assinatura de evento com base em um sufixo de caminho de recurso. Não há suporte para caracteres curinga neste caminho.
Propriedades dos parâmetros
Tipo: String
Valor padrão: None
Suporta curingas: False
DontShow: False
Pseudónimos: AssuntoTermina Com
Conjuntos de parâmetros
UpdateExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
UpdateViaIdentityExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
Parâmetro de identidade
UpdateViaIdentityExpanded
Posição: Named
Obrigatório: True
Valor do pipeline: True
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-JsonFilePath
Caminho do arquivo Json fornecido para a operação Update
Propriedades dos parâmetros
Tipo: String
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
UpdateViaJsonFilePath
Posição: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-JsonString
Cadeia de caracteres Json fornecida para a operação Update
Propriedades dos parâmetros
Tipo: String
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
UpdateViaJsonString
Posição: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-Label
Lista de rótulos definidos pelo usuário.
Propriedades dos parâmetros
Tipo: String [ ]
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
UpdateExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
UpdateViaIdentityExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-Name
Nome da assinatura do evento a ser atualizada.
Propriedades dos parâmetros
Tipo: String
Valor padrão: None
Suporta curingas: False
DontShow: False
Pseudónimos: EventSubscriptionName
Conjuntos de parâmetros
UpdateExpanded
Posição: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
UpdateViaJsonString
Posição: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
UpdateViaJsonFilePath
Posição: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-NoWait
Execute o comando de forma assíncrona
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-PassThru
Retorna true quando o comando é bem-sucedido
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-RetryPolicyEventTimeToLiveInMinute
Time To Live (em minutos) para eventos.
Propriedades dos parâmetros
Tipo: Int32
Valor padrão: None
Suporta curingas: False
DontShow: False
Pseudónimos: EventTtl
Conjuntos de parâmetros
UpdateExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
UpdateViaIdentityExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-RetryPolicyMaxDeliveryAttempt
Número máximo de tentativas de repetição de entrega para eventos.
Propriedades dos parâmetros
Tipo: Int32
Valor padrão: None
Suporta curingas: False
DontShow: False
Pseudónimos: MaxDeliveryAttempt
Conjuntos de parâmetros
UpdateExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
UpdateViaIdentityExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-Scope
O escopo da assinatura de evento existente.
O escopo pode ser uma assinatura ou um grupo de recursos, ou um recurso de nível superior pertencente a um namespace de provedor de recursos ou um tópico EventGrid.
Por exemplo, use '/subscriptions/{subscriptionId}/' para uma assinatura, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' para um grupo de recursos e '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}' para um recurso e '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/topics/{topicName}' para um tópico EventGrid.
Propriedades dos parâmetros
Tipo: String
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
UpdateExpanded
Posição: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
UpdateViaJsonString
Posição: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
UpdateViaJsonFilePath
Posição: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado.
O cmdlet não é executado.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: None
Suporta curingas: False
DontShow: False
Pseudónimos: Wi
Conjuntos de parâmetros
(All)
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters .
Saídas