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

Get-AzEventGridSystemTopic

获取事件网格系统主题的详细信息,或获取当前 Azure 订阅中所有事件网格系统主题的列表。

语法

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

说明

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

示例

示例 1

Get-AzEventGridSystemTopic -ResourceGroup MyResourceGroupName -Name Topic1

获取资源组“MyResourceGroupName”中的事件网格系统主题“Topic1”的详细信息。

示例 2

Get-AzEventGridSystemTopic -ResourceGroup MyResourceGroupName

列出资源组“MyResourceGroupName”中没有分页的所有事件网格系统主题。

示例 3

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

如果资源组“MyResourceGroupName”中满足$odataFilter查询的任何) ,则列出前 10 个事件网格系统主题 (。 如果有更多结果可用,$result。NextLink 不会$null。 若要获取主题 () 下一页,用户应重新调用Get-AzEventGridSystemTopic并使用结果。从上一次调用获取的 NextLink。 调用方在结果时应停止。NextLink 变为$null。

示例 4

Get-AzEventGridSystemTopic

列出订阅中没有分页的所有事件网格主题。

示例 5

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

如果订阅中满足$odataFilter查询的任何) ,则列出前 10 个事件网格系统主题 (。 如果有更多结果可用,$result。NextLink 不会$null。 若要获取主题 () 下一页,用户应重新调用Get-AzEventGridSystemTopic并使用结果。从上一次调用获取的 NextLink。 调用方在结果时应停止。NextLink 变为$null。

参数

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

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

-Name

EventGrid 主题名称。

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

-NextLink

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

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

-ODataQuery

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

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

-ResourceGroupName

资源组的名称。

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

-Top

要获取的最大资源数。 有效值为 1 到 100。 如果指定了顶部值,并且仍有更多结果可用,则结果将包含指向下一页的链接,可在 NextLink 中查询。 如果未指定 Top 值,将同时返回资源的完整列表。

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

输入

String

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

输出

PSSystemTopic

PSSytemTopicListInstance