Get-AzEventGridDomainTopic

  • Ссылка
Модуль:
Az.EventGrid

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

Синтаксис

Get-AzEventGridDomainTopic
   [-ResourceGroupName] <String>
   [-DomainName] <String>
   [-Name <String>]
   [-ODataQuery <String>]
   [-Top <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzEventGridDomainTopic
   [-ResourceId] <String>
   [-ODataQuery <String>]
   [-Top <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzEventGridDomainTopic
   [-NextLink <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Описание

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

Примеры

Пример 1

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

Get-AzEventGridDomainTopic -ResourceGroup MyResourceGroupName -DomainName Domain1 -DomainTopicName DomainTopic1

ResourceGroupName : MyResourceGroupName
DomainName        : DomainTopic1
DomainTopicName   : Topic1
Id                : /subscriptions/20902276-e53b-4421-8565-f57bcad74f6e/resourceGroups/MyResourceGroupName/providers/Microsoft.EventGrid/domains/Domain1/topics/DomainTopic1
Type              : Microsoft.EventGrid/domains/topics
ProvisioningState : Succeeded

Пример 2

Возвращает сведения о разделе домена сетки событий DomainTopic1 в домене сетки событий Domain1 в группе ресурсов MyResourceGroupName с помощью параметра ResourceId.

Get-AzEventGridDomainTopic -ResourceId "/subscriptions/$subscriptionId/resourceGroups/MyResourceGroupName/providers/Microsoft.EventGrid/domains/Domain1/topics/DomainTopic1"

ResourceGroupName : MyResourceGroupName
DomainName        : Domain1
DomainTopicName   : DomainTopic1
Id                : /subscriptions/20902276-e53b-4421-8565-f57bcad74f6e/resourceGroups/MyResourceGroupName/providers/Microsoft.EventGrid/domains/Domain1/topics/DomainTopic1
Type              : Microsoft.EventGrid/domains/topics
ProvisioningState : Succeeded

Пример 3

Список всех разделов домена сетки событий в домене Сетки событий "Domain1" в группе ресурсов "MyResourceGroupName" без разбиения на страницы (все результаты возвращаются в одном снимке).

$result=Get-AzEventGridDomainTopic -ResourceGroup MyResourceGroupName -DomainName Domain1
Write-Output $result.PsDomainTopicsList

ResourceGroupName : MyResourceGroupName
DomainName        : Domain1
DomainTopicName   : DomainTopic1
Id                : /subscriptions/20902276-e53b-4421-8565-f57bcad74f6e/resourceGroups/MyResourceGroupName/providers/Microsoft.EventGrid/domains/Domain1/topics/DomainTopic1
Type              : Microsoft.EventGrid/domains/topics
ProvisioningState : Succeeded


ResourceGroupName : MyResourceGroupName
DomainName        : Domain1
DomainTopicName   : DomainTopic2
Id                : /subscriptions/20902276-e53b-4421-8565-f57bcad74f6e/resourceGroups/MyResourceGroupName/providers/Microsoft.EventGrid/domains/Domain1/topics/DomainTopic2
Type              : Microsoft.EventGrid/domains/topics
ProvisioningState : Succeeded


ResourceGroupName : MyResourceGroupName
DomainName        : Domain1
DomainTopicName   : DomainTopic3
Id                : /subscriptions/20902276-e53b-4421-8565-f57bcad74f6e/resourceGroups/MyResourceGroupName/providers/Microsoft.EventGrid/domains/Domain1/topics/DomainTopic3
Type              : Microsoft.EventGrid/domains/topics
ProvisioningState : Succeeded

Пример 4

Список всех разделов домена Сетки событий в домене Сетки событий "Domain1" в группе ресурсов "MyResourceGroupName" без разбиения на страницы (все результаты возвращаются в одном снимке) с помощью параметра ResourceId

$result=Get-AzEventGridDomainTopic -ResourceId "/subscriptions/$subscriptionId/resourceGroups/MyResourceGroupName/providers/Microsoft.EventGrid/domains/Domain1"
Write-Output $result.PsDomainTopicsList

ResourceGroupName : MyResourceGroupName
DomainName        : Domain1
DomainTopicName   : DomainTopic1
Id                : /subscriptions/20902276-e53b-4421-8565-f57bcad74f6e/resourceGroups/MyResourceGroupName/providers/Microsoft.EventGrid/domains/Domain1/topics/DomainTopic1
Type              : Microsoft.EventGrid/domains/topics
ProvisioningState : Succeeded


ResourceGroupName : MyResourceGroupName
DomainName        : Domain1
DomainTopicName   : DomainTopic2
Id                : /subscriptions/20902276-e53b-4421-8565-f57bcad74f6e/resourceGroups/MyResourceGroupName/providers/Microsoft.EventGrid/domains/Domain1/topics/DomainTopic2
Type              : Microsoft.EventGrid/domains/topics
ProvisioningState : Succeeded


ResourceGroupName : MyResourceGroupName
DomainName        : Domain1
DomainTopicName   : DomainTopic3
Id                : /subscriptions/20902276-e53b-4421-8565-f57bcad74f6e/resourceGroups/MyResourceGroupName/providers/Microsoft.EventGrid/domains/Domain1/topics/DomainTopic3
Type              : Microsoft.EventGrid/domains/topics
ProvisioningState : Succeeded

Пример 5

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

$total = 0
$odataFilter = "Name ne 'ABCD'"
$result = Get-AzEventGridDomainTopic -ResourceGroup MyResourceGroupName -DomainName Domain1 -Top 10 -ODataQuery $odataFilter
$total += $result.Count
while ($result.NextLink -ne $Null)
    {
        $result = Get-AzEventGridDomainTopic -NextLink $result.NextLink
        $total += $result.Count
    }

Write-Output "Total number of domain topics is $Total"

Параметры

-DefaultProfile

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

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

-DomainName

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

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

-Name

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

Type:String
Aliases:DomainTopicName
Position:Named
Default value:None
Required:False
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

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

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

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

String

Int32

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

PSDomainTopic

PSDomainTopicListInstance