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

New-AzureRmServiceBusQueue

  • 参考
模块:
AzureRM.ServiceBus

在指定的服务总线命名空间中创建服务总线队列。

警告

截至 2024 年 2 月 29 日，AzureRM PowerShell 模块已正式弃用。 为了确保持续获得支持和更新，建议用户从 AzureRM 迁移到 Az PowerShell 模块。

尽管 AzureRM 模块仍可能正常运行，但它不再维护或受支持，但会根据用户的自由裁量权和风险继续使用任何继续使用模块。 有关过渡到 Az 模块的指导，请参阅我们的迁移资源。

语法

New-AzureRmServiceBusQueue
   [-ResourceGroupName] <String>
   [-Namespace] <String>
   [-Name] <String>
   [-EnablePartitioning <Boolean>]
   [-LockDuration <String>]
   [-AutoDeleteOnIdle <String>]
   [-DefaultMessageTimeToLive <String>]
   [-DuplicateDetectionHistoryTimeWindow <String>]
   [-DeadLetteringOnMessageExpiration <Boolean>]
   [-EnableBatchedOperations]
   [-EnableExpress <Boolean>]
   [-MaxDeliveryCount <Int32>]
   [-MaxSizeInMegabytes <Int64>]
   [-MessageCount <Int64>]
   [-RequiresDuplicateDetection <Boolean>]
   [-RequiresSession <Boolean>]
   [-SizeInBytes <Int64>]
   [-ForwardTo <String>]
   [-ForwardDeadLetteredMessagesTo <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

New-AzureRmServiceBusQueue cmdlet 在指定的服务总线命名空间中创建服务总线队列。

示例

示例 1

PS C:\> New-AzureRmServiceBusQueue -ResourceGroup Default-ServiceBus-WestUS -NamespaceName SB-Example1 -QueueName SB-Queue_example1 -EnablePartitioning $True

Id                                  : /subscriptions/{subscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.ServiceBus/namespaces/SB-Example1/queues/SB-Queue_example1
Name                                : SB-Queue_example1
LockDuration                        : PT1M
AccessedAt                          : 1/1/0001 12:00:00 AM
AutoDeleteOnIdle                    : P10675199DT2H48M5.4775807S
CreatedAt                           : 10/11/2018 12:37:11 AM
DefaultMessageTimeToLive            : P10675199DT2H48M5.4775807S
DuplicateDetectionHistoryTimeWindow : PT10M
DeadLetteringOnMessageExpiration    : False
EnableExpress                       : False
EnablePartitioning                  : False
MaxDeliveryCount                    : 10
MaxSizeInMegabytes                  : 81920
MessageCount                        : 0
CountDetails                        : Microsoft.Azure.Management.ServiceBus.Models.MessageCountDetails
RequiresDuplicateDetection          : False
RequiresSession                     : False
SizeInBytes                         : 0
Status                              : Active
UpdatedAt                           : 10/11/2018 12:37:12 AM
ForwardTo                           :
ForwardDeadLetteredMessagesTo       :
EnableBatchedOperations             : False

在指定的服务总线命名空间SB-Example1中创建新的服务总线队列SB-Queue_example1。

参数

-AutoDeleteOnIdle

指定 TimeSpan 空闲间隔，之后会自动删除队列。 最短持续时间为 5 分钟。

Type:String
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

-DeadLetteringOnMessageExpiration

消息过期时死信

Type:Nullable<T>[Boolean]
Accepted values:TRUE, FALSE
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultMessageTimeToLive

生存值的时跨度。 这是消息过期的持续时间，从消息发送到服务总线时开始。 这是未在消息本身上设置 TimeToLive 时使用的默认值。 对于 Standard = Timespan.Max 和 Basic = 14 dyas

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DuplicateDetectionHistoryTimeWindow

指定重复检测历史记录时间窗口，即一个 TimeSpan 值，该值定义重复检测历史记录的持续时间。 默认值为 10 分钟。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-EnableBatchedOperations

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableExpress

EnableExpress - 指示是否启用 Express 实体的值。 快速队列将消息暂时保存在内存中，然后再将其写入永久性存储。

Type:Nullable<T>[Boolean]
Accepted values:TRUE, FALSE
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-EnablePartitioning

EnablePartitioning

Type:Nullable<T>[Boolean]
Accepted values:TRUE, FALSE
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ForwardDeadLetteredMessagesTo

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ForwardTo

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-LockDuration

锁定持续时间

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-MaxDeliveryCount

MaxDeliveryCount - 最大传递计数。 在传递数之后，消息会自动死机。

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-MaxSizeInMegabytes

MaxSizeInMegabytes - 队列的最大大小（以兆字节为单位），即为队列分配的内存大小。

Type:Nullable<T>[Int64]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-MessageCount

MessageCount - 队列中的消息数

Type:Nullable<T>[Int64]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

队列名称

Type:String
Aliases:QueueName
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Namespace

命名空间名称

Type:String
Aliases:NamespaceName
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-RequiresDuplicateDetection

RequiresDuplicateDetection - 一个值，该值指示队列是否支持会话的概念

Type:Nullable<T>[Boolean]
Accepted values:TRUE, FALSE
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-RequiresSession

RequiresSession - 指示此队列是否需要重复检测的值

Type:Nullable<T>[Boolean]
Accepted values:TRUE, FALSE
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

-SizeInBytes

SizeInBytes - 队列的大小（以字节为单位）

Type:Nullable<T>[Int64]
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

输入

String

Nullable<T>[[System.Boolean, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Nullable<T>[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Nullable<T>[[System.Int64, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

输出

PSQueueAttributes