共用方式為

New-AzServiceBusTopic

  • 參考
模組:
Az.ServiceBus

在指定的命名空間中建立主題。

語法

New-AzServiceBusTopic
   -Name <String>
   -NamespaceName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   [-AutoDeleteOnIdle <TimeSpan>]
   [-DefaultMessageTimeToLive <TimeSpan>]
   [-DuplicateDetectionHistoryTimeWindow <TimeSpan>]
   [-EnableBatchedOperations]
   [-EnableExpress]
   [-EnablePartitioning]
   [-MaxMessageSizeInKilobytes <Int64>]
   [-MaxSizeInMegabytes <Int32>]
   [-RequiresDuplicateDetection]
   [-Status <String>]
   [-SupportOrdering]
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzServiceBusTopic
   -Name <String>
   -NamespaceInputObject <IServiceBusIdentity>
   [-AutoDeleteOnIdle <TimeSpan>]
   [-DefaultMessageTimeToLive <TimeSpan>]
   [-DuplicateDetectionHistoryTimeWindow <TimeSpan>]
   [-EnableBatchedOperations]
   [-EnableExpress]
   [-EnablePartitioning]
   [-MaxMessageSizeInKilobytes <Int64>]
   [-MaxSizeInMegabytes <Int32>]
   [-RequiresDuplicateDetection]
   [-Status <String>]
   [-SupportOrdering]
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzServiceBusTopic
   -Name <String>
   -NamespaceInputObject <IServiceBusIdentity>
   -Parameter <ISbTopic>
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

在指定的命名空間中建立主題。

範例

範例 1：建立新的 ServiceBus 主題

New-AzServiceBusTopic -ResourceGroupName myResourceGroup -NamespaceName myNamespace -Name myTopic -DefaultMessageTimeToLive (New-TimeSpan -Days 18) -EnableBatchedOperations

AccessedAt                                : 1/1/0001 12:00:00 AM
AutoDeleteOnIdle                          : 10675199.02:48:05.4775807
CountDetailActiveMessageCount             : 0
CountDetailDeadLetterMessageCount         : 0
CountDetailScheduledMessageCount          : 0
CountDetailTransferDeadLetterMessageCount : 0
CountDetailTransferMessageCount           : 0
CreatedAt                                 : 1/1/0001 12:00:00 AM
DefaultMessageTimeToLive                  : 18.00:00:00
DuplicateDetectionHistoryTimeWindow       : 00:10:00
EnableBatchedOperations                   : True
EnableExpress                             : False
EnablePartitioning                        : False
Id                                        : /subscriptions/000000000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ServiceBus/namespaces/myNamespace/topics/myTopic
Location                                  : westus
MaxMessageSizeInKilobytes                 : 1024
MaxSizeInMegabytes                        : 1024
Name                                      : myTopic
RequiresDuplicateDetection                : False
ResourceGroupName                         : myResourceGroup
SizeInByte                                : 0
Status                                    : Active
SubscriptionCount                         : 0
SupportOrdering                           : True

在命名空間 myNamespace中建立新的 ServiceBus 主題myTopic。

參數

-AutoDeleteOnIdle

閑置間隔之後，佇列會自動刪除。 最短持續時間為 5 分鐘。

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

-Confirm

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

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

-DefaultMessageTimeToLive

這是訊息到期的持續時間，從訊息傳送至 服務匯流排 開始。 這是當 TimeToLive 未在訊息本身上設定時所使用的預設值。

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

-DefaultProfile

DefaultProfile 參數無法運作。 如果針對不同的訂用帳戶執行 Cmdlet，請使用 SubscriptionId 參數。

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

-DuplicateDetectionHistoryTimeWindow

定義重複偵測記錄的持續時間。 預設值為 10 分鐘。

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

-EnableBatchedOperations

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

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

-EnableExpress

值，指出是否啟用 Express 實體。 快速主題會在將訊息寫入永續性記憶體之前，暫時將訊息儲存在記憶體中。

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

-EnablePartitioning

值，指出是否已啟用跨多個訊息代理程式分割的主題。

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

-MaxMessageSizeInKilobytes

主題可接受之訊息承載的大小上限（以 KB 為單位）。 這個屬性目前只會在 Premium 中使用，預設值為 1024。

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

-MaxSizeInMegabytes

主題的大小上限，以 MB 為單位，這是為主題配置的記憶體大小。 預設值為 1024。

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

-Name

主題名稱。

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

-NamespaceInputObject

Identity 參數

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

-NamespaceName

命名空間名稱

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

-Parameter

主題資源的描述。

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

-RequiresDuplicateDetection

指出本主題是否需要重複偵測的值。

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

-ResourceGroupName

Azure 訂用帳戶內的資源組名。

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

-Status

列舉傳訊實體狀態的可能值。

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

-SubscriptionId

可唯一識別Microsoft Azure 訂用帳戶的訂用帳戶認證。 訂用帳戶識別碼會構成每個服務呼叫 URI 的一部分。

類型:String
Position:Named
預設值:(Get-AzContext).Subscription.Id
必要:False
接受管線輸入:False
接受萬用字元:False

-SupportOrdering

值，指出主題是否支援排序。

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

-WhatIf

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

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

輸入

ISbTopic

IServiceBusIdentity

輸出

ISbTopic