Udostępnij za pośrednictwem


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

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

String

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

Dane wyjściowe

PSSystemTopic

PSSytemTopicListInstance