共用方式為

New-AzureRmServiceBusSubscription

  • 參考
模組:
AzureRM.ServiceBus

建立指定 服務匯流排 主題的訂用帳戶。

警告

自 2024 年 2 月 29 日起，AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組，以確保持續支援和更新。

雖然 AzureRM 模組可能仍可運作，但不再維護或支援它，但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引，請參閱我們的 移轉資源 。

語法

New-AzureRmServiceBusSubscription
   [-ResourceGroupName] <String>
   [-Namespace] <String>
   [-Topic] <String>
   [-Name] <String>
   [-AutoDeleteOnIdle <String>]
   [-DefaultMessageTimeToLive <String>]
   [-DeadLetteringOnMessageExpiration <Boolean>]
   [-DeadLetteringOnFilterEvaluationExceptions]
   [-EnableBatchedOperations <Boolean>]
   [-LockDuration <String>]
   [-MaxDeliveryCount <Int32>]
   [-RequiresSession <Boolean>]
   [-ForwardTo <String>]
   [-ForwardDeadLetteredMessagesTo <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-AzureRmServiceBusSubscription Cmdlet 會建立指定 服務匯流排 主題的新訂用帳戶。

範例

範例 1

PS C:\> New-AzureRmServiceBusSubscription -ResourceGroup Default-ServiceBus-WestUS -NamespaceName SB-Example1 -TopicName SB-Topic_exampl1 -SubscriptionName SB-TopicSubscription-Example1

Name                                      : SB-TopicSubscription-Example1
AccessedAt                                : 1/20/2017 3:18:54 AM
AutoDeleteOnIdle                          : 10675199.02:48:05.4775807
CountDetails                              : Microsoft.Azure.Management.ServiceBus.Models.MessageCountDetails
CreatedAt                                 : 1/20/2017 3:18:52 AM
DefaultMessageTimeToLive                  : 10675199.02:48:05.4775807
DeadLetteringOnMessageExpiration          : False
EnableBatchedOperations                   : True
LockDuration                              : 00:01:00
MaxDeliveryCount                          : 10
MessageCount                              : 0
RequiresSession                           : False
Status                                    : Active
UpdatedAt                                 : 1/20/2017 3:18:54 AM

建立指定 服務匯流排 主題的訂SB-TopicSubscription-Example1用帳戶SB-Topic_exampl1。

參數

-AutoDeleteOnIdle

指定 TimeSpan 閑置間隔，之後會自動刪除訂用帳戶。 最短持續時間為 5 分鐘。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-DeadLetteringOnFilterEvaluationExceptions

值，指出訂閱是否有篩選評估例外狀況的寄不出的信件支援。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-DeadLetteringOnMessageExpiration

郵件到期時寄不出的信件

類型:Nullable<T>[Boolean]
接受的值:TRUE, FALSE
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-DefaultMessageTimeToLive

生存值的時間範圍。 這是訊息到期的持續時間，從訊息傳送至 服務匯流排 開始。 這是當 TimeToLive 未在訊息本身上設定時所使用的預設值。 針對 Standard = Timespan.Max 和 Basic = 14 dyas

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:IAzureContextContainer
別名:AzureRmContext, AzureCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-EnableBatchedOperations

啟用批次作業 - 值，指出是否啟用伺服器端批次作業

類型:Nullable<T>[Boolean]
接受的值:TRUE, FALSE
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-ForwardDeadLetteredMessagesTo

轉寄寄不出的信件訊息的佇列/主題名稱

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-ForwardTo

要轉送訊息的佇列/主題名稱

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-LockDuration

鎖定持續時間

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-MaxDeliveryCount

MaxDeliveryCount - 傳遞計數上限。 在傳遞次數之後，會自動死電訊息。

類型:Nullable<T>[Int32]
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Name

訂用帳戶名稱

類型:String
別名:SubscriptionName
Position:3
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-Namespace

命名空間名稱

類型:String
別名:NamespaceName
Position:1
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-RequiresSession

RequiresSession - 指出此佇列是否需要重複偵測的值。

類型:Nullable<T>[Boolean]
接受的值:TRUE, FALSE
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-ResourceGroupName

資源群組的名稱

類型:String
別名:ResourceGroup
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-Topic

主題名稱

類型:String
別名:TopicName
Position:2
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

類型:SwitchParameter
別名:wi
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元: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]]

輸出

PSSubscriptionAttributes