New-AzureRmEventGridSubscription
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/19qlscd1
van 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/19qlscd1
van 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/19qlscd1
van 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/19qlscd1
van 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
Parameters: InputObject (ByValue)
String[]