Get-AzEventGridTopic

Ссылка

Модуль:: Az.EventGrid

Возвращает сведения о разделе сетки событий или получает список всех разделов сетки событий в текущей подписке Azure.

Синтаксис

Get-AzEventGridTopic
   [[-ResourceGroupName] <String>]
   [-ODataQuery <String>]
   [-Top <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzEventGridTopic
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-ODataQuery <String>]
   [-Top <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzEventGridTopic
   [-ResourceId] <String>
   [-ODataQuery <String>]
   [-Top <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzEventGridTopic
   [-NextLink <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Описание

Командлет Get-AzEventGridTopic получает сведения об указанной теме сетки событий или список всех разделов сетки событий в текущей подписке Azure. Если указано имя раздела, возвращается сведения о одной теме сетки событий. Если имя раздела не указано, возвращается список разделов. Количество элементов, возвращаемых в этом списке, управляется параметром Top. Если значение верхнего значения не указано или $null, список будет содержать все элементы тем. В противном случае в списке будет указано максимальное количество элементов, возвращаемых в списке. Если дополнительные разделы по-прежнему доступны, значение в NextLink должно использоваться в следующем вызове, чтобы получить следующую страницу тем. Наконец, параметр ODataQuery используется для фильтрации результатов поиска. Запрос фильтрации следует синтаксису OData, используя только свойство Name. Поддерживаемые операции включают: CONTAINS, eq (for equal), ne (for not equal), AND, OR и NOT.

Примеры

Пример 1

Get-AzEventGridTopic -ResourceGroup MyResourceGroupName -Name Topic1

Возвращает сведения о разделе сетки событий "Раздел1" в группе ресурсов MyResourceGroupName.

Пример 2

Get-AzEventGridTopic -ResourceId "/subscriptions/$subscriptionId/resourceGroups/MyResourceGroupName/providers/Microsoft.EventGrid/topics/Topic1"

Возвращает сведения о разделе сетки событий "Раздел1" в группе ресурсов MyResourceGroupName.

Пример 3

Get-AzEventGridTopic -ResourceGroup MyResourceGroupName

Список всех разделов сетки событий в группе ресурсов MyResourceGroupName без разбиения на страницы.

Пример 4

$odataFilter = "Name ne 'ABCD'"
$result = Get-AzEventGridTopic -ResourceGroup MyResourceGroupName -Top 10 -ODataQuery $odataFilter
Get-AzEventGridTopic $result.NextLink

Список первых 10 разделов сетки событий (при наличии) в группе ресурсов MyResourceGroupName, которая удовлетворяет запросу $odataFilter. Если доступны дополнительные результаты, $result. NextLink не будет $null. Чтобы получить следующие страницы разделов, пользователь должен повторно вызвать Get-AzEventGridTopic и использовать результат. NextLink, полученный из предыдущего вызова. Вызывающий объект должен остановиться, когда результат. NextLink становится $null.

Пример 5

Get-AzEventGridTopic

Список всех разделов сетки событий в подписке без разбиения на страницы.

Пример 6

$odataFilter = "Name ne 'ABCD'"
$result = Get-AzEventGridTopic -Top 10 -ODataQuery $odataFilter
Get-AzEventGridTopic $result.NextLink

Список первых 10 разделов сетки событий (если таковые есть) в подписке, которая удовлетворяет запросу $odataFilter. Если доступны дополнительные результаты, $result. NextLink не будет $null. Чтобы получить следующие страницы разделов, пользователь должен повторно вызвать Get-AzEventGridTopic и использовать результат. NextLink, полученный из предыдущего вызова. Вызывающий объект должен остановиться, когда результат. NextLink становится $null.

Параметры

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure

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

-Name

Имя раздела EventGrid.

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

-NextLink

Ссылка для получения следующей страницы ресурсов. Это значение получается при первом вызове командлета Get-AzEventGrid, когда запросы по-прежнему доступны больше ресурсов.

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

-ODataQuery

Запрос OData, используемый для фильтрации результатов списка. Фильтрация в настоящее время разрешена только в свойстве Name. Поддерживаемые операции включают: CONTAINS, eq (for equal), ne (for not equal), AND, OR и NOT.

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

-ResourceGroupName

Имя группы ресурсов.

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

-ResourceId

Идентификатор ресурса, представляющий раздел сетки событий.

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

-Top

Максимальное количество полученных ресурсов. Допустимое значение составляет от 1 до 100. Если указано первое значение и все еще доступны дополнительные результаты, результат будет содержать ссылку на следующую страницу, чтобы запросить в NextLink. Если значение верхнего значения не указано, полный список ресурсов будет возвращен одновременно.

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

Входные данные

String

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

Выходные данные

PSTopic

PSTopicListInstance