Get-AzEventGridSubscription
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.
Syntax
Get-AzEventGridSubscription
[-EventSubscriptionName <String>]
[-ResourceGroupName <String>]
[-TopicName <String>]
[-IncludeFullEndpointUrl]
[-ODataQuery <String>]
[-Top <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzEventGridSubscription
[-EventSubscriptionName <String>]
[-ResourceId] <String>
[-IncludeFullEndpointUrl]
[-ODataQuery <String>]
[-Top <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzEventGridSubscription
[-EventSubscriptionName <String>]
[-ResourceGroupName <String>]
[-DomainName <String>]
[-DomainTopicName <String>]
[-IncludeFullEndpointUrl]
[-ODataQuery <String>]
[-Top <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzEventGridSubscription
[-ResourceGroupName <String>]
[-TopicTypeName <String>]
[-Location <String>]
[-IncludeFullEndpointUrl]
[-ODataQuery <String>]
[-Top <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzEventGridSubscription
[-InputObject] <PSTopic>
[-ODataQuery <String>]
[-Top <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzEventGridSubscription
[-DomainInputObject] <PSDomain>
[-ODataQuery <String>]
[-Top <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzEventGridSubscription
[-DomainTopicInputObject] <PSDomainTopic>
[-ODataQuery <String>]
[-Top <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzEventGridSubscription
[-NextLink <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
O cmdlet Get-AzEventGridSubscription obtém os detalhes de uma assinatura de Grade de Eventos especificada ou uma lista de todas as assinaturas de Grade de Eventos na assinatura ou grupo de recursos atual do Azure. 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 do evento será retornada. O número de elementos retornados nesta lista é controlado pelo parâmetro Top. Se o valor Top não for especificado ou $null, a lista conterá todos os itens de assinatura do evento. Caso contrário, Top indicará o número máximo de elementos a serem retornados na lista. Se mais assinaturas de eventos ainda estiverem disponíveis, o valor em NextLink deverá ser usado na próxima chamada para obter a próxima página de assinaturas de eventos. Finalmente, o parâmetro ODataQuery é usado para executar a filtragem para os resultados da pesquisa. A consulta de filtragem segue a sintaxe OData usando somente a propriedade Name. As operações suportadas incluem: CONTÉM, eq (para igual), ne (para não igual), E, OU e NÃO.
Exemplos
Exemplo 1
Get-AzEventGridSubscription -ResourceGroupName MyResourceGroupName -TopicName Topic1 -EventSubscriptionName EventSubscription1
Obtém os detalhes da assinatura do evento 'EventSubscription1' criada para o tópico 'Topic1' no grupo de recursos 'MyResourceGroupName'.
Exemplo 2
Get-AzEventGridSubscription -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
Get-AzEventGridSubscription -ResourceGroupName MyResourceGroupName -TopicName Topic1
Obtenha uma lista de todas as subscrições de eventos criadas para o tópico 'Topic1' no grupo de recursos 'MyResourceGroupName' sem paginação.
Exemplo 4
$odataFilter = "Name ne 'ABCD'"
Get-AzEventGridSubscription -ResourceGroupName MyResourceGroupName -TopicName Topic1 -Top 10 -ODataQuery $odataFilter
Get-AzEventGridSubscription $result.NextLink
Liste as primeiras 10 assinaturas de eventos (se houver) criadas para o tópico 'Topic1' no grupo de recursos 'MyResourceGroupName' que satisfaz a consulta $odataFilter. Se houver mais resultados disponíveis, o $result. NextLink não será $null. Para obter a(s) próxima(s) página(s) de assinaturas de eventos, espera-se que o usuário chame novamente Get-AzEventGridSubscription e use o resultado. NextLink obtido a partir da chamada anterior. O chamador deve parar quando resultar. NextLink torna-se $null.
Exemplo 5
Get-AzEventGridSubscription -ResourceGroupName MyResourceGroupName -EventSubscriptionName EventSubscription1
Obtém os detalhes da assinatura de evento 'EventSubscription1' criada para o grupo de recursos 'MyResourceGroupName'.
Exemplo 6
Get-AzEventGridSubscription -EventSubscriptionName EventSubscription1
Obtém os detalhes da assinatura de evento 'EventSubscription1' criada para a assinatura do Azure selecionada no momento.
Exemplo 7
Get-AzEventGridSubscription -ResourceGroupName MyResourceGroupName
Obtém a lista de todas as assinaturas de eventos globais criadas no grupo de recursos 'MyResourceGroupName' sem paginação.
Exemplo 8
$odataFilter = "Name ne 'ABCD'"
Get-AzEventGridSubscription -ResourceGroupName MyResourceGroupName -Top 5 -ODataQuery $odataFilter
Get-AzEventGridSubscription $result.NextLink
Liste as primeiras 5 assinaturas de eventos (se houver) criadas no grupo de recursos 'MyResourceGroupName' que satisfaz a consulta $odataFilter. Se houver mais resultados disponíveis, o $result. NextLink não será $null. Para obter a(s) próxima(s) página(s) de assinaturas de eventos, espera-se que o usuário chame novamente Get-AzEventGridSubscription e use o resultado. NextLink obtido a partir da chamada anterior. O chamador deve parar quando resultar. NextLink torna-se $null.
Exemplo 9
Get-AzEventGridSubscription
Obtém a lista de todas as assinaturas de eventos globais criadas sob a assinatura do Azure atualmente selecionada sem paginação.
Exemplo 10
$odataFilter = "Name ne 'ABCD'"
Get-AzEventGridSubscription -Top 15 -ODataQuery $odataFilter
Get-AzEventGridSubscription $result.NextLink
Liste as primeiras 15 assinaturas de eventos globais (se houver) criadas sob a assinatura do Azure atualmente selecionada que satisfaça a consulta $odataFilter. Se houver mais resultados disponíveis, o $result. NextLink não será $null. Para obter a(s) próxima(s) página(s) de assinaturas de eventos, espera-se que o usuário chame novamente Get-AzEventGridSubscription e use o resultado. NextLink obtido a partir da chamada anterior. O chamador deve parar quando resultar. NextLink torna-se $null.
Exemplo 11
Get-AzEventGridSubscription -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' sem paginação.
Exemplo 12
$odataFilter = "Name ne 'ABCD'"
Get-AzEventGridSubscription -ResourceGroupName MyResourceGroupName -Location westus2 -Top 15 -ODataQuery $odataFilter
Get-AzEventGridSubscription $result.NextLink
Liste as primeiras 15 assinaturas de eventos regionais (se houver) criadas no grupo de recursos 'MyResourceGroupName' no local especificado 'westus2' que satisfaz a consulta $odataFilter. Se houver mais resultados disponíveis, o $result. NextLink não será $null. Para obter a(s) próxima(s) página(s) de assinaturas de eventos, espera-se que o usuário chame novamente Get-AzEventGridSubscription e use o resultado. NextLink obtido a partir da chamada anterior. O chamador deve parar quando resultar. NextLink torna-se $null.
Exemplo 13
Get-AzEventGridSubscription -ResourceId "/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.EventHub/namespaces/$namespaceName"
Obtém a lista de todas as assinaturas de eventos criadas para o namespace EventHub especificado sem paginação.
Exemplo 14
$odataFilter = "Name ne 'ABCD'"
Get-AzEventGridSubscription -ResourceId "/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.EventHub/namespaces/$namespaceName" -Top 25 -ODataQuery $odataFilter
Get-AzEventGridSubscription $result.NextLink
Liste as primeiras 25 assinaturas de evento (se houver) criadas para o namespace EventHub especificado que satisfaz a consulta $odataFilter. Se houver mais resultados disponíveis, o $result. NextLink não será $null. Para obter a(s) próxima(s) página(s) de assinaturas de eventos, espera-se que o usuário chame novamente Get-AzEventGridSubscription e use o resultado. NextLink obtido a partir da chamada anterior. O chamador deve parar quando resultar. NextLink torna-se $null.
Exemplo 15
Get-AzEventGridSubscription -TopicTypeName "Microsoft.EventHub.Namespaces" -Location $location
Obtém a lista de todas as assinaturas de eventos criadas para o tipo de tópico especificado (namespaces EventHub) no local especificado sem paginação.
Exemplo 16
$odataFilter = "Name ne 'ABCD'"
Get-AzEventGridSubscription -TopicTypeName "Microsoft.EventHub.Namespaces" -Location $location -Top 15 -ODataQuery $odataFilter
Get-AzEventGridSubscription $result.NextLink
Liste as primeiras 15 assinaturas de evento (se houver) criadas para o tipo de tópico especificado (namespaces EventHub) no local especificado que satisfaz a consulta $odataFilter. Se houver mais resultados disponíveis, o $result. NextLink não será $null. Para obter a(s) próxima(s) página(s) de assinaturas de eventos, espera-se que o usuário chame novamente Get-AzEventGridSubscription e use o resultado. NextLink obtido a partir da chamada anterior. O chamador deve parar quando resultar. NextLink torna-se $null.
Exemplo 17
Get-AzEventGridSubscription -TopicTypeName "Microsoft.Resources.ResourceGroups" -ResourceGroupName MyResourceGroupName
Obtém a lista de todas as assinaturas de eventos criadas para o grupo de recursos específico sem paginação.
Exemplo 18
$odataFilter = "Name ne 'ABCD'"
Get-AzEventGridSubscription -TopicTypeName "Microsoft.Resources.ResourceGroups" -ResourceGroupName MyResourceGroupName -Top 100 -ODataQuery $odataFilter
Get-AzEventGridSubscription $result.NextLink
Liste as primeiras 100 assinaturas de eventos (se houver) criadas para o grupo de recursos específico que satisfaz a consulta $odataFilter. Se houver mais resultados disponíveis, o $result. NextLink não será $null. Para obter a(s) próxima(s) página(s) de assinaturas de eventos, espera-se que o usuário chame novamente Get-AzEventGridSubscription e use o resultado. NextLink obtido a partir da chamada anterior. O chamador deve parar quando resultar. NextLink torna-se $null.
Parâmetros
-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 |
-DomainInputObject
Objeto EventGrid Domain.
Type: | PSDomain |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DomainName
Nome de domínio EventGrid.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DomainTopicInputObject
Objeto EventGrid Domain Topic.
Type: | PSDomainTopic |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DomainTopicName
Nome do tópico de domínio EventGrid.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-EventSubscriptionName
O nome da assinatura do evento
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-IncludeFullEndpointUrl
Inclua a URL completa do ponto de extremidade do destino da assinatura do evento.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Objeto EventGrid Topic.
Type: | PSTopic |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Location
Localização
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NextLink
O link para a próxima página de recursos a serem obtidos. Esse valor é obtido com a primeira chamada do cmdlet Get-AzEventGrid quando mais recursos ainda estão disponíveis para consulta.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ODataQuery
A consulta OData usada para filtrar os resultados da lista. Atualmente, a filtragem é permitida apenas na propriedade Name. As operações suportadas incluem: CONTÉM, eq (para igual), ne (para não igual), E, OU e NÃO.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceGroupName
Nome do Grupo de Recursos.
Type: | String |
Aliases: | ResourceGroup |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceId
Identificador do recurso para o qual as assinaturas de evento foram criadas.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Top
A consulta OData usada para filtrar os resultados da lista. Atualmente, a filtragem é permitida apenas na propriedade Name. As operações suportadas incluem: CONTÉM, eq (para igual), ne (para não igual), E, OU e NÃO.
Type: | Nullable<T>[Int32] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TopicName
Nome do tópico EventGrid.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TopicTypeName
Nome do TopicType
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Entradas
Nullable<T>[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]
Saídas
Azure PowerShell
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários