New-AzureRmEventGridSubscription

Module:

AzureRM.EventGrid

Hiermee maakt u een nieuw Azure Event Grid-gebeurtenisabonnement op een onderwerp, Azure-resource, Azure-abonnement of -resourcegroep.

Waarschuwing

De AzureRM PowerShell-module is vanaf 29 februari 2024 officieel afgeschaft. Gebruikers wordt aangeraden om van AzureRM naar de Az PowerShell-module te migreren om ondersteuning en updates te garanderen.

Hoewel de AzureRM-module nog steeds kan functioneren, wordt deze niet meer onderhouden of ondersteund, waardoor het gebruik naar eigen goeddunken en risico van de gebruiker blijft bestaan. Raadpleeg onze migratiebronnen voor hulp bij de overgang naar de Az-module.

Syntaxis

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

Maak een nieuw gebeurtenisabonnement op een Azure Event Grid-onderwerp, een ondersteunde Azure-resource, een Azure-abonnement of resourcegroep. Als u een gebeurtenisabonnement wilt maken op het momenteel geselecteerde Azure-abonnement, geeft u de naam van het gebeurtenisabonnement en het doeleindpunt op. Als u een gebeurtenisabonnement wilt maken voor een resourcegroep, geeft u de naam van de resourcegroep op naast de naam van het gebeurtenisabonnement en het doeleindpunt. Als u een gebeurtenisabonnement wilt maken op een Azure Event Grid-onderwerp, geeft u ook de onderwerpnaam op. Als u een gebeurtenisabonnement wilt maken op een ondersteunde Azure-resource, geeft u de volledige resource-id van de resource op. Als u de lijst met ondersteunde typen wilt weergeven, voert u de cmdlet Get-AzureRmEventGridTopicType uit.

Voorbeelden

Voorbeeld 1

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

Hiermee maakt u een nieuw gebeurtenisabonnement 'EventSubscription1' naar een Azure Event Grid-onderwerp 'Onderwerp1' in de resourcegroep 'MyResourceGroupName' met het doeleindpunt https://requestb.in/19qlscd1van de webhook. Dit gebeurtenisabonnement maakt gebruik van standaardfilters.

Voorbeeld 2

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

Hiermee maakt u een nieuw gebeurtenisabonnement 'EventSubscription1' naar een resourcegroep 'MyResourceGroupName' met het doeleindpunt https://requestb.in/19qlscd1van de webhook. Dit gebeurtenisabonnement maakt gebruik van standaardfilters.

Voorbeeld 3

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

Hiermee maakt u een nieuw gebeurtenisabonnement 'EventSubscription1' naar het geselecteerde Azure-abonnement met het doeleindpunt https://requestb.in/19qlscd1van de webhook. Dit gebeurtenisabonnement maakt gebruik van standaardfilters.

Voorbeeld 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

Hiermee maakt u een nieuw gebeurtenisabonnement 'EventSubscription1' naar het geselecteerde Azure-abonnement met het doeleindpunt https://requestb.in/19qlscd1van de webhook. Dit gebeurtenisabonnement geeft de extra filters op voor gebeurtenistypen en onderwerp, en alleen gebeurtenissen die overeenkomen met deze filters worden geleverd aan het doeleindpunt.

Voorbeeld 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"

Hiermee maakt u een nieuw gebeurtenisabonnement 'EventSubscription1' naar het momenteel geselecteerde Azure-abonnement met de opgegeven Event Hub als bestemming voor gebeurtenissen. Dit gebeurtenisabonnement maakt gebruik van standaardfilters.

Voorbeeld 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

Hiermee maakt u een nieuw gebeurtenisabonnement 'EventSubscription1' naar een EventHub-naamruimte met het opgegeven webhhok-doeleindpunt https://requestb.in/19qlscd1. Dit gebeurtenisabonnement maakt gebruik van standaardfilters.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:	SwitchParameter
Aliassen:	cf
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure

Type:	IAzureContextContainer
Aliassen:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Endpoint

Doeleindpunt van gebeurtenisabonnement. Dit kan een webhook-URL of de Azure-resource-id van een EventHub zijn.

Type:	String
Position:	1
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-EndpointType

Eindpunttype. Dit kan webhook of eventhub zijn

Type:	String
Geaccepteerde waarden:	webhook, eventhub, webhook, eventhub
Position:	4
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-EventSubscriptionName

De naam van het gebeurtenisabonnement

Type:	String
Position:	0
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-IncludedEventType

Filter waarmee een lijst met gebeurtenistypen wordt opgegeven die moeten worden opgenomen. Als dit niet is opgegeven, worden alle gebeurtenistypen opgenomen.

Type:	String[]
Position:	7
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-InputObject

EventGrid-onderwerpobject.

Type:	PSTopic
Position:	0
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Label

Labels voor het gebeurtenisabonnement

Type:	String[]
Position:	8
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ResourceGroupName

De resourcegroep van het onderwerp.

Type:	String
Aliassen:	ResourceGroup
Position:	2
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ResourceId

De id van de resource waaraan het gebeurtenisabonnement moet worden gemaakt.

Type:	String
Position:	0
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-SubjectBeginsWith

Filter dat aangeeft dat alleen gebeurtenissen die overeenkomen met het opgegeven onderwerpvoorvoegsel worden opgenomen. Als dit niet is opgegeven, worden gebeurtenissen met alle onderwerpvoorvoegsels opgenomen.

Type:	String
Position:	5
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-SubjectCaseSensitive

Filter dat aangeeft dat het onderwerpveld op een hoofdlettergevoelige manier moet worden vergeleken. Indien niet opgegeven, wordt het onderwerp op een niet-hoofdlettergevoelige manier vergeleken.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-SubjectEndsWith

Filter dat aangeeft dat alleen gebeurtenissen die overeenkomen met het opgegeven onderwerpachtervoegsel worden opgenomen. Als dit niet is opgegeven, worden gebeurtenissen met alle onderwerpachtervoegsels opgenomen.

Type:	String
Position:	6
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-TopicName

De naam van het onderwerp waarnaar het gebeurtenisabonnement moet worden gemaakt.

Type:	String
Position:	3
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:	SwitchParameter
Aliassen:	wi
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Invoerwaarden

String

PSTopic

Parameters: InputObject (ByValue)

String[]

Uitvoerwaarden

PSEventSubscription