Get-AzEventGridSubscription

Pobiera szczegóły subskrypcji zdarzeń lub pobiera listę wszystkich subskrypcji zdarzeń w bieżącej subskrypcji platformy Azure.

Składnia

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>]

Opis

Polecenie cmdlet Get-AzEventGridSubscription pobiera szczegóły określonej subskrypcji usługi Event Grid lub listę wszystkich subskrypcji usługi Event Grid w bieżącej subskrypcji platformy Azure lub grupie zasobów. Jeśli zostanie podana nazwa subskrypcji zdarzeń, zostaną zwrócone szczegóły pojedynczej subskrypcji usługi Event Grid. Jeśli nie podano nazwy subskrypcji zdarzeń, zostanie zwrócona lista wszystkich subskrypcji zdarzeń. Liczba elementów zwracanych na tej liście jest kontrolowana przez parametr Top. Jeśli nie określono wartości Top lub $null, lista będzie zawierać wszystkie elementy subskrypcji zdarzeń. W przeciwnym razie górna część będzie wskazywać maksymalną liczbę elementów, które mają być zwracane na liście. Jeśli więcej subskrypcji zdarzeń jest nadal dostępnych, wartość w aplikacji NextLink powinna być używana w następnym wywołaniu, aby uzyskać następną stronę subskrypcji zdarzeń. Na koniec parametr ODataQuery służy do filtrowania wyników wyszukiwania. Zapytanie filtrowania jest zgodne ze składnią OData tylko przy użyciu właściwości Name. Obsługiwane operacje obejmują: CONTAINS, eq (for equal), ne (for not equal), AND, OR i NOT.

Przykłady

Przykład 1

Get-AzEventGridSubscription -ResourceGroupName MyResourceGroupName -TopicName Topic1 -EventSubscriptionName EventSubscription1

Pobiera szczegóły subskrypcji zdarzeń "EventSubscription1" utworzonej dla tematu "Topic1" w grupie zasobów "MyResourceGroupName".

Przykład 2

Get-AzEventGridSubscription -ResourceGroupName MyResourceGroupName -TopicName Topic1 -EventSubscriptionName EventSubscription1 -IncludeFullEndpointUrl

Pobiera szczegóły subskrypcji zdarzeń "EventSubscription1" utworzonej dla tematu "Topic1" w grupie zasobów "MyResourceGroupName", w tym pełny adres URL punktu końcowego, jeśli jest to subskrypcja zdarzeń oparta na elementach webhook.

Przykład 3

Get-AzEventGridSubscription -ResourceGroupName MyResourceGroupName -TopicName Topic1

Pobierz listę wszystkich subskrypcji zdarzeń utworzonych dla tematu "Topic1" w grupie zasobów "MyResourceGroupName" bez stronicowania.

Przykład 4

$odataFilter = "Name ne 'ABCD'"
Get-AzEventGridSubscription -ResourceGroupName MyResourceGroupName -TopicName Topic1 -Top 10 -ODataQuery $odataFilter
Get-AzEventGridSubscription $result.NextLink

Wyświetl listę pierwszych 10 subskrypcji zdarzeń (jeśli istnieją) utworzonych dla tematu "Topic1" w grupie zasobów "MyResourceGroupName", która spełnia zapytanie $odataFilter. Jeśli dostępnych jest więcej wyników, $result. Usługa NextLink nie będzie $null. Aby uzyskać kolejne strony subskrypcji zdarzeń, użytkownik powinien ponownie wywołać polecenie Get-AzEventGridSubscription i użyje wyniku. NextLink uzyskany z poprzedniego wywołania. Obiekt wywołujący powinien zatrzymać się, gdy wynik. Polecenie NextLink staje się $null.

Przykład 5

Get-AzEventGridSubscription -ResourceGroupName MyResourceGroupName -EventSubscriptionName EventSubscription1

Pobiera szczegóły subskrypcji zdarzeń "EventSubscription1" utworzonej dla grupy zasobów "MyResourceGroupName".

Przykład 6

Get-AzEventGridSubscription -EventSubscriptionName EventSubscription1

Pobiera szczegóły subskrypcji zdarzeń "EventSubscription1" utworzonej dla aktualnie wybranej subskrypcji platformy Azure.

Przykład 7

Get-AzEventGridSubscription -ResourceGroupName MyResourceGroupName

Pobiera listę wszystkich globalnych subskrypcji zdarzeń utworzonych w grupie zasobów "MyResourceGroupName" bez stronicowania.

Przykład 8

$odataFilter = "Name ne 'ABCD'"
Get-AzEventGridSubscription -ResourceGroupName MyResourceGroupName -Top 5 -ODataQuery $odataFilter
Get-AzEventGridSubscription $result.NextLink

Wyświetl listę pierwszych 5 subskrypcji zdarzeń (jeśli istnieje) utworzonych w grupie zasobów "MyResourceGroupName", która spełnia zapytanie $odataFilter. Jeśli dostępnych jest więcej wyników, $result. Usługa NextLink nie będzie $null. Aby uzyskać kolejne strony subskrypcji zdarzeń, użytkownik powinien ponownie wywołać polecenie Get-AzEventGridSubscription i użyje wyniku. NextLink uzyskany z poprzedniego wywołania. Obiekt wywołujący powinien zatrzymać się, gdy wynik. Polecenie NextLink staje się $null.

Przykład 9

Get-AzEventGridSubscription

Pobiera listę wszystkich globalnych subskrypcji zdarzeń utworzonych w ramach aktualnie wybranej subskrypcji platformy Azure bez stronicowania.

Przykład 10

$odataFilter = "Name ne 'ABCD'"
Get-AzEventGridSubscription -Top 15 -ODataQuery $odataFilter
Get-AzEventGridSubscription $result.NextLink

Wyświetl listę pierwszych 15 globalnych subskrypcji zdarzeń (jeśli istnieją) utworzonych w ramach aktualnie wybranej subskrypcji platformy Azure, która spełnia zapytanie $odataFilter. Jeśli dostępnych jest więcej wyników, $result. Usługa NextLink nie będzie $null. Aby uzyskać kolejne strony subskrypcji zdarzeń, użytkownik powinien ponownie wywołać polecenie Get-AzEventGridSubscription i użyje wyniku. NextLink uzyskany z poprzedniego wywołania. Obiekt wywołujący powinien zatrzymać się, gdy wynik. Polecenie NextLink staje się $null.

Przykład 11

Get-AzEventGridSubscription -ResourceGroupName MyResourceGroupName -Location westus2

Pobiera listę wszystkich regionalnych subskrypcji zdarzeń utworzonych w grupie zasobów "MyResourceGroupName" w określonej lokalizacji "westus2" bez stronicowania.

Przykład 12

$odataFilter = "Name ne 'ABCD'"
Get-AzEventGridSubscription -ResourceGroupName MyResourceGroupName -Location westus2 -Top 15 -ODataQuery $odataFilter
Get-AzEventGridSubscription $result.NextLink

Wyświetl listę pierwszych 15 regionalnych subskrypcji zdarzeń (jeśli istnieją) utworzonych w grupie zasobów "MyResourceGroupName" w określonej lokalizacji "westus2", która spełnia zapytanie $odataFilter. Jeśli dostępnych jest więcej wyników, $result. Usługa NextLink nie będzie $null. Aby uzyskać kolejne strony subskrypcji zdarzeń, użytkownik powinien ponownie wywołać polecenie Get-AzEventGridSubscription i użyje wyniku. NextLink uzyskany z poprzedniego wywołania. Obiekt wywołujący powinien zatrzymać się, gdy wynik. Polecenie NextLink staje się $null.

Przykład 13

Get-AzEventGridSubscription -ResourceId "/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.EventHub/namespaces/$namespaceName"

Pobiera listę wszystkich subskrypcji zdarzeń utworzonych dla określonej przestrzeni nazw usługi EventHub bez stronicowania.

Przykład 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

Wyświetl listę pierwszych 25 subskrypcji zdarzeń (jeśli istnieją) utworzonych dla określonej przestrzeni nazw usługi EventHub, która spełnia zapytanie $odataFilter. Jeśli dostępnych jest więcej wyników, $result. Usługa NextLink nie będzie $null. Aby uzyskać kolejne strony subskrypcji zdarzeń, użytkownik powinien ponownie wywołać polecenie Get-AzEventGridSubscription i użyje wyniku. NextLink uzyskany z poprzedniego wywołania. Obiekt wywołujący powinien zatrzymać się, gdy wynik. Polecenie NextLink staje się $null.

Przykład 15

Get-AzEventGridSubscription -TopicTypeName "Microsoft.EventHub.Namespaces" -Location $location

Pobiera listę wszystkich subskrypcji zdarzeń utworzonych dla określonego typu tematu (przestrzenie nazw usługi EventHub) w określonej lokalizacji bez stronicowania.

Przykład 16

$odataFilter = "Name ne 'ABCD'"
Get-AzEventGridSubscription -TopicTypeName "Microsoft.EventHub.Namespaces" -Location $location -Top 15 -ODataQuery $odataFilter
Get-AzEventGridSubscription $result.NextLink

Wyświetl listę pierwszych 15 subskrypcji zdarzeń (jeśli istnieją) utworzonych dla określonego typu tematu (przestrzenie nazw usługi EventHub) w określonej lokalizacji, która spełnia zapytanie $odataFilter. Jeśli dostępnych jest więcej wyników, $result. Usługa NextLink nie będzie $null. Aby uzyskać kolejne strony subskrypcji zdarzeń, użytkownik powinien ponownie wywołać polecenie Get-AzEventGridSubscription i użyje wyniku. NextLink uzyskany z poprzedniego wywołania. Obiekt wywołujący powinien zatrzymać się, gdy wynik. Polecenie NextLink staje się $null.

Przykład 17

Get-AzEventGridSubscription -TopicTypeName "Microsoft.Resources.ResourceGroups" -ResourceGroupName MyResourceGroupName

Pobiera listę wszystkich subskrypcji zdarzeń utworzonych dla określonej grupy zasobów bez stronicowania.

Przykład 18

$odataFilter = "Name ne 'ABCD'"
Get-AzEventGridSubscription -TopicTypeName "Microsoft.Resources.ResourceGroups" -ResourceGroupName MyResourceGroupName -Top 100 -ODataQuery $odataFilter
Get-AzEventGridSubscription $result.NextLink

Wyświetl listę pierwszych 100 subskrypcji zdarzeń (jeśli istnieją) utworzonych dla określonej grupy zasobów, która spełnia zapytanie $odataFilter. Jeśli dostępnych jest więcej wyników, $result. Usługa NextLink nie będzie $null. Aby uzyskać kolejne strony subskrypcji zdarzeń, użytkownik powinien ponownie wywołać polecenie Get-AzEventGridSubscription i użyje wyniku. NextLink uzyskany z poprzedniego wywołania. Obiekt wywołujący powinien zatrzymać się, gdy wynik. Polecenie NextLink staje się $null.

Parametry

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure

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

-DomainInputObject

EventGrid Obiekt domeny.

Type:PSDomain
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DomainName

EventGrid nazwa domeny.

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

-DomainTopicInputObject

EventGrid Obiekt tematu domeny.

Type:PSDomainTopic
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DomainTopicName

EventGrid nazwa tematu domeny.

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

-EventSubscriptionName

Nazwa subskrypcji zdarzeń

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

-IncludeFullEndpointUrl

Uwzględnij pełny adres URL punktu końcowego miejsca docelowego subskrypcji zdarzeń.

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

-InputObject

EventGrid, obiekt tematu.

Type:PSTopic
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Location

Lokalizacja

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

Link do następnej strony zasobów, które mają zostać uzyskane. Ta wartość jest uzyskiwana przy użyciu pierwszego wywołania polecenia cmdlet Get-AzEventGrid, gdy więcej zasobów jest nadal dostępnych do odpytowania.

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

-ODataQuery

Zapytanie OData używane do filtrowania wyników listy. Filtrowanie jest obecnie dozwolone tylko dla właściwości Name. Obsługiwane operacje obejmują: CONTAINS, eq (for equal), ne (for not equal), AND, OR i NOT.

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

-ResourceGroupName

Nazwa grupy zasobów.

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

-ResourceId

Identyfikator zasobu, do którego utworzono subskrypcje zdarzeń.

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

-Top

Zapytanie OData używane do filtrowania wyników listy. Filtrowanie jest obecnie dozwolone tylko dla właściwości Name. Obsługiwane operacje obejmują: CONTAINS, eq (for equal), ne (for not equal), AND, OR i NOT.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-TopicName

Nazwa tematu usługi EventGrid.

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

-TopicTypeName

Nazwa typu tematu

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

Dane wejściowe

String

PSTopic

PSDomain

PSDomainTopic

Nullable<T>[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Dane wyjściowe

PSEventSubscription