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

New-AzServiceBusSubscription

模块:: Az.ServiceBus Module

创建主题订阅。

语法

CreateExpanded (默认值)

New-AzServiceBusSubscription
    -Name <String>
    -NamespaceName <String>
    -ResourceGroupName <String>
    -TopicName <String>
    [-SubscriptionId <String>]
    [-AutoDeleteOnIdle <TimeSpan>]
    [-ClientId <String>]
    [-DeadLetteringOnFilterEvaluationException]
    [-DeadLetteringOnMessageExpiration]
    [-DefaultMessageTimeToLive <TimeSpan>]
    [-DuplicateDetectionHistoryTimeWindow <TimeSpan>]
    [-EnableBatchedOperations]
    [-ForwardDeadLetteredMessagesTo <String>]
    [-ForwardTo <String>]
    [-IsClientAffine]
    [-IsDurable]
    [-IsShared]
    [-LockDuration <TimeSpan>]
    [-MaxDeliveryCount <Int32>]
    [-RequiresSession]
    [-Status <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaIdentityNamespaceExpanded

New-AzServiceBusSubscription
    -Name <String>
    -TopicName <String>
    -NamespaceInputObject <IServiceBusIdentity>
    [-AutoDeleteOnIdle <TimeSpan>]
    [-ClientId <String>]
    [-DeadLetteringOnFilterEvaluationException]
    [-DeadLetteringOnMessageExpiration]
    [-DefaultMessageTimeToLive <TimeSpan>]
    [-DuplicateDetectionHistoryTimeWindow <TimeSpan>]
    [-EnableBatchedOperations]
    [-ForwardDeadLetteredMessagesTo <String>]
    [-ForwardTo <String>]
    [-IsClientAffine]
    [-IsDurable]
    [-IsShared]
    [-LockDuration <TimeSpan>]
    [-MaxDeliveryCount <Int32>]
    [-RequiresSession]
    [-Status <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaIdentityNamespace

New-AzServiceBusSubscription
    -Name <String>
    -TopicName <String>
    -NamespaceInputObject <IServiceBusIdentity>
    -Parameter <ISbSubscription>
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaIdentityTopicExpanded

New-AzServiceBusSubscription
    -Name <String>
    -TopicInputObject <IServiceBusIdentity>
    [-AutoDeleteOnIdle <TimeSpan>]
    [-ClientId <String>]
    [-DeadLetteringOnFilterEvaluationException]
    [-DeadLetteringOnMessageExpiration]
    [-DefaultMessageTimeToLive <TimeSpan>]
    [-DuplicateDetectionHistoryTimeWindow <TimeSpan>]
    [-EnableBatchedOperations]
    [-ForwardDeadLetteredMessagesTo <String>]
    [-ForwardTo <String>]
    [-IsClientAffine]
    [-IsDurable]
    [-IsShared]
    [-LockDuration <TimeSpan>]
    [-MaxDeliveryCount <Int32>]
    [-RequiresSession]
    [-Status <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaIdentityTopic

New-AzServiceBusSubscription
    -Name <String>
    -TopicInputObject <IServiceBusIdentity>
    -Parameter <ISbSubscription>
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

创建主题订阅。

示例

示例 1：创建新的 ServiceBus 订阅

New-AzServiceBusSubscription -ResourceGroupName myResourceGroup -NamespaceName myNamespace -TopicName myTopic -Name mySubscription -DefaultMessageTimeToLive (New-TimeSpan -Days 6) -EnableBatchedOperations

AccessedAt                                : 1/1/0001 12:00:00 AM
AutoDeleteOnIdle                          : 10675199.02:48:05.4775807
ClientId                                  :
CountDetailActiveMessageCount             : 0
CountDetailDeadLetterMessageCount         : 0
CountDetailScheduledMessageCount          : 0
CountDetailTransferDeadLetterMessageCount : 0
CountDetailTransferMessageCount           : 0
CreatedAt                                 : 9/23/2022 2:37:46 PM
DeadLetteringOnFilterEvaluationException  : True
DeadLetteringOnMessageExpiration          : False
DefaultMessageTimeToLive                  : 6.00:00:00
DuplicateDetectionHistoryTimeWindow       :
EnableBatchedOperations                   : True
ForwardDeadLetteredMessagesTo             :
ForwardTo                                 :
Id                                        : /subscriptions/326100e2-f69d-4268-8503-075374f62b6e/resourceGroups/damorg/providers/Microsoft.ServiceBus/namespaces/testlatests
                                            bmsi/topics/a/subscriptions/testsub
IsClientAffine                            : False
IsDurable                                 :
IsShared                                  :
Location                                  : westus
LockDuration                              : 00:01:00
MaxDeliveryCount                          : 10
MessageCount                              : 0
Name                                      : testsub
RequiresSession                           : False
ResourceGroupName                         : damorg
Status                                    : Active

在主题mySubscription下创建新的 ServiceBus 订阅myTopic。

参数

-AutoDeleteOnIdle

自动删除队列之后的空闲间隔。最短持续时间为 5 分钟。

参数属性

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

参数集

CreateExpanded

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

CreateViaIdentityNamespaceExpanded

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

CreateViaIdentityTopicExpanded

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

-ClientId

指示创建客户端-affine 订阅的应用程序的客户端 ID。

参数属性

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

参数集

CreateExpanded

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

CreateViaIdentityNamespaceExpanded

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

CreateViaIdentityTopicExpanded

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

-Confirm

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

参数属性

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

参数集

(All)

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

-DeadLetteringOnFilterEvaluationException

指示订阅是否对筛选器评估异常具有死信支持的值。

参数属性

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

参数集

CreateExpanded

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

CreateViaIdentityNamespaceExpanded

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

CreateViaIdentityTopicExpanded

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

-DeadLetteringOnMessageExpiration

指示消息过期时订阅是否具有死信支持的值。

参数属性

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

参数集

CreateExpanded

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

CreateViaIdentityNamespaceExpanded

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

CreateViaIdentityTopicExpanded

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

-DefaultMessageTimeToLive

这是消息过期的持续时间，从消息发送到服务总线时开始。这是未在消息本身上设置 TimeToLive 时使用的默认值。

参数属性

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

参数集

CreateExpanded

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

CreateViaIdentityNamespaceExpanded

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

CreateViaIdentityTopicExpanded

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

-DefaultProfile

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

参数属性

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

参数集

(All)

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

-DuplicateDetectionHistoryTimeWindow

定义重复检测历史记录的持续时间。默认值为 10 分钟。

参数属性

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

参数集

CreateExpanded

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

CreateViaIdentityNamespaceExpanded

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

CreateViaIdentityTopicExpanded

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

-EnableBatchedOperations

指示是否启用服务器端批处理操作的值。

参数属性

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

参数集

CreateExpanded

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

CreateViaIdentityNamespaceExpanded

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

CreateViaIdentityTopicExpanded

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

-ForwardDeadLetteredMessagesTo

用于转发死信消息的队列/主题名称

参数属性

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

参数集

CreateExpanded

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

CreateViaIdentityNamespaceExpanded

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

CreateViaIdentityTopicExpanded

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

-ForwardTo

用于转发消息的队列/主题名称

参数属性

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

参数集

CreateExpanded

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

CreateViaIdentityNamespaceExpanded

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

CreateViaIdentityTopicExpanded

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

-IsClientAffine

指示订阅是否具有客户端 ID 的相关性的值。

参数属性

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

参数集

CreateExpanded

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

CreateViaIdentityNamespaceExpanded

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

CreateViaIdentityTopicExpanded

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

-IsDurable

对于客户端-affine 订阅，此值指示订阅是否持久。

参数属性

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

参数集

CreateExpanded

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

CreateViaIdentityNamespaceExpanded

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

CreateViaIdentityTopicExpanded

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

-IsShared

对于客户端-affine 订阅，此值指示是否共享订阅。

参数属性

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

参数集

CreateExpanded

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

CreateViaIdentityNamespaceExpanded

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

CreateViaIdentityTopicExpanded

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

-LockDuration

速览锁的时间跨度持续时间;也就是说，为其他接收方锁定消息的时间量。 LockDuration 的最大值为 5 分钟;默认值为 1 分钟。

参数属性

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

参数集

CreateExpanded

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

CreateViaIdentityNamespaceExpanded

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

CreateViaIdentityTopicExpanded

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

-MaxDeliveryCount

最大交付次数。

参数属性

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

参数集

CreateExpanded

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

CreateViaIdentityNamespaceExpanded

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

CreateViaIdentityTopicExpanded

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

-Name

订阅名称。

参数属性

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

参数集

(All)

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

-NamespaceInputObject

标识参数

参数属性

类型:	IServiceBusIdentity
默认值:	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

订阅资源的说明。

参数属性

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

参数集

CreateViaIdentityNamespace

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

CreateViaIdentityTopic

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

-RequiresSession

指示订阅是否支持会话概念的值。

参数属性

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

参数集

CreateExpanded

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

CreateViaIdentityNamespaceExpanded

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

CreateViaIdentityTopicExpanded

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

-ResourceGroupName

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

参数属性

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

参数集

CreateExpanded

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

-Status

枚举消息实体状态的可能值。

参数属性

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

参数集

CreateExpanded

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

CreateViaIdentityNamespaceExpanded

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

CreateViaIdentityTopicExpanded

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

-TopicInputObject

标识参数

参数属性

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

参数集

CreateViaIdentityTopicExpanded

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

CreateViaIdentityTopic

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

-TopicName

主题名称。

参数属性

类型:	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

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

语法

CreateExpanded (默认值)

CreateViaIdentityNamespaceExpanded

CreateViaIdentityNamespace

CreateViaIdentityTopicExpanded

CreateViaIdentityTopic

说明

示例

示例 1：创建新的 ServiceBus 订阅

参数

-AutoDeleteOnIdle

参数属性

参数集

-ClientId

参数属性

参数集

-Confirm

参数属性

参数集

-DeadLetteringOnFilterEvaluationException

参数属性

参数集

-DeadLetteringOnMessageExpiration

参数属性

参数集

-DefaultMessageTimeToLive

参数属性

参数集

-DefaultProfile

参数属性

参数集

-DuplicateDetectionHistoryTimeWindow

参数属性

参数集

-EnableBatchedOperations

参数属性

参数集

-ForwardDeadLetteredMessagesTo

参数属性

参数集

-ForwardTo

参数属性

参数集

-IsClientAffine

参数属性

参数集

-IsDurable

参数属性

参数集

-IsShared

参数属性

参数集

-LockDuration

参数属性

参数集

-MaxDeliveryCount

参数属性

参数集

-Name

参数属性

参数集

-NamespaceInputObject

参数属性

参数集

-NamespaceName

参数属性

参数集

-Parameter

参数属性

参数集

-RequiresSession

参数属性

参数集

-ResourceGroupName

参数属性

参数集

-Status

参数属性