New-AzEventGridSystemTopicEventSubscription
Cria um novo tópico da Assinatura de Evento da Grade de Eventos do Azure para um Sistema.
Syntax
New-AzEventGridSystemTopicEventSubscription
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzEventGridSystemTopicEventSubscription
-EventSubscriptionName <String>
-ResourceGroupName <String>
-SystemTopicName <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 Sistema de Grade de Eventos do Azure.
Exemplos
Exemplo 1
New-AzEventGridSystemTopicEventSubscription -ResourceGroupName MyResourceGroup -SystemTopicName Topic1 -Endpoint https://requestb.in/19qlscd1 -EventSubscriptionName EventSubscription1
Cria uma nova assinatura de evento 'EventSubscription1' para um tópico 'Topic1' do Sistema de Grade de Eventos do Azure no grupo de recursos 'MyResourceGroupName' com o ponto de extremidade https://requestb.in/19qlscd1
de destino do webhook. Esta subscrição de eventos utiliza filtros predefinidos.
Exemplo 2
$includedEventTypes = "Microsoft.Resources.ResourceWriteFailure", "Microsoft.Resources.ResourceWriteSuccess"
$labels = "Finance", "HR"
New-AzEventGridSystemTopicEventSubscription -ResourceGroupName MyResourceGroup -SystemTopicName 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/19qlscd1
de 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-AzEventGridSystemTopicEventSubscription -ResourceGroupName MyResourceGroup -SystemTopicName 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 |
-EventSubscriptionName
Nome da assinatura do evento EventGrid.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
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 |
-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 |
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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SystemTopicName
Nome do tópico EventGrid.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
String[]