New-AzEventGridPartnerTopicEventSubscription

Referência

Módulo:: Az.EventGrid

Cria uma nova Assinatura de Evento da Grade de Eventos do Azure para um tópico de Parceiro.

Syntax

New-AzEventGridPartnerTopicEventSubscription
   -Name <String>
   -ResourceGroupName <String>
   -PartnerTopicName <String>
   [-AzureActiveDirectoryApplicationIdOrUri <String>]
   [-AzureActiveDirectoryTenantId <String>]
   [-DeadLetterEndpoint <String>]
   [-DeliveryAttributeMapping <Hashtable[]>]
   [-Endpoint <String>]
   [-EndpointType <String>]
   [-DeliverySchema <String>]
   [-EventTtl <Int32>]
   [-ExpirationDate <DateTime>]
   [-Label <String[]>]
   [-MaxDeliveryAttempt <Int32>]
   [-MaxEventsPerBatch <Int32>]
   [-PreferredBatchSizeInKiloByte <Int32>]
   [-StorageQueueMessageTtl <Int64>]
   [-AdvancedFilter <Hashtable[]>]
   [-AdvancedFilteringOnArray]
   [-IncludedEventType <String[]>]
   [-SubjectBeginsWith <String>]
   [-SubjectEndsWith <String>]
   [-SubjectCaseSensitive]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Crie uma nova assinatura de evento para um tópico do Parceiro da Grade de Eventos do Azure.

Exemplos

Exemplo 1

New-AzEventGridPartnerTopicEventSubscription -ResourceGroup MyResourceGroup -PartnerTopicName Topic1 -Endpoint https://requestb.in/19qlscd1 -EventSubscriptionName EventSubscription1

Cria uma nova assinatura de evento 'EventSubscription1' para um tópico de Parceiro de Grade de Eventos do Azure 'Topic1' no grupo de recursos 'MyResourceGroupName' com o ponto de extremidade https://requestb.in/19qlscd1de destino do webhook. Esta subscrição de eventos utiliza filtros predefinidos.

Exemplo 2

$includedEventTypes = "Microsoft.Resources.ResourceWriteFailure", "Microsoft.Resources.ResourceWriteSuccess"
$labels = "Finance", "HR"
New-AzEventGridPartnerTopicEventSubscription -ResourceGroup MyResourceGroup -PartnerTopicName Topic1 -EventSubscriptionName EventSubscription1 -Endpoint https://requestb.in/19qlscd1  -SubjectBeginsWith "TestPrefix" -SubjectEndsWith "TestSuffix" -IncludedEventType $includedEventTypes -Label $labels

Cria uma nova assinatura de evento 'EventSubscription1' para Sytem Topic 'Topic1' no grupo de recursos 'MyResourceGroup' com o ponto de extremidade https://requestb.in/19qlscd1de destino webhook . Esta assinatura de evento especifica os filtros adicionais para tipos de evento e assunto, e somente os eventos correspondentes a esses filtros serão entregues ao ponto de extremidade de destino.

Exemplo 3

New-AzEventGridPartnerTopicEventSubscription -ResourceGroup MyResourceGroup -PartnerTopicName Topic1 -EventSubscriptionName EventSubscription1 -EndpointType "eventhub" -Endpoint "/subscriptions/55f3dcd4-cac7-43b4-990b-a139d62a1eb2/resourceGroups/TestRG/providers/Microsoft.EventHub/namespaces/ContosoNamespace/eventhubs/EH1"

Cria uma nova assinatura de evento 'EventSubscription1' para Sytem Topic 'Topic1' no grupo de recursos 'MyResourceGroup' com o hub de eventos especificado como destino para eventos. Esta subscrição de eventos utiliza filtros predefinidos.

Parâmetros

-AdvancedFilter

Filtro avançado que especifica uma matriz de vários valores Hashtable que são usados para a filtragem baseada em atributos. Cada valor Hashtable tem as seguintes informações chave-valor: Operação, Chave e Valor ou Valores. O operador pode ser um dos seguintes valores: NumberIn, NumberNotIn, NumberLessThan, NumberGreaterThan, NumberLessThanOrEquals, NumberGreaterThanOrEquals, BoolEquals, StringIn, StringNotIn, StringBeginsWith, StringEndsWith ou StringContains. Key representa a propriedade payload onde as políticas avançadas de filtragem são aplicadas. Finalmente, Value ou Values representam o valor ou conjunto de valores a serem correspondidos. Pode ser um único valor do tipo correspondente ou uma matriz de valores. Como exemplo dos parâmetros avançados do filtro: $AdvancedFilters=@($AdvFilter 1, $AdvFilter 2) onde $AdvFilter 1=@{operator="NumberIn"; key="Data.Key1"; Values=@(1,2)} e $AdvFilter 2=@{operator="StringBringsWith"; key="Subject"; Valores=@("SubjectPrefix1","SubjectPrefix2")}

Type:	Hashtable[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-AdvancedFilteringOnArray

A presença desse parâmetro indica que a filtragem avançada em matrizes está habilitada

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-AzureActiveDirectoryApplicationIdOrUri

O ID ou Uri do Aplicativo Microsoft Entra para obter o token de acesso que será incluído como o token de portador nas solicitações de entrega. Aplicável apenas para webhook como destino.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-AzureActiveDirectoryTenantId

O ID do locatário do Microsoft Entra para obter o token de acesso que será incluído como o token de portador nas solicitações de entrega. Aplicável apenas para webhook como destino.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DeadLetterEndpoint

O ponto de extremidade usado para armazenar eventos não entregues. Especifique a ID do recurso do Azure de um contêiner de blob de armazenamento. Por exemplo: /subscriptions/[SubscriptionId]/resourceGroups/[ResourceGroupName]/providers/Microsoft.Storage/storageAccounts/[StorageAccountName]/blobServices/default/containers/[ContainerName].

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DeliveryAttributeMapping

Os mapeamentos de atributo de entrega para esta assinatura de evento de tópico do sistema. Cada mapeamento de atributo de entrega deve conter os seguintes dois campos obrigatórios: Nome e Tipo. O Tipo pode ser 'Estático' ou 'Dinâmico'. Se o tipo for 'Static', as propriedades 'Value' e 'IsSecret' são necessárias. Se o tipo for 'Dynamic', a propriedade 'SourceField' é necessária. Um exemplo dos parâmetros DynamicAttributeMapping: $DeliveryAttributeMapping=@($DeliveryAttributeMapping 1, $DeliveryAttributeMapping 2) onde $DeliveryAttributeMapping 1=@{Name="Name1"; Type="Estático"; Valores="valor"; IsSecret="false"} e $DeliveryAttributeMapping 2=@{Name="Name2"; Type="Dinâmico"; SourceField="data.prop1"}

Type:	Hashtable[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DeliverySchema

O esquema a ser usado ao entregar eventos no destino. Os valores possíveis são: eventgridschema, CustomInputSchema ou cloudeventv01schema. O valor padrão é CustomInputSchema.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Endpoint

Ponto de extremidade de destino da assinatura do evento. Pode ser uma URL de webhook ou a ID de recurso do Azure de um EventHub, fila de armazenamento, hybridconnection, servicebusqueue, servicebustopic ou azurefunction. Por exemplo, a ID de recurso para uma conexão híbrida assume a seguinte forma: /subscriptions/[Azure Subscription ID]/resourceGroups/[ResourceGroupName]/providers/Microsoft.Relay/namespaces/[NamespaceName]/hybridConnections/[HybridConnectionName]. Espera-se que o ponto de extremidade de destino seja criado e esteja disponível para uso antes de executar qualquer cmdlet de Grade de Eventos.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-EndpointType

Tipo de ponto final. Isso pode ser webhook, eventhub, storagequeue, hybridconnection, servicebusqueue, servicebustopic ou azurefunction. O valor padrão é webhook.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-EventTtl

O tempo em minutos para a entrega do evento. Este valor deve estar entre 1 e 1440

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ExpirationDate

Determina o DateTime de expiração para a assinatura do evento após o qual a assinatura do evento será desativada.

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-IncludedEventType

Filtro que especifica uma lista de tipos de eventos a serem incluídos. Se não for especificado, todos os tipos de evento (para os tópicos e domínios personalizados) ou os tipos de evento padrão (para outros tipos de tópico) serão incluídos.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Label

Etiquetas para a subscrição do evento.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-MaxDeliveryAttempt

O número máximo de tentativas de entrega do evento. Este valor deve estar entre 1 e 30.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-MaxEventsPerBatch

O número máximo de eventos em um lote. Este valor deve estar entre 1 e 5000. Este parâmetro é válido quando Endpint Type é apenas webhook.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Nome da assinatura do evento EventGrid.

Type:	String
Aliases:	EventSubscriptionName
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-PartnerTopicName

Nome do tópico do parceiro da Grade de Eventos.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-PreferredBatchSizeInKiloByte

O tamanho de lote preferido em kilobytes. Este valor deve estar entre 1 e 1024. Este parâmetro é válido quando Endpint Type é apenas webhook.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ResourceGroupName

O nome do grupo de recursos.

Type:	String
Aliases:	ResourceGroup
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-StorageQueueMessageTtl

O tempo, em milissegundos, de uma mensagem de fila de armazenamento

Type:	Int64
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-SubjectBeginsWith

Filtro que especifica que apenas os eventos correspondentes ao prefixo de assunto especificado serão incluídos. Se não for especificado, eventos com todos os prefixos de assunto serão incluídos.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-SubjectCaseSensitive

Filtro que especifica que o campo assunto deve ser comparado de forma sensível a maiúsculas e minúsculas. Se não for especificado, o assunto será comparado de forma insensível a maiúsculas e minúsculas.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-SubjectEndsWith

Filtro que especifica que apenas os eventos correspondentes ao sufixo de assunto especificado serão incluídos. Se não for especificado, eventos com todos os sufixos de assunto serão incluídos.