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

New-AzEventHubConsumerGroup

模块:: Az.EventHub Module

创建事件中心使用者组作为命名空间中的嵌套资源。

语法

CreateExpanded (默认值)

New-AzEventHubConsumerGroup
    -Name <String>
    -EventHubName <String>
    -NamespaceName <String>
    -ResourceGroupName <String>
    [-SubscriptionId <String>]
    [-UserMetadata <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaIdentityNamespaceExpanded

New-AzEventHubConsumerGroup
    -Name <String>
    -EventHubName <String>
    -NamespaceInputObject <IEventHubIdentity>
    [-UserMetadata <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaIdentityNamespace

New-AzEventHubConsumerGroup
    -Name <String>
    -EventHubName <String>
    -NamespaceInputObject <IEventHubIdentity>
    -Parameter <IConsumerGroup>
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaIdentityEventhubExpanded

New-AzEventHubConsumerGroup
    -Name <String>
    -EventhubInputObject <IEventHubIdentity>
    [-UserMetadata <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaIdentityEventhub

New-AzEventHubConsumerGroup
    -Name <String>
    -EventhubInputObject <IEventHubIdentity>
    -Parameter <IConsumerGroup>
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

创建事件中心使用者组作为命名空间中的嵌套资源。

示例

示例 1：创建 EventHub ConsumerGroup

New-AzEventHubConsumerGroup -Name myConsumerGroup -NamespaceName myNamespace -ResourceGroupName myResourceGroup -EventHubName myEventHub -UserMetadata "Test ConsumerGroup"

CreatedAt                    : 9/13/2022 9:20:47 AM
Id                           : /subscriptions/subscriptionId/resourceGroups/myResourceGroup/providers/Microsoft.EventHub/namespaces/myNamespace
                               /eventhubs/eh1/consumergroups/myConsumerGroup
Location                     : australiaeast
Name                         : myConsumerGroup
ResourceGroupName            : myResourceGroup
UpdatedAt                    : 9/13/2022 9:20:47 AM
UserMetadata                 : Test ConsumerGroup

为 EventHubs 实体myConsumerGroup创建新的使用者组myEventHub。

参数

-Confirm

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

参数属性

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

参数集

(All)

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

-DefaultProfile

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

参数属性

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

参数集

(All)

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

-EventhubInputObject

标识参数

参数属性

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

参数集

CreateViaIdentityEventhubExpanded

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

CreateViaIdentityEventhub

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

-EventHubName

事件中心名称

参数属性

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

参数集

CreateExpanded

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

CreateViaIdentityNamespaceExpanded

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

CreateViaIdentityNamespace

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

-Name

使用者组名称

参数属性

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

参数集

(All)

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

-NamespaceInputObject

标识参数

参数属性

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

参数集

CreateViaIdentityNamespaceExpanded

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

CreateViaIdentityNamespace

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

-NamespaceName

命名空间名称

参数属性

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

参数集

CreateExpanded

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

-Parameter

列表或获取使用者组作中的单个项

参数属性

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

参数集

CreateViaIdentityNamespace

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

CreateViaIdentityEventhub

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

-ResourceGroupName

Azure 订阅中的资源组的名称。

参数属性

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

参数集

CreateExpanded

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

-SubscriptionId

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

参数属性

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

参数集

CreateExpanded

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

-UserMetadata

用户元数据是一个占位符，用于存储最大长度为 1024 的用户定义字符串数据。例如，它可用于存储描述性数据，例如团队列表及其联系信息，还可以存储用户定义的配置设置。

参数属性

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

参数集

CreateExpanded

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

CreateViaIdentityNamespaceExpanded

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

CreateViaIdentityEventhubExpanded

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。

通过

New-AzEventHubConsumerGroup

语法

CreateExpanded (默认值)

CreateViaIdentityNamespaceExpanded

CreateViaIdentityNamespace

CreateViaIdentityEventhubExpanded

CreateViaIdentityEventhub

说明

示例

示例 1：创建 EventHub ConsumerGroup

参数

-Confirm

参数属性

参数集

-DefaultProfile

参数属性

参数集

-EventhubInputObject

参数属性

参数集

-EventHubName

参数属性

参数集

-Name

参数属性

参数集

-NamespaceInputObject

参数属性

参数集

-NamespaceName

参数属性

参数集

-Parameter

参数属性

参数集

-ResourceGroupName

参数属性

参数集

-SubscriptionId

参数属性

参数集

-UserMetadata

参数属性

参数集

-WhatIf

参数属性

参数集

CommonParameters

输入

IConsumerGroup

IEventHubIdentity

输出

IConsumerGroup

反馈