你当前正在访问 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 |