New-AzureRmEventGridSubscription

參考

模組:: AzureRM.EventGrid

建立主題、Azure 資源、Azure 訂用帳戶或資源群組的新 Azure 事件方格事件訂用帳戶。

警告

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

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

語法

New-AzureRmEventGridSubscription
   [-EventSubscriptionName] <String>
   [-Endpoint] <String>
   [[-ResourceGroupName] <String>]
   [[-EndpointType] <String>]
   [[-SubjectBeginsWith] <String>]
   [[-SubjectEndsWith] <String>]
   [-SubjectCaseSensitive]
   [[-IncludedEventType] <String[]>]
   [[-Label] <String[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmEventGridSubscription
   [-ResourceId] <String>
   [-EventSubscriptionName] <String>
   [-Endpoint] <String>
   [[-EndpointType] <String>]
   [[-SubjectBeginsWith] <String>]
   [[-SubjectEndsWith] <String>]
   [-SubjectCaseSensitive]
   [[-IncludedEventType] <String[]>]
   [[-Label] <String[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmEventGridSubscription
   [-InputObject] <PSTopic>
   [-EventSubscriptionName] <String>
   [-Endpoint] <String>
   [[-EndpointType] <String>]
   [[-SubjectBeginsWith] <String>]
   [[-SubjectEndsWith] <String>]
   [-SubjectCaseSensitive]
   [[-IncludedEventType] <String[]>]
   [[-Label] <String[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmEventGridSubscription
   [-EventSubscriptionName] <String>
   [-Endpoint] <String>
   [-ResourceGroupName] <String>
   [-TopicName] <String>
   [[-EndpointType] <String>]
   [[-SubjectBeginsWith] <String>]
   [[-SubjectEndsWith] <String>]
   [-SubjectCaseSensitive]
   [[-IncludedEventType] <String[]>]
   [[-Label] <String[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

建立 Azure 事件方格主題的新事件訂用帳戶、支援的 Azure 資源、Azure 訂用帳戶或資源群組。若要為目前選取的 Azure 訂用帳戶建立事件訂用帳戶，請指定事件訂用帳戶名稱和目的地端點。若要建立資源群組的事件訂用帳戶，除了事件訂用帳戶名稱和目的地端點之外，還要指定資源組名。若要建立 Azure 事件方格主題的事件訂用帳戶，請同時指定主題名稱。若要為支援的 Azure 資源建立事件訂用帳戶，請指定資源的完整資源識別碼。若要檢視支援的類型清單，請執行 Get-AzureRmEventGridTopicType Cmdlet。

範例

範例 1

PS C:\> New-AzureRmEventGridSubscription -ResourceGroup MyResourceGroup -TopicName Topic1 -Endpoint https://requestb.in/19qlscd1 -EventSubscriptionName EventSubscription1

使用 Webhook 目的地端點https://requestb.in/19qlscd1，在資源群組 'MyResourceGroupName' 中，將新的事件訂用帳戶 'EventSubscription1' 建立至 Azure 事件方格主題 'Topic1'。此事件訂用帳戶會使用預設篩選條件。

範例 2

PS C:\> New-AzureRmEventGridSubscription -ResourceGroup MyResourceGroupName -Endpoint https://requestb.in/19qlscd1 -EventSubscriptionName EventSubscription1

使用 Webhook 目的地端點 https://requestb.in/19qlscd1，建立資源群組 'MyResourceGroupName' 的新事件訂用帳戶 'EventSubscription1'。此事件訂用帳戶會使用預設篩選條件。

範例 3

PS C:\> New-AzureRmEventGridSubscription -Endpoint https://requestb.in/19qlscd1 -EventSubscriptionName EventSubscription1

使用 Webhook 目的地端點 https://requestb.in/19qlscd1，為目前選取的 Azure 訂用帳戶建立新的事件訂用帳戶 'EventSubscription1'。此事件訂用帳戶會使用預設篩選條件。

範例 4

PS C:\> $includedEventTypes = "Microsoft.Resources.ResourceWriteFailure", "Microsoft.Resources.ResourceWriteSuccess"
PS C:\> $labels = "Finance", "HR"
PS C:\> New-AzureRmEventGridSubscription -Endpoint https://requestb.in/19qlscd1 -EventSubscriptionName EventSubscription1 -SubjectBeginsWith "TestPrefix" -SubjectEndsWith "TestSuffix" -IncludedEventType $includedEventTypes -Label $labels

使用 Webhook 目的地端點 https://requestb.in/19qlscd1，為目前選取的 Azure 訂用帳戶建立新的事件訂用帳戶 'EventSubscription1'。此事件訂用帳戶會指定事件類型和主旨的其他篩選，而且只會將符合這些篩選的事件傳遞至目的地端點。

範例 5

PS C:\> New-AzureRmEventGridSubscription -EventSubscriptionName EventSubscription1 -EndpointType "eventhub" -Endpoint "/subscriptions/55f3dcd4-cac7-43b4-990b-a139d62a1eb2/resourceGroups/TestRG/providers/Microsoft.EventHub/namespaces/ContosoNamespace/eventhubs/EH1"

使用指定的事件中樞作為事件目的地，為目前選取的 Azure 訂用帳戶建立新的事件訂用帳戶 'EventSubscription1'。此事件訂用帳戶會使用預設篩選條件。

範例 6

PS C:\> New-AzureRmEventGridSubscription -ResourceId "/subscriptions/55f3dcd4-cac7-43b4-990b-a139d62a1eb2/resourceGroups/TestRG/providers/Microsoft.EventHub/namespaces/ContosoNamespace" -Endpoint https://requestb.in/19qlscd1 -EventSubscriptionName EventSubscription1

使用指定的 webhhok 目的地端點 https://requestb.in/19qlscd1，為 EventHub 命名空間建立新的事件訂用帳戶 'EventSubscription1'。此事件訂用帳戶會使用預設篩選條件。

參數

-Confirm

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

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

-DefaultProfile

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

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

-Endpoint

事件訂用帳戶目的地端點。這可以是 Webhook URL 或 EventHub 的 Azure 資源識別碼。

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

-EndpointType

端點類型。這可以是 Webhook 或 eventhub

類型:	String
接受的值:	webhook, eventhub, webhook, eventhub
Position:	4
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-EventSubscriptionName

事件訂用帳戶的名稱

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

-IncludedEventType

篩選，指定要包含的事件類型清單。如果未指定，則會包含所有事件類型。

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

-InputObject

EventGrid Topic 物件。

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

-Label

事件訂用帳戶的標籤

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

-ResourceGroupName

主題的資源群組。

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

-ResourceId

應建立事件訂用帳戶之資源的標識碼。

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

-SubjectBeginsWith

篩選條件，指定只會包含符合指定主體前置詞的事件。如果未指定，則會包含具有所有主體前置詞的事件。

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

-SubjectCaseSensitive

指定以區分大小寫的方式比較主旨欄位的篩選條件。如果未指定，則會以不區分大小寫的方式比較主旨。

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

-SubjectEndsWith

篩選條件，指定只會包含符合指定主旨後綴的事件。如果未指定，則會包含具有所有主旨後綴的事件。

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

-TopicName

應建立事件訂閱的主題名稱。

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

-WhatIf

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

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

輸入

String

PSTopic

參數：InputObject （ByValue）

String[]

輸出

PSEventSubscription

共用方式為