New-AzEventGridSystemTopicEventSubscription
Cria ou atualiza de forma assíncrona uma assinatura de evento com os parâmetros especificados. As assinaturas de eventos existentes serão atualizadas com essa API.
Syntax
New-AzEventGridSystemTopicEventSubscription
-EventSubscriptionName <String>
-ResourceGroupName <String>
[-SubscriptionId <String>]
-SystemTopicName <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>]
New-AzEventGridSystemTopicEventSubscription
-EventSubscriptionName <String>
-ResourceGroupName <String>
[-SubscriptionId <String>]
-SystemTopicName <String>
-JsonString <String>
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzEventGridSystemTopicEventSubscription
-EventSubscriptionName <String>
-ResourceGroupName <String>
[-SubscriptionId <String>]
-SystemTopicName <String>
-JsonFilePath <String>
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzEventGridSystemTopicEventSubscription
-EventSubscriptionName <String>
-SystemTopicInputObject <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>]
New-AzEventGridSystemTopicEventSubscription
-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
Cria ou atualiza de forma assíncrona uma assinatura de evento com os parâmetros especificados. As assinaturas de eventos existentes serão atualizadas com essa API.
Exemplos
Exemplo 1: Crie de forma assíncrona uma assinatura de evento com os parâmetros especificados.
$obj = New-AzEventGridWebHookEventSubscriptionDestinationObject -EndpointUrl "https://azpsweb.azurewebsites.net"
New-AzEventGridSystemTopicEventSubscription -EventSubscriptionName azps-evnetsub -ResourceGroupName azps_test_group_eventgrid -SystemTopicName azps-systopic -FilterIsSubjectCaseSensitive:$false -FilterSubjectBeginsWith "ExamplePrefix" -FilterSubjectEndsWith "ExampleSuffix" -Destination $obj
Name ResourceGroupName
---- -----------------
azps-evnetsub azps_test_group_eventgrid
Crie de forma assíncrona uma assinatura de evento com os parâmetros especificados. As assinaturas de eventos existentes serão atualizadas com essa API.
Parâmetros
-AsJob
Executar o comando como um trabalho
Tipo: | SwitchParameter |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadLetterWithResourceIdentityType
O tipo de identidade gerenciada usado. 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.
Tipo: | String |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadLetterWithResourceIdentityUserAssignedIdentity
A identidade do usuário associada ao recurso.
Tipo: | String |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
O parâmetro DefaultProfile não está funcional. Use o parâmetro SubscriptionId quando disponível se estiver executando o cmdlet em uma assinatura diferente.
Tipo: | PSObject |
Aliases: | AzureRMContext, AzureCredential |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeliveryWithResourceIdentityDestination
Informações sobre o destino onde os eventos devem ser entregues para a inscrição 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/deadlettering.
Tipo: | IEventSubscriptionDestination |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeliveryWithResourceIdentityType
O tipo de identidade gerenciada usado. 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.
Tipo: | String |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeliveryWithResourceIdentityUserAssignedIdentity
A identidade do usuário associada ao recurso.
Tipo: | String |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Destination
Informações sobre o destino onde os eventos devem ser entregues para a inscrição 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/deadlettering.
Tipo: | IEventSubscriptionDestination |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EventDeliverySchema
O esquema de entrega de eventos para a assinatura do evento.
Tipo: | String |
Aliases: | DeliverySchema |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EventSubscriptionName
Nome da assinatura do evento que será criado. Os nomes de assinatura de eventos devem ter entre 3 e 100 caracteres e usar apenas letras alfanuméricas.
Tipo: | String |
Position: | Named |
valor padrão: | None |
Obrigatório: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExpirationTimeUtc
Tempo de expiração da assinatura do evento.
Tipo: | DateTime |
Aliases: | ExpirationDate |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FilterAdvancedFilter
Uma matriz de filtros avançados que são usados para filtrar assinaturas de eventos.
Tipo: | IAdvancedFilter[] |
Aliases: | AdvancedFilter |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FilterEnableAdvancedFilteringOnArray
Permite que filtros avançados sejam avaliados em relação a uma matriz de valores em vez de esperar um valor singular.
Tipo: | SwitchParameter |
Aliases: | AdvancedFilteringOnArray |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Tipo: | String[] |
Aliases: | IncludedEventType |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FilterIsSubjectCaseSensitive
Especifica se as propriedades SubjectBeginsWith e SubjectEndsWith do filtro devem ser comparadas de maneira sensível a maiúsculas e minúsculas.
Tipo: | SwitchParameter |
Aliases: | SubjectCaseSensitive |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 disso depende do editor dos eventos. Não há suporte para caracteres curinga nesse caminho.
Tipo: | String |
Aliases: | SubjectBeginsWith |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 nesse caminho.
Tipo: | String |
Aliases: | SubjectEndsWith |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Parâmetro de identidade
Tipo: | IEventGridIdentity |
Position: | Named |
valor padrão: | None |
Obrigatório: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-JsonFilePath
Caminho do arquivo Json fornecido para a operação Create
Tipo: | String |
Position: | Named |
valor padrão: | None |
Obrigatório: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JsonString
Cadeia de caracteres Json fornecida à operação Create
Tipo: | String |
Position: | Named |
valor padrão: | None |
Obrigatório: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Label
Lista de rótulos definidos pelo usuário.
Tipo: | String[] |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoWait
Execute o comando de forma assíncrona
Tipo: | SwitchParameter |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Retorna true quando o comando é bem-sucedido
Tipo: | SwitchParameter |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
O nome do grupo de recursos dentro da assinatura do usuário.
Tipo: | String |
Aliases: | ResourceGroup |
Position: | Named |
valor padrão: | None |
Obrigatório: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RetryPolicyEventTimeToLiveInMinute
Time To Live (em minutos) para eventos.
Tipo: | Int32 |
Aliases: | EventTtl |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RetryPolicyMaxDeliveryAttempt
Número máximo de tentativas de repetição de entrega para eventos.
Tipo: | Int32 |
Aliases: | MaxDeliveryAttempt |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SubscriptionId
Credenciais de assinatura que identificam exclusivamente uma assinatura do Microsoft Azure. A ID da assinatura faz parte do URI para cada chamada de serviço.
Tipo: | String |
Position: | Named |
valor padrão: | (Get-AzContext).Subscription.Id |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SystemTopicInputObject
Parâmetro de identidade
Tipo: | IEventGridIdentity |
Position: | Named |
valor padrão: | None |
Obrigatório: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SystemTopicName
Nome do tópico do sistema.
Tipo: | String |
Position: | Named |
valor padrão: | None |
Obrigatório: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Tipo: | SwitchParameter |
Aliases: | wi |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Saídas
Azure PowerShell
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de