你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Get-AzEventGridDomainTopic

获取事件网格域主题的详细信息,或获取当前 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 cmdlet 获取指定事件网格域主题的详细信息,或当前 Azure 订阅中特定域下所有事件网格域主题的列表。 如果提供了域主题名称,则会返回单个事件网格域主题的详细信息。 如果未提供域主题名称,则会返回指定域名下的域主题列表。 此列表中返回的元素数由 Top 参数控制。 如果未指定 Top 值或$null,列表将包含所有域主题项。 否则,Top 将指示列表中要返回的最大元素数。 如果仍有更多域主题可用,则应在下一次调用中使用 NextLink 中的值来获取域主题的下一页。 最后,ODataQuery 参数用于对搜索结果执行筛选。 筛选查询仅使用 Name 属性遵循 OData 语法。 支持的操作包括:CONTAINS、eq(等于)、ne(不等于)、AND、OR 和 NOT。

示例

示例 1

获取资源组“MyResourceGroupName”中事件网格域“Domain1”下事件网格域主题“DomainTopic1”的详细信息。

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

使用 ResourceId 选项获取资源组“MyResourceGroupName”中事件网格域“Domain1”下事件网格域主题“DomainTopic1”的详细信息。

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

列出资源组“MyResourceGroupName”中事件网格域“Domain1”下的所有事件网格域主题(所有结果均在一次拍摄中返回)。

$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

使用 ResourceId 选项列出资源组“MyResourceGroupName”中事件网格域“Domain1”下的所有事件网格域主题(所有结果都以一次拍摄方式返回)

$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

列出资源组“MyResourceGroupName”中的域“Domain1”下的事件网格域主题(如果有的话),该主题一次 $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

要获取的下一页资源的链接。 当仍有更多资源可供查询时,使用第一个 Get-AzEventGrid cmdlet 调用获取此值。

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

-ODataQuery

用于筛选列表结果的 OData 查询。 目前仅允许对 Name 属性进行筛选。支持的操作包括:CONTAINS、eq(等于)、ne(不等于)、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(等于)、ne(不等于)、AND、OR 和 NOT。

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

输入

String

Int32

输出

PSDomainTopic

PSDomainTopicListInstance