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

Get-AzEventGridSystemTopic

参考

模块:: Az.EventGrid

获取事件网格系统主题的详细信息，或获取当前 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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

EventGrid 主题名称。

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

-NextLink

要获取的下一页资源的链接。当仍有更多资源可供查询时，使用第一个 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:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Top

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

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

输出

PSSystemTopic

PSSytemTopicListInstance