Share via


New-AzEventGridSubscription

Asynchroon maakt een nieuw gebeurtenisabonnement of werkt een bestaand gebeurtenisabonnement bij op basis van het opgegeven bereik.

Syntax

New-AzEventGridSubscription
   -Name <String>
   -Scope <String>
   [-DeadLetterWithResourceIdentityType <String>]
   [-DeadLetterWithResourceIdentityUserAssignedIdentity <String>]
   [-DeliveryWithResourceIdentityDestination <IEventSubscriptionDestination>]
   [-DeliveryWithResourceIdentityType <String>]
   [-DeliveryWithResourceIdentityUserAssignedIdentity <String>]
   [-Destination <IEventSubscriptionDestination>]
   [-EventDeliverySchema <String>]
   [-ExpirationTimeUtc <DateTime>]
   [-FilterAdvancedFilter <IAdvancedFilter[]>]
   [-FilterEnableAdvancedFilteringOnArray]
   [-FilterIncludedEventType <String[]>]
   [-FilterIsSubjectCaseSensitive]
   [-FilterSubjectBeginsWith <String>]
   [-FilterSubjectEndsWith <String>]
   [-Label <String[]>]
   [-RetryPolicyEventTimeToLiveInMinute <Int32>]
   [-RetryPolicyMaxDeliveryAttempt <Int32>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzEventGridSubscription
   -Name <String>
   -Scope <String>
   -JsonString <String>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzEventGridSubscription
   -Name <String>
   -Scope <String>
   -JsonFilePath <String>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzEventGridSubscription
   -InputObject <IEventGridIdentity>
   [-DeadLetterWithResourceIdentityType <String>]
   [-DeadLetterWithResourceIdentityUserAssignedIdentity <String>]
   [-DeliveryWithResourceIdentityDestination <IEventSubscriptionDestination>]
   [-DeliveryWithResourceIdentityType <String>]
   [-DeliveryWithResourceIdentityUserAssignedIdentity <String>]
   [-Destination <IEventSubscriptionDestination>]
   [-EventDeliverySchema <String>]
   [-ExpirationTimeUtc <DateTime>]
   [-FilterAdvancedFilter <IAdvancedFilter[]>]
   [-FilterEnableAdvancedFilteringOnArray]
   [-FilterIncludedEventType <String[]>]
   [-FilterIsSubjectCaseSensitive]
   [-FilterSubjectBeginsWith <String>]
   [-FilterSubjectEndsWith <String>]
   [-Label <String[]>]
   [-RetryPolicyEventTimeToLiveInMinute <Int32>]
   [-RetryPolicyMaxDeliveryAttempt <Int32>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Asynchroon maakt een nieuw gebeurtenisabonnement of werkt een bestaand gebeurtenisabonnement bij op basis van het opgegeven bereik.

Voorbeelden

Voorbeeld 1: Asynchroon maakt een nieuw gebeurtenisabonnement of werkt een bestaand gebeurtenisabonnement bij op basis van het opgegeven bereik.

$obj = New-AzEventGridWebHookEventSubscriptionDestinationObject -EndpointUrl "https://azpsweb.azurewebsites.net/api/updates"
New-AzEventGridSubscription -Name azps-eventsub -Scope "subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" -Destination $obj -FilterIsSubjectCaseSensitive:$false

Name          ResourceGroupName
----          -----------------
azps-eventsub

Asynchroon maakt een nieuw gebeurtenisabonnement of werkt een bestaand gebeurtenisabonnement bij op basis van het opgegeven bereik.

Voorbeeld 2: Asynchroon maakt een nieuw gebeurtenisabonnement of werkt een bestaand gebeurtenisabonnement bij op basis van het opgegeven bereik.

$obj = New-AzEventGridWebHookEventSubscriptionDestinationObject -EndpointUrl "https://azpsweb.azurewebsites.net/api/updates"
$topic = Get-AzEventGridTopic -ResourceGroupName azps_test_group_eventgrid -Name azps-topic
New-AzEventGridSubscription -Name azps-eventsub -Scope $topic.Id -Destination $obj -FilterIsSubjectCaseSensitive:$false -FilterSubjectBeginsWith "ExamplePrefix" -FilterSubjectEndsWith "ExampleSuffix"

Name          ResourceGroupName
----          -----------------
azps-eventsub azps_test_group_eventgrid

Asynchroon maakt een nieuw gebeurtenisabonnement of werkt een bestaand gebeurtenisabonnement bij op basis van het opgegeven bereik.

Parameters

-AsJob

De opdracht uitvoeren als een taak

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

-DeadLetterWithResourceIdentityType

Het type beheerde identiteit dat wordt gebruikt. Het type SystemAssigned, UserAssigned bevat zowel een impliciet gemaakte identiteit als een set door de gebruiker toegewezen identiteiten. Met het type None wordt een identiteit verwijderd.

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

-DeadLetterWithResourceIdentityUserAssignedIdentity

De gebruikersidentiteit die is gekoppeld aan de resource.

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

-DefaultProfile

De parameter DefaultProfile is niet functioneel. Gebruik de parameter SubscriptionId indien beschikbaar als u de cmdlet uitvoert voor een ander abonnement.

Type:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeliveryWithResourceIdentityDestination

Informatie over de bestemming waar gebeurtenissen moeten worden afgeleverd voor het gebeurtenisabonnement. Maakt gebruik van de identiteit van Azure Event Grid om de verificatietokens te verkrijgen die worden gebruikt tijdens levering/dode brieven.

Type:Microsoft.Azure.PowerShell.Cmdlets.EventGrid.Models.IEventSubscriptionDestination
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeliveryWithResourceIdentityType

Het type beheerde identiteit dat wordt gebruikt. Het type SystemAssigned, UserAssigned bevat zowel een impliciet gemaakte identiteit als een set door de gebruiker toegewezen identiteiten. Met het type None wordt een identiteit verwijderd.

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

-DeliveryWithResourceIdentityUserAssignedIdentity

De gebruikersidentiteit die is gekoppeld aan de resource.

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

-Destination

Informatie over de bestemming waar gebeurtenissen moeten worden afgeleverd voor het gebeurtenisabonnement. Maakt gebruik van de identiteit van Azure Event Grid om de verificatietokens te verkrijgen die worden gebruikt tijdens levering/dode brieven.

Type:Microsoft.Azure.PowerShell.Cmdlets.EventGrid.Models.IEventSubscriptionDestination
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EventDeliverySchema

Het gebeurtenisleveringsschema voor het gebeurtenisabonnement.

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

-ExpirationTimeUtc

Verlooptijd van het gebeurtenisabonnement.

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

-FilterAdvancedFilter

Een matrix met geavanceerde filters die worden gebruikt voor het filteren van gebeurtenisabonnementen.

Type:Microsoft.Azure.PowerShell.Cmdlets.EventGrid.Models.IAdvancedFilter[]
Aliases:AdvancedFilter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FilterEnableAdvancedFilteringOnArray

Hiermee kunnen geavanceerde filters worden geƫvalueerd op basis van een matrix met waarden in plaats van een enkelvoudige waarde te verwachten.

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

-FilterIncludedEventType

Een lijst met toepasselijke gebeurtenistypen die deel moeten uitmaken van het gebeurtenisabonnement. Als u zich wilt abonneren op alle standaardgebeurtenistypen, stelt u de IncludedEventTypes in op null.

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

-FilterIsSubjectCaseSensitive

Hiermee geeft u op of de eigenschappen SubjectBeginsWith en SubjectEndsWith van de filters op een hoofdlettergevoelige manier worden vergeleken.

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

-FilterSubjectBeginsWith

Een optionele tekenreeks voor het filteren van gebeurtenissen voor een gebeurtenisabonnement op basis van een resourcepadvoorvoegsel. De indeling hiervan is afhankelijk van de uitgever van de gebeurtenissen. Jokertekens worden niet ondersteund in dit pad.

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

-FilterSubjectEndsWith

Een optionele tekenreeks voor het filteren van gebeurtenissen voor een gebeurtenisabonnement op basis van een achtervoegsel voor een resourcepad. Jokertekens worden niet ondersteund in dit pad.

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

-InputObject

Identiteitsparameter

Type:Microsoft.Azure.PowerShell.Cmdlets.EventGrid.Models.IEventGridIdentity
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-JsonFilePath

Pad van het Json-bestand dat is opgegeven bij de bewerking Maken

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

-JsonString

Json-tekenreeks die is opgegeven bij de bewerking Maken

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

-Label

Lijst met door de gebruiker gedefinieerde labels.

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

-Name

Naam van het gebeurtenisabonnement. Namen van gebeurtenisabonnementen moeten tussen de 3 en 64 tekens lang zijn en mogen alleen alfanumerieke letters gebruiken.

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

-NoWait

De opdracht asynchroon uitvoeren

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

-PassThru

Retourneert waar wanneer de opdracht slaagt

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

-RetryPolicyEventTimeToLiveInMinute

Time To Live (in minuten) voor gebeurtenissen.

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

-RetryPolicyMaxDeliveryAttempt

Maximum aantal nieuwe pogingen voor levering voor gebeurtenissen.

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

-Scope

De id van de resource waarnaar het gebeurtenisabonnement moet worden gemaakt of bijgewerkt. Het bereik kan een abonnement of een resourcegroep of een resource op het hoogste niveau zijn die deel uitmaakt van een resourceprovidernaamruimte of een EventGrid-onderwerp. Gebruik bijvoorbeeld '/subscriptions/{subscriptionId}/' voor een abonnement, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' voor een resourcegroep en /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}' voor een resource en /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/topics/{topicName}' voor een EventGrid-onderwerp.

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

Microsoft.Azure.PowerShell.Cmdlets.EventGrid.Models.IEventGridIdentity

Uitvoerwaarden

Microsoft.Azure.PowerShell.Cmdlets.EventGrid.Models.IEventSubscription