Compartilhar via


Get-AzureRmEventGridSubscription

Obtém os detalhes de uma assinatura de evento ou obtém uma lista de todas as assinaturas de evento na assinatura atual do Azure.

Aviso

O módulo PowerShell do AzureRM foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo do Az PowerShell para garantir o suporte e as atualizações contínuas.

Embora o módulo AzureRM ainda possa funcionar, ele não tem suporte ou será mantido, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o módulo Az.

Sintaxe

Get-AzureRmEventGridSubscription
   [[-EventSubscriptionName] <String>]
   [[-ResourceGroupName] <String>]
   [[-TopicName] <String>]
   [-IncludeFullEndpointUrl]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmEventGridSubscription
   [[-EventSubscriptionName] <String>]
   [-ResourceId] <String>
   [-IncludeFullEndpointUrl]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmEventGridSubscription
   [[-ResourceGroupName] <String>]
   [[-TopicTypeName] <String>]
   [[-Location] <String>]
   [-IncludeFullEndpointUrl]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmEventGridSubscription
   [-InputObject] <PSTopic>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

O cmdlet Get-AzureRmEventGridSubscription obtém os detalhes de uma assinatura especificada da Grade de Eventos ou uma lista de todas as assinaturas da Grade de Eventos na assinatura atual do Azure ou no grupo de recursos. Se o nome da assinatura do evento for fornecido, os detalhes de uma única assinatura da Grade de Eventos serão retornados. Se o nome da assinatura do evento não for fornecido, uma lista de todas as assinaturas de eventos será retornada.

Exemplos

Exemplo 1

PS C:\> Get-AzureRmEventGridSubscription -ResourceGroupName MyResourceGroupName -TopicName Topic1 -EventSubscriptionName EventSubscription1

Obtém os detalhes da assinatura de evento 'EventSubscription1' criada para o tópico 'Topic1' no grupo de recursos 'MyResourceGroupName'.

Exemplo 2

PS C:\> Get-AzureRmEventGridSubscription -ResourceGroupName MyResourceGroupName -TopicName Topic1 -EventSubscriptionName EventSubscription1 -IncludeFullEndpointUrl

Obtém os detalhes da assinatura de evento 'EventSubscription1' criada para o tópico 'Topic1' no grupo de recursos 'MyResourceGroupName', incluindo a URL completa do ponto de extremidade se for uma assinatura de evento baseada em webhook.

Exemplo 3

PS C:\> Get-AzureRmEventGridSubscription -ResourceGroupName MyResourceGroupName -TopicName Topic1

Obtenha uma lista de todas as assinaturas de eventos criadas para o tópico 'Topic1' no grupo de recursos 'MyResourceGroupName'.

Exemplo 4

PS C:\> Get-AzureRmEventGridSubscription -ResourceGroupName MyResourceGroupName -EventSubscriptionName EventSubscription1

Obtém os detalhes da assinatura de evento 'EventSubscription1' criada para o grupo de recursos 'MyResourceGroupName'.

Exemplo 5

PS C:\> Get-AzureRmEventGridSubscription -EventSubscriptionName EventSubscription1

Obtém os detalhes da assinatura de evento 'EventSubscription1' criada para a assinatura do Azure selecionada no momento.

Exemplo 6

PS C:\> Get-AzureRmEventGridSubscription -ResourceGroupName MyResourceGroupName

Obtém a lista de todas as assinaturas de eventos globais criadas no grupo de recursos 'MyResourceGroupName'.

Exemplo 7

PS C:\> Get-AzureRmEventGridSubscription

Obtém a lista de todas as assinaturas de eventos globais criadas na assinatura do Azure selecionada no momento.

Exemplo 8

PS C:\> Get-AzureRmEventGridSubscription -ResourceGroupName MyResourceGroupName -Location westus2

Obtém a lista de todas as assinaturas de eventos regionais criadas no grupo de recursos 'MyResourceGroupName' no local especificado 'westus2'.

Exemplo 9

PS C:\> Get-AzureRmEventGridSubscription -ResourceId "/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.EventHub/namespaces/$namespaceName"

Obtém a lista de todas as assinaturas de evento criadas para o namespace EventHub especificado.

Exemplo 10

PS C:\> Get-AzureRmEventGridSubscription -TopicTypeName "Microsoft.EventHub.Namespaces" -Location $location

Obtém a lista de todas as assinaturas de evento criadas para o tipo de tópico especificado (namespaces do EventHub) no local especificado.

Exemplo 11

PS C:\> Get-AzureRmEventGridSubscription -TopicTypeName "Microsoft.Resources.ResourceGroups" -ResourceGroupName MyResourceGroupName

Obtém a lista de todas as assinaturas de eventos criadas para o grupo de recursos específico.

Parâmetros

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EventSubscriptionName

O nome da assinatura de evento

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-IncludeFullEndpointUrl

Inclua a URL completa do ponto de extremidade do destino da assinatura do evento.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

EventGrid Event Subscription objeto.

Tipo:PSTopic
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Location

Localidade

Tipo:String
Cargo:2
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ResourceGroupName

Nome do grupo de recursos.

Tipo:String
Aliases:ResourceGroup
Cargo:0
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ResourceId

Identificador do recurso para o qual as assinaturas de eventos foram criadas.

Tipo:String
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-TopicName

Nome do tópico EventGrid.

Tipo:String
Cargo:2
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-TopicTypeName

Nome do TopicType

Tipo:String
Cargo:1
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

String

PSTopic

Parâmetros: InputObject (ByValue)

Saídas

PSEventSubscription