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

New-AzEventGridDomain

创建新的 Azure 事件网格域。

语法

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

说明

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

示例

示例 1

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

New-AzEventGridDomain -ResourceGroupName MyResourceGroupName -Name Domain1 -Location westus2

ResourceGroupName : MyResourceGroupName
DomainName        : Domain1
Id                : /subscriptions/<Azure Subscription Id>/resourceGroups/MyResourceGroupName/providers/Microsoft.EventGrid/domains/domain1
Type              : Microsoft.EventGrid/domains
Location          : westus2
Endpoint          : https://domain1.westus2-1.eventgrid.azure.net/api/events
ProvisioningState : Succeeded
Tags              :

示例 2

在指定地理位置“westus2”中创建事件网格域“Domain1”,在资源组“MyResourceGroupName”中创建具有指定标记“Department”和“Environment”的事件网格域。

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

ResourceGroupName : MyResourceGroupName
DomainName        : Domain1
Id                : /subscriptions/<Azure Subscription Id>/resourceGroups/MyResourceGroupName/providers/Microsoft.EventGrid/domains/domain1
Type              : Microsoft.EventGrid/domains
Location          : westus2
Endpoint          : https://domain1.westus2-1.eventgrid.azure.net/api/events
ProvisioningState : Succeeded
Tags              : {[Department, Finance], [Environment, Test]}

示例 3

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

New-AzEventGridDomain -ResourceGroupName MyResourceGroupName -Name Domain1 -Location westus2 -IdentityType "SystemAssigned"

示例 4

在具有给定标识 ID 的资源组“MyResourceGroupName”UserAssigned“标识类型中,在指定地理位置”westus2“中创建事件网格域”Domain1”。

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

New-AzEventGridDomain -ResourceGroupName MyResourceGroupName -Name Domain1 -Location westus2 -IdentityType "UserAssigned" -IdentityId $id1,$id2

参数

-AutoCreateTopicWithFirstSubscription

切换参数以使用第一个订阅自动创建主题

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

-AutoDeleteTopicWithLastSubscription

切换参数以使用最后一个订阅自动删除主题

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

-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

-DisableLocalAuth

切换参数以禁用本地身份验证。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
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

EventGrid 域名。

Type:String
Aliases:DomainName
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

输出

PSDomain