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

New-AzEventGridTopic

模块:: Az.EventGrid Module

使用指定参数异步创建新主题。

语法

CreateExpanded (默认值)

New-AzEventGridTopic
    -Name <String>
    -ResourceGroupName <String>
    -Location <String>
    [-SubscriptionId <String>]
    [-DataResidencyBoundary <String>]
    [-DisableLocalAuth]
    [-EnableSystemAssignedIdentity]
    [-EventTypeInfoInlineEventType <Hashtable>]
    [-EventTypeInfoKind <String>]
    [-ExtendedLocationName <String>]
    [-ExtendedLocationType <String>]
    [-IdentityPrincipalId <String>]
    [-IdentityTenantId <String>]
    [-InboundIPRule <IInboundIPRule[]>]
    [-InputSchema <String>]
    [-Kind <String>]
    [-MinimumTlsVersionAllowed <String>]
    [-PublicNetworkAccess <String>]
    [-SkuName <String>]
    [-Tag <Hashtable>]
    [-UserAssignedIdentity <String[]>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaJsonString

New-AzEventGridTopic
    -Name <String>
    -ResourceGroupName <String>
    -JsonString <String>
    [-SubscriptionId <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaJsonFilePath

New-AzEventGridTopic
    -Name <String>
    -ResourceGroupName <String>
    -JsonFilePath <String>
    [-SubscriptionId <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaIdentityExpanded

New-AzEventGridTopic
    -InputObject <IEventGridIdentity>
    -Location <String>
    [-DataResidencyBoundary <String>]
    [-DisableLocalAuth]
    [-EnableSystemAssignedIdentity]
    [-EventTypeInfoInlineEventType <Hashtable>]
    [-EventTypeInfoKind <String>]
    [-ExtendedLocationName <String>]
    [-ExtendedLocationType <String>]
    [-IdentityPrincipalId <String>]
    [-IdentityTenantId <String>]
    [-InboundIPRule <IInboundIPRule[]>]
    [-InputSchema <String>]
    [-Kind <String>]
    [-MinimumTlsVersionAllowed <String>]
    [-PublicNetworkAccess <String>]
    [-SkuName <String>]
    [-Tag <Hashtable>]
    [-UserAssignedIdentity <String[]>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

使用指定参数异步创建新主题。

示例

示例 1：异步创建具有指定参数的新主题。

$inboundIpRule = New-AzEventGridInboundIPRuleObject -Action Allow -IPMask "12.18.176.1"
New-AzEventGridTopic -Name azps-topic -ResourceGroupName azps_test_group_eventgrid -Location eastus -PublicNetworkAccess Enabled -InboundIPRule $inboundIpRule

Location Name       Kind  ResourceGroupName
-------- ----       ----  -----------------
eastus   azps-topic Azure azps_test_group_eventgrid

使用指定的参数异步创建一个新主题。

参数

-AsJob

以作业身份运行命令

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Confirm

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

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	cf

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DataResidencyBoundary

资源的数据驻留边界。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateViaIdentityExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DefaultProfile

DefaultProfile 参数不起作用。如果对其他订阅执行 cmdlet，请使用 SubscriptionId 参数。

参数属性

类型:	PSObject
默认值:	None
支持通配符:	False
不显示:	False
别名:	AzureRMContext, AzureCredential

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DisableLocalAuth

此布尔值用于启用或禁用本地身份验证。默认值为 false。如果该属性设置为 true，则仅使用 AAD 令牌在允许用户发布到主题时进行身份验证。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateViaIdentityExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-EnableSystemAssignedIdentity

确定是否为资源启用系统分配的标识。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateViaIdentityExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-EventTypeInfoInlineEventType

资源的内联事件类型的集合。内联事件类型键是表示事件名称的类型字符串。有效的内联事件名称示例是“Contoso.OrderCreated”。内联事件类型值的类型为 InlineEventProperties，并且将包含每个内联事件类型的附加信息。

参数属性

类型:	Hashtable
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateViaIdentityExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-EventTypeInfoKind

所使用的事件类型。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateViaIdentityExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ExtendedLocationName

扩展位置的完全限定名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateViaIdentityExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ExtendedLocationType

扩展位置的类型。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateViaIdentityExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-IdentityPrincipalId

资源标识的主体 ID。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateViaIdentityExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-IdentityTenantId

资源的租户 ID。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateViaIdentityExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-InboundIPRule

这可用于限制来自特定 IP 而不是所有 IP 的流量。注意：仅当启用了 PublicNetworkAccess 时，才会考虑这些内容。

参数属性

类型:	IInboundIPRule[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateViaIdentityExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-InputObject

标识参数

参数属性

类型:	IEventGridIdentity
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateViaIdentityExpanded

Position:	Named
必需:	True
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-InputSchema

这决定了事件网格应该期望用于发布到主题的传入事件的格式。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateViaIdentityExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-JsonFilePath

提供给“创建”操作的 Json 文件的路径

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateViaJsonFilePath

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-JsonString

提供给“创建”操作的 Json 字符串

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateViaJsonString

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Kind

资源的种类。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateViaIdentityExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Location

资源的位置。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateViaIdentityExpanded

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-MinimumTlsVersionAllowed

允许发布到本主题的发布服务器的最低 TLS 版本

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateViaIdentityExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Name

主题名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False
别名:	主题名称

参数集

CreateExpanded

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateViaJsonString

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateViaJsonFilePath

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-NoWait

异步运行命令

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-PassThru

当命令成功时返回 true

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-PublicNetworkAccess

这决定了是否允许通过公用网络流量。默认情况下，它处于启用状态。可以通过配置 <seealso cref=“P：Microsoft.Azure.Events.ResourceProvider.Common.Contracts.TopicProperties.InboundIpRules” />

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateViaIdentityExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ResourceGroupName

用户订阅中的资源组的名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False
别名:	ResourceGroup

参数集

CreateExpanded

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateViaJsonString

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateViaJsonFilePath

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-SkuName

资源的 SKU 名称。可能的值包括：基本值或高级值。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateViaIdentityExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-SubscriptionId

唯一标识Microsoft Azure 订阅的订阅凭据。订阅 ID 构成了每个服务调用的 URI 的一部分。

参数属性

类型:	String
默认值:	(Get-AzContext).Subscription.Id
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateViaJsonString

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateViaJsonFilePath

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Tag

资源的标记。

参数属性

类型:	Hashtable
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateViaIdentityExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-UserAssignedIdentity

与资源关联的用户分配标识的数组。数组中的元素将为 ARM 资源 ID，格式为：“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}”。

参数属性

类型:	String[]
默认值:	None
支持通配符:	False
不显示:	False
别名:	IdentityId

参数集

CreateExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateViaIdentityExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。命令脚本未运行。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	无线

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。有关详细信息，请参阅 about_CommonParameters。