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 |
-NextLink
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
Nullable<T>[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]
Dane wyjściowe
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla