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

New-AzEventGridTopic

参考

模块:: Az.EventGrid

创建新的Azure 事件网格主题。

语法

New-AzEventGridTopic
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-Location] <String>
   [-Tag <Hashtable>]
   [-InputSchema <String>]
   [-InputMappingField <Hashtable>]
   [-InputMappingDefaultValue <Hashtable>]
   [-InboundIpRule <Hashtable>]
   [-IdentityType <String>]
   [-IdentityId <String[]>]
   [-PublicNetworkAccess <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

创建新的Azure 事件网格主题。创建主题后，应用程序可以将事件发布到主题终结点。

示例

示例 1

New-AzEventGridTopic -ResourceGroupName MyResourceGroupName -Name Topic1 -Location westus2

在资源组“MyResourceGroupName”的指定地理位置“westus2”中创建事件网格主题“Topic1”。

示例 2

New-AzEventGridTopic -ResourceGroupName MyResourceGroupName -Name Topic1 -Location westus2 -Tag @{ Department="Finance"; Environment="Test" }

使用指定的标记“Department”和“Environment”在资源组“MyResourceGroupName”的指定地理位置“westus2”中创建事件网格主题“Topic1”。

示例 3

New-AzEventGridTopic -ResourceGroupName MyResourceGroupName -Name Topic1 -Location westus2 -IdentityType "SystemAssigned"

在具有“SystemAssigned”标识类型的资源组“MyResourceGroupName”的指定地理位置“westus2”中创建事件网格主题“Topic1”。

示例 4

$id1 = '/subscriptions/{subscriptionId}/resourceGroups/{resourcegroup}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/MSIName'
$id2 = '/subscriptions/{subscriptionId}/resourceGroups/{resourcegroup}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/MSIName'

New-AzEventGridTopic -ResourceGroupName MyResourceGroupName -Name Topic1 -Location westus2 -IdentityType "UserAssigned" -IdentityId $id1,$id2

在指定地理位置“westus2”中创建事件网格主题“Topic1”，在资源组“MyResourceGroupName”中使用给定标识 ID 的“UserAssigned”标识类型。

参数

-Confirm

提示你在运行 cmdlet 之前进行确认。

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

-DefaultProfile

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

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

-IdentityId

用户分配标识的列表

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

-IdentityType

不同的标识类型。可以是以下任一“SystemAssigned”、“UserAssigned”、“SystemAssigned、UserAssigned”、“None”

Type:	String
Accepted values:	SystemAssigned, UserAssigned, SystemAssigned, UserAssigned, None
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-InboundIpRule

表示入站 IP 规则列表的哈希表。每个规则指定 CIDR 表示法中的 IP 地址，例如 10.0.0.0.0/8 以及要基于匹配项或 IpMask 不匹配执行的相应操作。可能的操作值包括“仅允许”

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

-InputMappingDefaultValue

表示以空格分隔键 = 值格式的默认值的输入映射字段的哈希表。允许的密钥名称包括：subject、eventtype 和 dataversion。仅当 InputSchemaHelp 为 customeventschema 时，将使用此项。

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

-InputMappingField

表示空格分隔键 = 值格式的输入映射字段的哈希表。允许的密钥名称包括：id、topic、eventtime、subject、eventtype 和 dataversion。仅当 InputSchemaHelp 为 customeventschema 时，将使用此项。

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

-InputSchema

主题的输入事件的架构。允许的值为：eventgridschema、customeventschema 或 cloudeventv01Schema。默认值为 eventgridschema。请注意，如果指定 customeventschema，则还需要指定 InputMappingField 或/和 InputMappingDefaultValue 参数。

Type:	String
Accepted values:	EventGridSchema, CustomEventSchema, CloudEventSchemaV1_0
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Location

主题的位置

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

-Name

主题的名称。

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

-PublicNetworkAccess

这决定了是否允许通过公用网络流量。默认情况下，它处于启用状态。可以通过配置 InboundIpRule 参数进一步限制到特定 IP。允许的值被禁用并启用。

Type:	String
Accepted values:	enabled, disabled
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

-Tag

表示资源标记的哈希表。

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

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

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

输入

String

Hashtable

输出

PSTopic