New-AzureRmEventGridSubscription

Reference

Modul:: AzureRM.EventGrid

Vytvoří nové předplatné událostí Azure Event Gridu pro téma, prostředek Azure, předplatné Azure nebo skupinu prostředků.

Upozorňující

Modul AzureRM PowerShell je od 29. února 2024 oficiálně zastaralý. Uživatelům se doporučuje migrovat z AzureRM do modulu Az PowerShell, aby se zajistila nepřetržitá podpora a aktualizace.

I když může modul AzureRM stále fungovat, už se neudržuje ani nepodporuje, přičemž jakékoli další použití se bude umisťovat podle vlastního uvážení a rizika uživatele. Pokyny k přechodu na modul Az najdete v našich zdrojích informací o migraci.

Syntaxe

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

Vytvořte nové odběry událostí k tématu služby Azure Event Grid, podporovanému prostředku Azure, předplatnému Azure nebo skupině prostředků. Pokud chcete vytvořit odběr událostí pro aktuálně vybrané předplatné Azure, zadejte název odběru události a cílový koncový bod. Pokud chcete vytvořit odběr události pro skupinu prostředků, zadejte název skupiny prostředků kromě názvu odběru události a cílového koncového bodu. Pokud chcete vytvořit odběr událostí tématu služby Azure Event Grid, zadejte také název tématu. Pokud chcete vytvořit odběr události pro podporovaný prostředek Azure, zadejte úplné ID prostředku prostředku. Pokud chcete zobrazit seznam podporovaných typů, spusťte rutinu Get-AzureRmEventGridTopicType.

Příklady

Příklad 1

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

Vytvoří nové odběry událostí EventSubscription1 do tématu služby Azure Event Grid Téma1 ve skupině prostředků MyResourceGroupName s cílovým koncovým bodem webhooku https://requestb.in/19qlscd1. Odběr této události používá výchozí filtry.

Příklad 2

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

Vytvoří nové odběr událostí EventSubscription1 do skupiny prostředků MyResourceGroupName s cílovým koncovým bodem https://requestb.in/19qlscd1webhooku . Odběr této události používá výchozí filtry.

Příklad 3

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

Vytvoří nové odběr událostí EventSubscription1 pro aktuálně vybrané předplatné Azure s cílovým koncovým bodem https://requestb.in/19qlscd1webhooku . Odběr této události používá výchozí filtry.

Příklad 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

Vytvoří nové odběr událostí EventSubscription1 pro aktuálně vybrané předplatné Azure s cílovým koncovým bodem https://requestb.in/19qlscd1webhooku . Toto odběr událostí určuje další filtry pro typy událostí a předmět a do cílového koncového bodu se doručí pouze události odpovídající těmto filtrům.

Příklad 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"

Vytvoří nové předplatné události EventSubscription1 pro aktuálně vybrané předplatné Azure se zadaným centrem událostí jako cílem událostí. Odběr této události používá výchozí filtry.

Příklad 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

Vytvoří nové odběr událostí EventSubscription1 do oboru názvů EventHubu se zadaným cílovým koncovým bodem https://requestb.in/19qlscd1webhhok . Odběr této události používá výchozí filtry.

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:	SwitchParameter
Aliasy:	cf
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure

Typ:	IAzureContextContainer
Aliasy:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Endpoint

Cílový koncový bod odběru událostí. Může se jednat o adresu URL webhooku nebo ID prostředku Azure eventHubu.

Typ:	String
Position:	1
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-EndpointType

Typ koncového bodu Může to být webhook nebo eventhub.

Typ:	String
Přípustné hodnoty:	webhook, eventhub, webhook, eventhub
Position:	4
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-EventSubscriptionName

Název odběru události

Typ:	String
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-IncludedEventType

Filtr, který určuje seznam typů událostí, které se mají zahrnout. Pokud není zadáno, budou zahrnuty všechny typy událostí.

Typ:	String[]
Position:	7
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-InputObject

EventGrid Topic – objekt.

Typ:	PSTopic
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Label

Popisky odběru událostí

Typ:	String[]
Position:	8
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-ResourceGroupName

Skupina prostředků tématu.

Typ:	String
Aliasy:	ResourceGroup
Position:	2
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-ResourceId

Identifikátor prostředku, ke kterému se má odběr události vytvořit.

Typ:	String
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-SubjectBeginsWith

Filtr, který určuje, že budou zahrnuty pouze události odpovídající zadané předponě předmětu. Pokud není zadáno, budou zahrnuty události se všemi předponami předmětu.

Typ:	String
Position:	5
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-SubjectCaseSensitive

Filtr, který určuje, že pole předmětu by se mělo porovnávat citlivým způsobem na malá a velká písmena. Pokud ho nezadáte, bude se předmět porovnávat nerozlišeným způsobem.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SubjectEndsWith

Filtr, který určuje, že budou zahrnuty pouze události odpovídající zadané příponě předmětu. Pokud není zadáno, budou zahrnuty události se všemi příponami předmětu.

Typ:	String
Position:	6
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-TopicName

Název tématu, ke kterému se má odběr události vytvořit.

Typ:	String
Position:	3
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:	SwitchParameter
Aliasy:	wi
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

Vstupy

String

PSTopic

Parametry: InputObject (ByValue)

String[]

Výstupy

PSEventSubscription

Sdílet prostřednictvím