Get-AzEventGridSystemTopic
Pobiera szczegóły tematu systemu usługi Event Grid lub pobiera listę wszystkich tematów systemu usługi Event Grid w bieżącej subskrypcji platformy Azure.
Składnia
Get-AzEventGridSystemTopic
[-ResourceGroupName <String>]
[-ODataQuery <String>]
[-Top <Int32>]
[-NextLink <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzEventGridSystemTopic
[-ResourceGroupName <String>]
[-Name <String>]
[-ODataQuery <String>]
[-Top <Int32>]
[-NextLink <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Opis
Polecenie cmdlet Get-AzEventGridSystemTopic pobiera szczegóły określonego tematu systemu usługi Event Grid lub listę wszystkich tematów usługi Event Grid w bieżącej subskrypcji platformy Azure. Jeśli zostanie podana nazwa tematu, zostaną zwrócone szczegóły pojedynczego tematu usługi Event Grid. Jeśli nazwa tematu nie zostanie podana, zostanie zwrócona lista tematów. 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 tematów. 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 tematów jest nadal dostępnych, wartość w aplikacji NextLink powinna być używana w następnym wywołaniu, aby uzyskać następną stronę tematów. 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-AzEventGridSystemTopic -ResourceGroup MyResourceGroupName -Name Topic1
Pobiera szczegóły tematu systemowego usługi Event Grid "Topic1" w grupie zasobów "MyResourceGroupName".
Przykład 2
Get-AzEventGridSystemTopic -ResourceGroup MyResourceGroupName
Wyświetl listę wszystkich tematów systemu usługi Event Grid w grupie zasobów "MyResourceGroupName" bez stronicowania.
Przykład 3
$odataFilter = "Name ne 'ABCD'"
$result = Get-AzEventGridSystemTopic -ResourceGroup MyResourceGroupName -Top 10 -ODataQuery $odataFilter
Get-AzEventGridSystemTopic $result.NextLink
Wyświetl listę pierwszych 10 tematów systemu usługi Event Grid (jeśli istnieją) 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 tematów, użytkownik powinien ponownie wywołać metodę Get-AzEventGridSystemTopic i używa wyniku. NextLink uzyskany z poprzedniego wywołania. Obiekt wywołujący powinien zatrzymać się, gdy wynik. Polecenie NextLink staje się $null.
Przykład 4
Get-AzEventGridSystemTopic
Wyświetl listę wszystkich tematów usługi Event Grid w subskrypcji bez stronicowania.
Przykład 5
$odataFilter = "Name ne 'ABCD'"
$result = Get-AzEventGridSystemTopic -Top 10 -ODataQuery $odataFilter
Get-AzEventGridSystemTopic $result.NextLink
Wyświetl listę pierwszych 10 tematów systemu usługi Event Grid (jeśli istnieją) w subskrypcji, 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 tematów, użytkownik powinien ponownie wywołać metodę Get-AzEventGridSystemTopic i używa 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 |
-Name
Nazwa tematu usługi EventGrid.
Type: | String |
Aliases: | SystemTopicName |
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 |
-Top
Maksymalna liczba zasobów do uzyskania. Prawidłowa wartość to od 1 do 100. Jeśli zostanie określona górna wartość, a więcej wyników będzie nadal dostępnych, wynik będzie zawierać link do następnej strony, do którego będzie odpytywane zapytanie w aplikacji NextLink. Jeśli nie określono wartości Top, pełna lista zasobów zostanie zwrócona jednocześnie.
Type: | Nullable<T>[Int32] |
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]]