Update-AzEventGridSubscription

Odwołanie

Moduł:: Az.EventGrid

Zaktualizuj właściwości subskrypcji zdarzeń usługi Event Grid.

Składnia

Update-AzEventGridSubscription
      [-EventSubscriptionName] <String>
      [[-ResourceGroupName] <String>]
      [-EndpointType <String>]
      [-Endpoint <String>]
      [-SubjectBeginsWith <String>]
      [-SubjectEndsWith <String>]
      [-IncludedEventType <String[]>]
      [-Label <String[]>]
      [-ExpirationDate <DateTime>]
      [-AdvancedFilter <Hashtable[]>]
      [-DeliveryAttributeMapping <Hashtable[]>]
      [-EventTtl <Int32>]
      [-MaxDeliveryAttempt <Int32>]
      [-DeadLetterEndpoint <String>]
      [-MaxEventsPerBatch <Int32>]
      [-PreferredBatchSizeInKiloByte <Int32>]
      [-AzureActiveDirectoryApplicationIdOrUri <String>]
      [-AzureActiveDirectoryTenantId <String>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzEventGridSubscription
      [-ResourceId] <String>
      [-EventSubscriptionName] <String>
      [-EndpointType <String>]
      [-Endpoint <String>]
      [-SubjectBeginsWith <String>]
      [-SubjectEndsWith <String>]
      [-IncludedEventType <String[]>]
      [-Label <String[]>]
      [-ExpirationDate <DateTime>]
      [-AdvancedFilter <Hashtable[]>]
      [-DeliveryAttributeMapping <Hashtable[]>]
      [-EventTtl <Int32>]
      [-MaxDeliveryAttempt <Int32>]
      [-DeadLetterEndpoint <String>]
      [-MaxEventsPerBatch <Int32>]
      [-PreferredBatchSizeInKiloByte <Int32>]
      [-AzureActiveDirectoryApplicationIdOrUri <String>]
      [-AzureActiveDirectoryTenantId <String>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzEventGridSubscription
      [-InputObject] <PSEventSubscription>
      [-EndpointType <String>]
      [-Endpoint <String>]
      [-SubjectBeginsWith <String>]
      [-SubjectEndsWith <String>]
      [-IncludedEventType <String[]>]
      [-Label <String[]>]
      [-ExpirationDate <DateTime>]
      [-AdvancedFilter <Hashtable[]>]
      [-DeliveryAttributeMapping <Hashtable[]>]
      [-EventTtl <Int32>]
      [-MaxDeliveryAttempt <Int32>]
      [-DeadLetterEndpoint <String>]
      [-MaxEventsPerBatch <Int32>]
      [-PreferredBatchSizeInKiloByte <Int32>]
      [-AzureActiveDirectoryApplicationIdOrUri <String>]
      [-AzureActiveDirectoryTenantId <String>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzEventGridSubscription
      [-EventSubscriptionName] <String>
      [-ResourceGroupName] <String>
      [-TopicName] <String>
      [-EndpointType <String>]
      [-Endpoint <String>]
      [-SubjectBeginsWith <String>]
      [-SubjectEndsWith <String>]
      [-IncludedEventType <String[]>]
      [-Label <String[]>]
      [-ExpirationDate <DateTime>]
      [-AdvancedFilter <Hashtable[]>]
      [-DeliveryAttributeMapping <Hashtable[]>]
      [-EventTtl <Int32>]
      [-MaxDeliveryAttempt <Int32>]
      [-DeadLetterEndpoint <String>]
      [-MaxEventsPerBatch <Int32>]
      [-PreferredBatchSizeInKiloByte <Int32>]
      [-AzureActiveDirectoryApplicationIdOrUri <String>]
      [-AzureActiveDirectoryTenantId <String>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzEventGridSubscription
      [-EventSubscriptionName] <String>
      [-ResourceGroupName] <String>
      [-DomainName] <String>
      [-EndpointType <String>]
      [-Endpoint <String>]
      [-SubjectBeginsWith <String>]
      [-SubjectEndsWith <String>]
      [-IncludedEventType <String[]>]
      [-Label <String[]>]
      [-ExpirationDate <DateTime>]
      [-AdvancedFilter <Hashtable[]>]
      [-DeliveryAttributeMapping <Hashtable[]>]
      [-EventTtl <Int32>]
      [-MaxDeliveryAttempt <Int32>]
      [-DeadLetterEndpoint <String>]
      [-MaxEventsPerBatch <Int32>]
      [-PreferredBatchSizeInKiloByte <Int32>]
      [-AzureActiveDirectoryApplicationIdOrUri <String>]
      [-AzureActiveDirectoryTenantId <String>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzEventGridSubscription
      [-EventSubscriptionName] <String>
      [-ResourceGroupName] <String>
      [-DomainName] <String>
      [-DomainTopicName] <String>
      [-EndpointType <String>]
      [-Endpoint <String>]
      [-SubjectBeginsWith <String>]
      [-SubjectEndsWith <String>]
      [-IncludedEventType <String[]>]
      [-Label <String[]>]
      [-ExpirationDate <DateTime>]
      [-AdvancedFilter <Hashtable[]>]
      [-DeliveryAttributeMapping <Hashtable[]>]
      [-EventTtl <Int32>]
      [-MaxDeliveryAttempt <Int32>]
      [-DeadLetterEndpoint <String>]
      [-MaxEventsPerBatch <Int32>]
      [-PreferredBatchSizeInKiloByte <Int32>]
      [-AzureActiveDirectoryApplicationIdOrUri <String>]
      [-AzureActiveDirectoryTenantId <String>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Opis

Zaktualizuj właściwości subskrypcji zdarzeń usługi Event Grid. Może to służyć do aktualizowania filtru, miejsca docelowego lub etykiet istniejącej subskrypcji zdarzeń.

Przykłady

Przykład 1

Update-AzEventGridSubscription -EventSubscriptionName ES1 -TopicName Topic1 -ResourceGroup MyResourceGroupName -Endpoint https://requestb.in/1kxxoui1

Aktualizacje punkt końcowy subskrypcji zdarzeń "ES1" dla tematu "Topic1" w grupie zasobów "MyResourceGroupName" do "https://requestb.in/1kxxoui1"

Przykład 2

Get-AzEventGridSubscription -EventSubscriptionName ES1 -TopicName Topic1 -ResourceGroup MyResourceGroupName | Update-AzEventGridSubscription -Endpoint https://requestb.in/1kxxoui1

Aktualizacje punkt końcowy subskrypcji zdarzeń "ES1" dla tematu "Topic1" w grupie zasobów "MyResourceGroupName" do "https://requestb.in/1kxxoui1"

Przykład 3

Update-AzEventGridSubscription -EventSubscriptionName ES1 -ResourceId "/subscriptions/55f3dcd4-cac7-43b4-990b-a139d62a1eb2/resourceGroups/TestRG/providers/Microsoft.EventHub/namespaces/ContosoNamespace" -Endpoint https://requestb.in/1kxxoui1 -SubjectEndsWith "jpg"

Aktualizacje właściwości subskrypcji zdarzeń "ES1" dla przestrzeni nazw usługi EventHub ContosoNamespace z nowym punktem końcowym jako "https://requestb.in/1kxxoui1" i nowym elementem SubjectEndsWith filtrem "jpg"

Przykład 4

$labels = "Finance", "HR"
Update-AzEventGridSubscription -EventSubscriptionName ES1 -ResourceGroup MyResourceGroupName -Label $labels

Aktualizacje właściwości subskrypcji zdarzeń "ES1" dla grupy zasobów "MyResourceGroupName" z nowymi etykietami $labels.

Parametry

-AdvancedFilter

Filtr zaawansowany określający tablicę wielu wartości tabeli skrótów, które są używane do filtrowania opartego na atrybutach. Każda wartość tabeli skrótu ma następujące informacje klucz-wartość: Operacja, Klucz i Wartość lub Wartości. Operator może być jedną z następujących wartości: NumberIn, NumberNotIn, NumberLessThan, NumberGreaterThan, NumberLessThanOrEquals, NumberGreaterThanOrEquals, BoolEquals, StringIn, StringNotIn, StringBeginsWith, StringEndsWith lub StringContains. Klucz reprezentuje właściwość ładunku, w której są stosowane zaawansowane zasady filtrowania. Na koniec wartość lub wartości reprezentują wartość lub zestaw wartości do dopasowania. Może to być pojedyncza wartość odpowiadającego typu lub tablicy wartości. Przykład zaawansowanych parametrów filtru: $AdvancedFilters=@($AdvFilter 1, $AdvFilter 2), gdzie $AdvFilter 1=@{operator="NumberIn"; key="Data.Key1"; Values=@(1,2)} i $AdvFilter 2=@{operator="StringBeginsWith"; key="Subject"; Values=@("SubjectPrefix1","SubjectPrefix2")}

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

-AzureActiveDirectoryApplicationIdOrUri

Identyfikator aplikacji entra firmy Microsoft lub identyfikator URI, aby uzyskać token dostępu, który zostanie uwzględniony jako token elementu nośnego w żądaniach dostarczenia. Dotyczy tylko elementu webhook jako miejsca docelowego.

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

-AzureActiveDirectoryTenantId

Identyfikator dzierżawy entra firmy Microsoft, aby uzyskać token dostępu, który zostanie uwzględniony jako token elementu nośnego w żądaniach dostarczenia. Dotyczy tylko elementu webhook jako miejsca docelowego.

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

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-DeadLetterEndpoint

Punkt końcowy używany do przechowywania nieuprawnionych zdarzeń. Określ identyfikator zasobu platformy Azure kontenera obiektów blob usługi Storage. Na przykład: /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:	False
Accept wildcard characters:	False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

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

-DeliveryAttributeMapping

Mapowania atrybutów dostarczania dla tej subskrypcji zdarzeń tematu systemowego. Każde mapowanie atrybutów dostarczania powinno zawierać dwa obowiązkowe pola: Nazwa i Typ. Typ może mieć wartość "Static" lub "Dynamic". Jeśli typ ma wartość "Static", wymagane są właściwości "Value" i "IsSecret". Jeśli typ ma wartość "Dynamic", właściwość "SourceField" jest wymagana. Przykład parametrów DynamicAttributeMapping: $DeliveryAttributeMapping=@($DeliveryAttributeMapping 1, $DeliveryAttributeMapping 2), gdzie $DeliveryAttributeMapping 1=@{Name="Name1"; Type="Static"; Values="value"; IsSecret="false"} i $DeliveryAttributeMapping 2=@{Name="Name2"; Type="Dynamic"; SourceField="data.prop1"}

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

-DomainName

Nazwa domeny, do której ma zostać utworzona subskrypcja zdarzeń.

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

-DomainTopicName

Nazwa tematu domeny, do którego ma zostać utworzona subskrypcja zdarzeń.

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

-Endpoint

Docelowy punkt końcowy subskrypcji zdarzeń. Może to być adres URL elementu webhook lub identyfikator zasobu platformy Azure usługi EventHub, kolejki magazynu, połączenia hybrydowego lub kolejki usługi. Na przykład identyfikator zasobu połączenia hybrydowego ma następującą formę: /subscriptions/[Identyfikator subskrypcji platformy Azure]/resourceGroups/[ResourceGroupName]/providers/Microsoft.Relay/namespaces/[NamespaceName]/hybrid Połączenie ions/[Hybrid Połączenie ionName]. Oczekuje się, że docelowy punkt końcowy zostanie utworzony i dostępny do użycia przed wykonaniem jakichkolwiek poleceń cmdlet usługi Event Grid.

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

-EndpointType

Typ punktu końcowego. Może to być element webhook, eventhub, storagequeue, hybridconnection lub servicebusqueue. Wartość domyślna to element webhook.

Type:	String
Accepted values:	webhook, eventhub, storagequeue, hybridconnection, servicebusqueue, servicebustopic, azurefunction
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EventSubscriptionName

Nazwa subskrypcji zdarzeń

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

-EventTtl

Czas dostawy zdarzeń w minutach. Ta wartość musi należeć do zakresu od 1 do 1440

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

-ExpirationDate

Określa datę wygaśnięcia dla subskrypcji zdarzeń, po której subskrypcja zdarzeń zostanie wycofana.

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

-IncludedEventType

Filtr określający listę typów zdarzeń do uwzględnienia. Jeśli nie zostanie określony, zostaną uwzględnione wszystkie typy zdarzeń.

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

-InputObject

EventGridSubscription, obiekt.

Type:	PSEventSubscription
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Label

Etykiety subskrypcji zdarzeń

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

-MaxDeliveryAttempt

Maksymalna liczba prób dostarczenia zdarzenia. Ta wartość musi należeć do zakresu od 1 do 30

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

-MaxEventsPerBatch

Maksymalna liczba zdarzeń w partii. Ta wartość musi należeć do zakresu od 1 do 5000. Ten parametr jest prawidłowy, gdy typ endpint jest tylko elementem webhook.

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

-PreferredBatchSizeInKiloByte

Preferowany rozmiar partii w kilobajtach. Ta wartość musi należeć do zakresu od 1 do 1024. Ten parametr jest prawidłowy, gdy typ endpint jest tylko elementem webhook.

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

-ResourceGroupName

Grupa zasobów tematu.

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

-ResourceId

Identyfikator zasobu, do którego utworzono subskrypcję zdarzeń.

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

-SubjectBeginsWith

Filtr określający, że zostaną uwzględnione tylko zdarzenia pasujące do określonego prefiksu podmiotu. Jeśli nie zostanie określony, zostaną uwzględnione zdarzenia ze wszystkimi prefiksami podmiotów.

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

-SubjectEndsWith

Filtr określający, że zostaną uwzględnione tylko zdarzenia pasujące do określonego sufiksu podmiotu. Jeśli nie zostanie określony, zostaną uwzględnione zdarzenia ze wszystkimi sufiksami podmiotów.

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

-TopicName

Nazwa tematu, do którego ma zostać utworzona subskrypcja zdarzeń.

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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

Dane wejściowe

String

PSEventSubscription

Dane wyjściowe