Get-AzEventGridSubscription

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

Синтаксис

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

Описание

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

Примеры

Пример 1

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

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

Пример 2

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

Возвращает сведения о подписке на события EventSubscription1, созданной для раздела "Тема1" в группе ресурсов MyResourceGroupName, включая URL-адрес полной конечной точки, если это подписка на события на основе веб-перехватчика.

Пример 3

Get-AzEventGridSubscription -ResourceGroupName MyResourceGroupName -TopicName Topic1

Получите список всех подписок на события, созданные для раздела "Раздел1" в группе ресурсов MyResourceGroupName без разбиения на страницы.

Пример 4

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

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

Пример 5

Get-AzEventGridSubscription -ResourceGroupName MyResourceGroupName -EventSubscriptionName EventSubscription1

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

Пример 6

Get-AzEventGridSubscription -EventSubscriptionName EventSubscription1

Возвращает сведения о подписке на события EventSubscription1, созданной для выбранной в настоящее время подписки Azure.

Пример 7

Get-AzEventGridSubscription -ResourceGroupName MyResourceGroupName

Возвращает список всех глобальных подписок на события, созданных в группе ресурсов MyResourceGroupName без разбиения на страницы.

Пример 8

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

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

Пример 9

Get-AzEventGridSubscription

Возвращает список всех глобальных подписок на события, созданных в рамках выбранной подписки Azure без разбиения на страницы.

Пример 10

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

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

Пример 11

Get-AzEventGridSubscription -ResourceGroupName MyResourceGroupName -Location westus2

Возвращает список всех подписок на региональные события, созданные в группе ресурсов MyResourceGroupName, в указанном расположении "westus2" без разбиения на страницы.

Пример 12

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

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

Пример 13

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

Возвращает список всех подписок на события, созданных для указанного пространства имен EventHub без разбиения на страницы.

Пример 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

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

Пример 15

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

Возвращает список всех подписок на события, созданных для указанного типа раздела (пространства имен EventHub) в указанном расположении без разбиения на страницы.

Пример 16

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

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

Пример 17

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

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

Пример 18

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

Список первых 100 подписок на события (если таковые) созданы для конкретной группы ресурсов, которая удовлетворяет запросу $odataFilter. Если доступны дополнительные результаты, $result. NextLink не будет $null. Чтобы получить следующие страницы подписок на события, пользователь должен повторно вызвать Get-AzEventGridSubscription и использовать результат. 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

-DomainInputObject

Объект домена EventGrid.

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

-DomainName

Доменное имя EventGrid.

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

-DomainTopicInputObject

Объект EventGrid Domain Topic.

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

-DomainTopicName

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

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

-EventSubscriptionName

Имя для этой подписки на события

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

-IncludeFullEndpointUrl

Добавьте полный URL-адрес конечной точки назначения подписки на событие.

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

-InputObject

Объект EventGrid Topic.

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

-Location

Расположение

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

Ссылка для получения следующей страницы ресурсов. Это значение получается при первом вызове командлета 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:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceId

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

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

-Top

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

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

-TopicName

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

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

-TopicTypeName

Имя TopicType

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

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

String

PSTopic

PSDomain

PSDomainTopic

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

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

PSEventSubscription