New-AzEventGridSystemTopicEventSubscription

  • Referentie
Module:
Az.EventGrid

Hiermee maakt u een nieuw Azure Event Grid-gebeurtenisabonnement op een systeemonderwerp.

Syntax

New-AzEventGridSystemTopicEventSubscription
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzEventGridSystemTopicEventSubscription
   -EventSubscriptionName <String>
   -ResourceGroupName <String>
   -SystemTopicName <String>
   [-AzureActiveDirectoryApplicationIdOrUri <String>]
   [-AzureActiveDirectoryTenantId <String>]
   [-DeadLetterEndpoint <String>]
   [-DeliveryAttributeMapping <Hashtable[]>]
   [-Endpoint <String>]
   [-EndpointType <String>]
   [-DeliverySchema <String>]
   [-EventTtl <Int32>]
   [-ExpirationDate <DateTime>]
   [-Label <String[]>]
   [-MaxDeliveryAttempt <Int32>]
   [-MaxEventsPerBatch <Int32>]
   [-PreferredBatchSizeInKiloByte <Int32>]
   [-StorageQueueMessageTtl <Int64>]
   [-AdvancedFilter <Hashtable[]>]
   [-AdvancedFilteringOnArray]
   [-IncludedEventType <String[]>]
   [-SubjectBeginsWith <String>]
   [-SubjectEndsWith <String>]
   [-SubjectCaseSensitive]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Maak een nieuw gebeurtenisabonnement op een Azure Event Grid System-onderwerp.

Voorbeelden

Voorbeeld 1

New-AzEventGridSystemTopicEventSubscription -ResourceGroupName MyResourceGroup -SystemTopicName Topic1 -Endpoint https://requestb.in/19qlscd1 -EventSubscriptionName EventSubscription1

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

Voorbeeld 2

$includedEventTypes = "Microsoft.Resources.ResourceWriteFailure", "Microsoft.Resources.ResourceWriteSuccess"
$labels = "Finance", "HR"
New-AzEventGridSystemTopicEventSubscription -ResourceGroupName MyResourceGroup -SystemTopicName Topic1 -EventSubscriptionName EventSubscription1 -Endpoint https://requestb.in/19qlscd1  -SubjectBeginsWith "TestPrefix" -SubjectEndsWith "TestSuffix" -IncludedEventType $includedEventTypes -Label $labels

Hiermee maakt u een nieuw gebeurtenisabonnement 'EventSubscription1' naar Sytem-onderwerp 'Onderwerp1' in de resourcegroep 'MyResourceGroup' 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 3

New-AzEventGridSystemTopicEventSubscription -ResourceGroupName MyResourceGroup -SystemTopicName Topic1 -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 Sytem-onderwerp 'Onderwerp1' in resourcegroep 'MyResourceGroup' met de opgegeven Event Hub als bestemming voor gebeurtenissen. Dit gebeurtenisabonnement maakt gebruik van standaardfilters.

Parameters

-AdvancedFilter

Geavanceerd filter waarmee een matrix met meerdere Hashtable-waarden wordt opgegeven die worden gebruikt voor het filteren op basis van kenmerken. Elke hashtabelwaarde heeft de volgende sleutelwaardegegevens: Bewerking, Sleutel en Waarde of Waarden. Operator kan een van de volgende waarden zijn: NumberIn, NumberNotIn, NumberLessThan, NumberGreaterThan, NumberLessThanOrEquals, NumberGreaterThanOrEquals, BoolEquals, StringIn, StringNotIn, StringBeginsWith, StringEndsWith of StringContains. De sleutel vertegenwoordigt de eigenschap nettolading waarin het geavanceerde filterbeleid wordt toegepast. Ten slotte vertegenwoordigen waarde of waarden de waarde of set waarden die moeten worden vergeleken. Dit kan één waarde zijn van het bijbehorende type of een matrix met waarden. Voorbeeld van de geavanceerde filterparameters: $AdvancedFilters=@($AdvFilter 1, $AdvFilter 2) waarbij $AdvFilter 1=@{operator="NumberIn"; key="Data.Key1"; Values=@(1;2)} en $AdvFilter 2=@{operator="StringBringsWith"; key="Subject"; Values=@("SubjectPrefix1","SubjectPrefix2")}

Type:Hashtable[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-AdvancedFilteringOnArray

De aanwezigheid van deze parameter geeft aan dat geavanceerd filteren op matrices is ingeschakeld

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-AzureActiveDirectoryApplicationIdOrUri

De Microsoft Entra-toepassings-id of -URI om het toegangstoken op te halen dat wordt opgenomen als het bearer-token in bezorgingsaanvragen. Alleen van toepassing op webhook als bestemming.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-AzureActiveDirectoryTenantId

De Tenant-id van Microsoft Entra om het toegangstoken op te halen dat wordt opgenomen als bearer-token in bezorgingsaanvragen. Alleen van toepassing op webhook als bestemming.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeadLetterEndpoint

Het eindpunt dat wordt gebruikt voor het opslaan van niet-bezorgde gebeurtenissen. Geef de Azure-resource-id van een Storage-blobcontainer op. Bijvoorbeeld: /subscriptions/[SubscriptionId]/resourceGroups/[ResourceGroupName]/providers/Microsoft.Storage/storageAccounts/[StorageAccountName]/blobServices/default/containers/[ContainerName].

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeliveryAttributeMapping

De toewijzingen van leveringskenmerken voor dit gebeurtenisabonnement voor systeemonderwerp. Elke toewijzing van het leveringskenmerk moet de volgende twee verplichte velden bevatten: Naam en Type. Het type kan statisch of dynamisch zijn. Als het type Statisch is, zijn de eigenschappen 'Waarde' en 'IsSecret' vereist. Als het type Dynamisch is, is de eigenschap SourceField vereist. Een voorbeeld van de parameters DynamicAttributeMapping: $DeliveryAttributeMapping=@($DeliveryAttributeMapping 1, $DeliveryAttributeMapping 2) waarbij $DeliveryAttributeMapping 1=@{Name="Name1"; Type="Statisch"; Values="value"; IsSecret="false"} en $DeliveryAttributeMapping 2=@{Name="Name2"; Type="Dynamisch"; SourceField="data.prop1"}

Type:Hashtable[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DeliverySchema

Het schema dat moet worden gebruikt bij het leveren van gebeurtenissen aan de bestemming. De mogelijke waarden zijn: eventgridschema, CustomInputSchema of cloudeventv01schema. De standaardwaarde is CustomInputSchema.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Endpoint

Doeleindpunt van gebeurtenisabonnement. Dit kan een webhook-URL zijn of de Azure-resource-id van een EventHub, opslagwachtrij, hybridconnection, servicebusqueue, servicebustopic of azurefunction. De resource-id voor een hybride verbinding heeft bijvoorbeeld de volgende vorm: /subscriptions/[Azure Subscription ID]/resourceGroups/[ResourceGroupName]/providers/Microsoft.Relay/namespaces/[NamespaceName]/hybrid Verbinding maken ions/[Hybrid Verbinding maken ionName]. Er wordt verwacht dat het doeleindpunt moet worden gemaakt en beschikbaar is voor gebruik voordat u Event Grid-cmdlets uitvoert.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-EndpointType

Eindpunttype. Dit kan webhook, eventhub, storagequeue, hybridconnection, servicebusqueue, servicebustopic of azurefunction zijn. De standaardwaarde is een webhook.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-EventSubscriptionName

EventGrid-gebeurtenisabonnementnaam.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-EventTtl

De tijd in minuten voor de levering van de gebeurtenis. Deze waarde moet tussen 1 en 1440 zijn

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ExpirationDate

Hiermee bepaalt u de vervaldatum DateTime voor het gebeurtenisabonnement waarna het gebeurtenisabonnement buiten gebruik wordt gesteld.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-IncludedEventType

Filter waarmee een lijst met gebeurtenistypen wordt opgegeven die moeten worden opgenomen. Als dit niet is opgegeven, worden alle gebeurtenistypen (voor de aangepaste onderwerpen en domeinen) of standaardgebeurtenistypen (voor andere onderwerptypen) opgenomen.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Label

Labels voor het gebeurtenisabonnement.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-MaxDeliveryAttempt

Het maximum aantal pogingen om de gebeurtenis te leveren. Deze waarde moet tussen 1 en 30 zijn.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-MaxEventsPerBatch

Het maximum aantal gebeurtenissen in een batch. Deze waarde moet tussen 1 en 5000 zijn. Deze parameter is geldig wanneer Endpint Type alleen webhook is.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PreferredBatchSizeInKiloByte

De gewenste batchgrootte in kilobytes. Deze waarde moet tussen 1 en 1024 zijn. Deze parameter is geldig wanneer Endpint Type alleen webhook is.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

De naam van de resourcegroep.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-StorageQueueMessageTtl

De tijd in milliseconden voor time to live van een opslagwachtrijbericht

Type:Int64
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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
Required:False
Accept pipeline input:True
Accept wildcard characters: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:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SystemTopicName

EventGrid-onderwerpnaam.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

String

String[]

Int32

DateTime

Int64

Hashtable[]

SwitchParameter

Uitvoerwaarden

PSEventSubscription