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

New-AzEventHub

模块:: Az.EventHub Module

将一个新的事件中心创建为命名空间中的嵌套资源。

语法

CreateExpanded (默认值)

New-AzEventHub
    -Name <String>
    -NamespaceName <String>
    -ResourceGroupName <String>
    [-SubscriptionId <String>]
    [-ArchiveNameFormat <String>]
    [-BlobContainer <String>]
    [-CaptureEnabled]
    [-CleanupPolicy <String>]
    [-DestinationName <String>]
    [-Encoding <String>]
    [-IdentityType <String>]
    [-IntervalInSeconds <Int32>]
    [-MinCompactionLagInMin <Int64>]
    [-PartitionCount <Int64>]
    [-RetentionTimeInHour <Int64>]
    [-SizeLimitInBytes <Int32>]
    [-SkipEmptyArchive]
    [-Status <String>]
    [-StorageAccountResourceId <String>]
    [-TimestampType <String>]
    [-TombstoneRetentionTimeInHour <Int32>]
    [-UserAssignedIdentityId <String>]
    [-UserMetadata <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaIdentityNamespaceExpanded

New-AzEventHub
    -Name <String>
    -NamespaceInputObject <IEventHubIdentity>
    [-ArchiveNameFormat <String>]
    [-BlobContainer <String>]
    [-CaptureEnabled]
    [-CleanupPolicy <String>]
    [-DestinationName <String>]
    [-Encoding <String>]
    [-IdentityType <String>]
    [-IntervalInSeconds <Int32>]
    [-MinCompactionLagInMin <Int64>]
    [-PartitionCount <Int64>]
    [-RetentionTimeInHour <Int64>]
    [-SizeLimitInBytes <Int32>]
    [-SkipEmptyArchive]
    [-Status <String>]
    [-StorageAccountResourceId <String>]
    [-TimestampType <String>]
    [-TombstoneRetentionTimeInHour <Int32>]
    [-UserAssignedIdentityId <String>]
    [-UserMetadata <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaIdentityNamespace

New-AzEventHub
    -Name <String>
    -NamespaceInputObject <IEventHubIdentity>
    -Parameter <IEventhub>
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

将一个新的事件中心创建为命名空间中的嵌套资源。

示例

示例 1：创建 EventHub 实体

New-AzEventHub -Name myEventHub -ResourceGroupName myResourceGroup -NamespaceName myNamespace -RetentionTimeInHour 168 -PartitionCount 5 -CleanupPolicy Delete

ArchiveNameFormat            :
BlobContainer                :
CaptureEnabled               :
CleanupPolicy                : Delete
CreatedAt                    : 4/25/2023 3:55:45 AM
DataLakeAccountName          :
DataLakeFolderPath           :
DataLakeSubscriptionId       :
DestinationName              :
Encoding                     :
Id                           : /subscriptions/subscriptionId/resourceGroups/myResourceGroup/providers/Microsoft.EventHub/namespaces/myNamespace/eventhubs/myEventHub
IntervalInSeconds            :
Location                     : eastus
MessageRetentionInDay        : 7
Name                         : myEventHub
PartitionCount               : 5
PartitionId                  : {0, 1, 2, 3�}
ResourceGroupName            : myResourceGroup
RetentionTimeInHour          : 168
SizeLimitInBytes             :
SkipEmptyArchive             :
Status                       : Active
StorageAccountResourceId     :
SystemDataCreatedAt          :
SystemDataCreatedBy          :
SystemDataCreatedByType      :
SystemDataLastModifiedAt     :
SystemDataLastModifiedBy     :
SystemDataLastModifiedByType :
TombstoneRetentionTimeInHour :
Type                         : Microsoft.EventHub/namespaces/eventhubs
UpdatedAt                    : 4/25/2023 3:55:46 AM

使用 CleanupPolicy myEventHub在命名空间myNamespace上创建新的 eventhub 实体Delete。

示例 2：创建启用了捕获的 EventHub

New-AzEventHub -Name myEventHub -ResourceGroupName myResourceGroup -NamespaceName myNamespace -ArchiveNameFormat "{Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}" -BlobContainer container -CaptureEnabled -DestinationName EventHubArchive.AzureBlockBlob -Encoding Avro -IntervalInSeconds 600 -SizeLimitInBytes 11000000 -SkipEmptyArchive -StorageAccountResourceId "/subscriptions/subscriptionId/resourceGroups/myResourceGroup/providers/Microsoft.Storage/storageAccounts/myStorageAccount -CleanupPolicy Delete"

ArchiveNameFormat            : {Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}
BlobContainer                : container
CaptureEnabled               : true
CreatedAt                    : 9/1/2022 5:55:46 AM
DataLakeAccountName          :
DataLakeFolderPath           :
DataLakeSubscriptionId       :
DestinationName              :
Encoding                     : Avro
Id                           : /subscriptions/subscriptionId/resourceGroups/myResourceGroup/providers/Microsoft.EventHub/namespaces/myNamespace/eventhubs/myFirstEventHub
IntervalInSeconds            : 600
Location                     : centralus
MessageRetentionInDays       : 6
Name                         : myFirstEventHub
PartitionCount               : 5
PartitionId                  : {0}
ResourceGroupName            : myResourceGroup
RetentionTimeInHour          : 24
SizeLimitInBytes             : 11000000
SkipEmptyArchive             : true
Status                       : Active

在启用了捕获的命名空间myEventHub上创建新的 eventhub 实体myNamespace。

示例 3：创建 EventHub 实体

New-AzEventHub -Name myEventHub -ResourceGroupName myResourceGroup -NamespaceName myNamespace -CleanupPolicy Compact

ArchiveNameFormat            :
BlobContainer                :
CaptureEnabled               :
CleanupPolicy                : Compact
CreatedAt                    : 4/25/2023 4:05:57 AM
DataLakeAccountName          :
DataLakeFolderPath           :
DataLakeSubscriptionId       :
DestinationName              :
Encoding                     :
Id                           : /subscriptions/subscriptionId/resourceGroups/myResourceGroup/providers/Microsoft.EventHub/namespaces/myNamespace/eventhubs/myEventHub
IntervalInSeconds            :
Location                     : eastus
MessageRetentionInDay        : 9223372036854775807
Name                         : myEventHub
PartitionCount               : 4
PartitionId                  : {0, 1, 2, 3}
ResourceGroupName            : myResourceGroup
RetentionTimeInHour          :
SizeLimitInBytes             :
SkipEmptyArchive             :
Status                       : Active
StorageAccountResourceId     :
SystemDataCreatedAt          :
SystemDataCreatedBy          :
SystemDataCreatedByType      :
SystemDataLastModifiedAt     :
SystemDataLastModifiedBy     :
SystemDataLastModifiedByType :
TombstoneRetentionTimeInHour :
Type                         : Microsoft.EventHub/namespaces/eventhubs
UpdatedAt                    : 4/25/2023 4:05:58 AM

使用 CleanupPolicy myEventHub在命名空间myNamespace上创建新的 eventhub 实体Compact。

参数

-ArchiveNameFormat

存档的 Blob 命名约定，例如 {Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}。此处的所有参数（Namespace，EventHub .. 等）都是强制性的，无论顺序如何

参数属性

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

参数集

CreateExpanded

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

CreateViaIdentityNamespaceExpanded

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

-BlobContainer

Blob 容器名称

参数属性

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

参数集

CreateExpanded

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

CreateViaIdentityNamespaceExpanded

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

-CaptureEnabled

一个值，该值指示是否启用捕获说明。

参数属性

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

参数集

CreateExpanded

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

CreateViaIdentityNamespaceExpanded

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

-CleanupPolicy

枚举清理策略的可能值

参数属性

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

参数集

CreateExpanded

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

CreateViaIdentityNamespaceExpanded

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

-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

-DestinationName

捕获目标的名称

参数属性

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

参数集

CreateExpanded

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

CreateViaIdentityNamespaceExpanded

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

-Encoding

枚举捕获说明的编码格式的可能值。注意：新 API 版本中将弃用“AvroDeflate”

参数属性

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

参数集

CreateExpanded

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

CreateViaIdentityNamespaceExpanded

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

-IdentityType

Azure Active Directory 托管标识的类型。

参数属性

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

参数集

CreateExpanded

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

CreateViaIdentityNamespaceExpanded

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

-IntervalInSeconds

使用时间范围可以设置捕获到 Azure Blob 的频率，值应介于 60 到 900 秒之间

参数属性

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

参数集

CreateExpanded

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

CreateViaIdentityNamespaceExpanded

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

-MinCompactionLagInMin

消息在日志中无法压缩的最短时间。当 cleanupPolicy 为 Compact 或 DeleteOrCompact 时，将使用此值。

参数属性

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

参数集

CreateExpanded

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

CreateViaIdentityNamespaceExpanded

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

-Name

事件中心名称

参数属性

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

参数集

(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

列表或获取事件中心操作中的单个项

参数属性

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

参数集

CreateViaIdentityNamespace

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

-PartitionCount

为事件中心创建的分区数，允许的值从 1 到 32 个分区。

参数属性

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

参数集

CreateExpanded

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

CreateViaIdentityNamespaceExpanded

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

-ResourceGroupName

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

参数属性

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

参数集

CreateExpanded

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

-RetentionTimeInHour

保留此事件中心的事件的小时数。这应该是命名空间 SKU 最大值的正值。-1 是一种特殊情况，即保留时间是无限的，但实体的大小受到限制，其大小取决于命名空间 SKU 类型。

参数属性

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

参数集

CreateExpanded

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

CreateViaIdentityNamespaceExpanded

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

-SizeLimitInBytes

大小窗口定义在捕获操作之前在事件中心生成的数据量，值应在10485760到524288000字节之间

参数属性

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

参数集

CreateExpanded

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

CreateViaIdentityNamespaceExpanded

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

-SkipEmptyArchive

一个值，该值指示是否跳过空存档

参数属性

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

参数集

CreateExpanded

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

CreateViaIdentityNamespaceExpanded

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

-Status

枚举事件中心状态的可能值。

参数属性

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

参数集

CreateExpanded

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

CreateViaIdentityNamespaceExpanded

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

-StorageAccountResourceId

用于创建 Blob 的存储帐户的资源 ID

参数属性

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

参数集

CreateExpanded

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

CreateViaIdentityNamespaceExpanded

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

-TimestampType

表示消息将保留的时间戳类型。两种类型的时间戳类型 -“AppendTime”和“CreateTime”。 AppendTime 是指在中转站日志中追加消息的时间。 CreateTime 是指在源端生成消息的时间，生成者可以在发送消息时设置此时间戳。默认值为 AppendTime。如果使用 AMQP 协议，CreateTime 等于 AppendTime 及其行为保持不变。

参数属性

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

参数集

CreateExpanded

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

CreateViaIdentityNamespaceExpanded

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

-TombstoneRetentionTimeInHour

保留压缩事件中心的逻辑删除标记的小时数。当 cleanupPolicy 为 Compact 或 DeleteOrCompact 时，将使用此值。使用者必须在此指定的时间范围内完成读取墓碑标记（如果使用者从起始偏移开始）以确保它们获取压缩事件中心内逻辑删除标记所描述的特定键的有效快照

参数属性

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

参数集

CreateExpanded

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

CreateViaIdentityNamespaceExpanded

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

-UserAssignedIdentityId

托管用户标识的 ARM ID。此属性是必需的，类型为 UserAssignedIdentity。如果类型为 SystemAssigned，则将使用与命名空间关联的系统分配标识。

参数属性

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

参数集

CreateExpanded

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

CreateViaIdentityNamespaceExpanded

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

-UserMetadata

获取和设置用户的元数据。

参数属性

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

参数集

CreateExpanded

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

CreateViaIdentityNamespaceExpanded

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-AzEventHub

语法

CreateExpanded (默认值)

CreateViaIdentityNamespaceExpanded

CreateViaIdentityNamespace

说明

示例

示例 1：创建 EventHub 实体

示例 2：创建启用了捕获的 EventHub

示例 3：创建 EventHub 实体

参数

-ArchiveNameFormat

参数属性

参数集

-BlobContainer

参数属性

参数集

-CaptureEnabled

参数属性

参数集

-CleanupPolicy

参数属性

参数集

-Confirm

参数属性

参数集

-DefaultProfile

参数属性

参数集

-DestinationName

参数属性

参数集

-Encoding

参数属性

参数集

-IdentityType

参数属性

参数集

-IntervalInSeconds

参数属性

参数集

-MinCompactionLagInMin

参数属性

参数集

-Name

参数属性

参数集

-NamespaceInputObject

参数属性

参数集

-NamespaceName

参数属性

参数集

-Parameter

参数属性

参数集

-PartitionCount

参数属性

参数集

-ResourceGroupName

参数属性

参数集

-RetentionTimeInHour

参数属性

参数集

-SizeLimitInBytes

参数属性

参数集

-SkipEmptyArchive

参数属性

参数集

-Status

参数属性

参数集

-StorageAccountResourceId

参数属性

参数集

-SubscriptionId

参数属性