New-AzEventGridNamespaceTopicEventSubscription

參考

模組:: Az.EventGrid

使用指定的參數，以異步方式建立命名空間主題的事件訂閱。現有的事件訂用帳戶將會使用此 API 更新。

語法

New-AzEventGridNamespaceTopicEventSubscription
   -EventSubscriptionName <String>
   -NamespaceName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -TopicName <String>
   [-DeliveryConfigurationDeliveryMode <String>]
   [-EventDeliverySchema <String>]
   [-FilterConfigurationFilter <IFilter[]>]
   [-FilterConfigurationIncludedEventType <String[]>]
   [-IdentityType <String>]
   [-QueueEventTimeToLive <TimeSpan>]
   [-QueueMaxDeliveryCount <Int32>]
   [-QueueReceiveLockDurationInSecond <Int32>]
   [-UserAssignedIdentity <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzEventGridNamespaceTopicEventSubscription
   -EventSubscriptionName <String>
   -NamespaceName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -TopicName <String>
   -JsonString <String>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzEventGridNamespaceTopicEventSubscription
   -EventSubscriptionName <String>
   -NamespaceName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -TopicName <String>
   -JsonFilePath <String>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzEventGridNamespaceTopicEventSubscription
   -EventSubscriptionName <String>
   -TopicInputObject <IEventGridIdentity>
   [-DeliveryConfigurationDeliveryMode <String>]
   [-EventDeliverySchema <String>]
   [-FilterConfigurationFilter <IFilter[]>]
   [-FilterConfigurationIncludedEventType <String[]>]
   [-IdentityType <String>]
   [-QueueEventTimeToLive <TimeSpan>]
   [-QueueMaxDeliveryCount <Int32>]
   [-QueueReceiveLockDurationInSecond <Int32>]
   [-UserAssignedIdentity <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzEventGridNamespaceTopicEventSubscription
   -EventSubscriptionName <String>
   -TopicName <String>
   -NamespaceInputObject <IEventGridIdentity>
   [-DeliveryConfigurationDeliveryMode <String>]
   [-EventDeliverySchema <String>]
   [-FilterConfigurationFilter <IFilter[]>]
   [-FilterConfigurationIncludedEventType <String[]>]
   [-IdentityType <String>]
   [-QueueEventTimeToLive <TimeSpan>]
   [-QueueMaxDeliveryCount <Int32>]
   [-QueueReceiveLockDurationInSecond <Int32>]
   [-UserAssignedIdentity <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzEventGridNamespaceTopicEventSubscription
   -InputObject <IEventGridIdentity>
   [-DeliveryConfigurationDeliveryMode <String>]
   [-EventDeliverySchema <String>]
   [-FilterConfigurationFilter <IFilter[]>]
   [-FilterConfigurationIncludedEventType <String[]>]
   [-IdentityType <String>]
   [-QueueEventTimeToLive <TimeSpan>]
   [-QueueMaxDeliveryCount <Int32>]
   [-QueueReceiveLockDurationInSecond <Int32>]
   [-UserAssignedIdentity <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

使用指定的參數，以異步方式建立命名空間主題的事件訂閱。現有的事件訂用帳戶將會使用此 API 更新。

範例

範例 1：使用指定的參數，以異步方式建立命名空間主題的事件訂閱。

$TimeSpan = New-TimeSpan -Hours 1 -Minutes 25
New-AzEventGridNamespaceTopicEventSubscription -EventSubscriptionName azps-eventsubname -NamespaceName azps-eventgridnamespace -ResourceGroupName azps_test_group_eventgrid -TopicName azps-topic -DeliveryConfigurationDeliveryMode Queue -QueueReceiveLockDurationInSecond 60 -QueueMaxDeliveryCount 4 -QueueEventTimeToLive $TimeSpan -EventDeliverySchema CloudEventSchemaV1_0

Name              ResourceGroupName
----              -----------------
azps-eventsubname azps_test_group_eventgrid

使用指定的參數，以異步方式建立命名空間主題的事件訂閱。現有的事件訂用帳戶將會使用此 API 更新。

參數

-AsJob

以作業身分執行命令

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

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

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

-DefaultProfile

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

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

-DeliveryConfigurationDeliveryMode

事件訂閱的傳遞模式。

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

-EventDeliverySchema

事件訂閱的事件傳遞架構。

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

-EventSubscriptionName

要建立的事件訂閱名稱。事件訂閱名稱長度必須介於 3 到 100 個字元之間，且只能使用英數位元。

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

-FilterConfigurationFilter

篩選事件訂閱所使用的篩選陣列。

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

-FilterConfigurationIncludedEventType

需要屬於事件訂用帳戶一部分的適用事件類型清單。如果想要訂閱所有預設事件類型，請將 IncludedEventTypes 設定為 null。

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

-IdentityType

所使用的受控識別類型。類型 'SystemAssigned， UserAssigned' 包含隱含建立的身分識別和一組使用者指派的身分識別。類型『None』將會移除任何身分識別。

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

-InputObject

Identity 參數

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

-JsonFilePath

提供給建立作業的 Json 檔案路徑

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

-JsonString

提供給建立作業的 Json 字串

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

-NamespaceInputObject

Identity 參數

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

-NamespaceName

命名空間的名稱。

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

-NoWait

以異步方式執行命令

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

-QueueEventTimeToLive

ISO 8601 格式的時間範圍持續時間，決定從發佈訊息的時間起，訂閱可以使用多久的訊息。此持續時間值會使用下列格式來表示：『P（n）Y（n）M（n）DT（n）H（n）M（n）S'，其中： - （n）會取代為後面每個時間元素的值（n）。

P 是持續時間（或期間）指示項，且一律放在持續時間的開頭。
Y 是年份指示項，它會遵循年份數的值。
M 是月份指示項，它會遵循月份數的值。
W 是周指示項，它會遵循周數的值。
D 是日期指示項，它會遵循天數的值。
T 是時間指示項，在時間元件之前。
H 是小時指示項，它會遵循小時數的值。
M 是分鐘指示項，它會遵循分鐘數的值。
S 是第二個指示項，它會遵循秒數的值。此持續時間值無法設定大於主題的 EventRetentionInDays。這是選擇性欄位，其最小值為 1 分鐘，且其最大值取決於主題的 EventRetentionInDays 值。以下是有效值的範例： - 'P0DT23H12M' 或 'PT23H12M'：持續時間為 23 小時 12 分鐘。
'P1D' 或 'P1DT0H0M0S'：持續時間為 1 天。

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

-QueueMaxDeliveryCount

事件的最大傳遞計數。

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

-QueueReceiveLockDurationInSecond

在收到訊息並等待接受、釋放或拒絕的秒數上限期間。如果用戶端收到訊息後經過此時間，且未轉換為已接受（未處理）、已釋出或拒絕，則訊息可供重新傳遞。這是選擇性欄位，預設值為 60 秒，最小值為 60 秒，最大值為 300 秒。

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

-ResourceGroupName

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

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

-SubscriptionId

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

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

-TopicInputObject

Identity 參數

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

-TopicName

命名空間主題的名稱。

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

-UserAssignedIdentity

與資源相關聯的使用者身分識別。

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

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。

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

輸入

IEventGridIdentity

輸出

ISubscription

共用方式為

New-AzEventGridNamespaceTopicEventSubscription

語法

Description

範例

範例 1：使用指定的參數，以異步方式建立命名空間主題的事件訂閱。

參數

-AsJob

-Confirm

-DefaultProfile

-DeliveryConfigurationDeliveryMode

-EventDeliverySchema

-EventSubscriptionName

-FilterConfigurationFilter

-FilterConfigurationIncludedEventType

-IdentityType

-InputObject

-JsonFilePath

-JsonString

-NamespaceInputObject

-NamespaceName

-NoWait

-QueueEventTimeToLive

-QueueMaxDeliveryCount

-QueueReceiveLockDurationInSecond

-ResourceGroupName

-SubscriptionId

-TopicInputObject

-TopicName

-UserAssignedIdentity

-WhatIf

輸入

輸出

其他資源