New-AzEventGridSystemTopicEventSubscription

Odwołanie

Moduł:: Az.EventGrid

Tworzy nową subskrypcję zdarzeń usługi Azure Event Grid w temacie systemowym.

Składnia

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>]

Opis

Utwórz nową subskrypcję zdarzeń w temacie Azure Event Grid System.

Przykłady

Przykład 1

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

Tworzy nową subskrypcję zdarzeń "EventSubscription1" do tematu systemu usługi Azure Event Grid "Topic1" w grupie zasobów "MyResourceGroupName" z docelowym punktem końcowym https://requestb.in/19qlscd1elementu webhook. Ta subskrypcja zdarzeń używa filtrów domyślnych.

Przykład 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

Tworzy nową subskrypcję zdarzeń "EventSubscription1" do tematu Sytem "Topic1" w grupie zasobów "MyResourceGroup" z docelowym punktem końcowym https://requestb.in/19qlscd1elementu webhook . Ta subskrypcja zdarzeń określa dodatkowe filtry dla typów zdarzeń i tematu, a tylko zdarzenia pasujące do tych filtrów zostaną dostarczone do docelowego punktu końcowego.

Przykład 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"

Tworzy nową subskrypcję zdarzeń "EventSubscription1" do tematu Sytem "Topic1" w grupie zasobów "MyResourceGroup" z określonym centrum zdarzeń jako miejscem docelowym zdarzeń. Ta subskrypcja zdarzeń używa filtrów domyślnych.

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="StringBringsWith"; key="Subject"; Values=@("SubjectPrefix1","SubjectPrefix2")}

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

-AdvancedFilteringOnArray

Obecność tego parametru oznacza, że włączono zaawansowane filtrowanie tablic

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

-DeliverySchema

Schemat, który ma być używany podczas dostarczania zdarzeń do miejsca docelowego. Możliwe wartości to: eventgridschema, CustomInputSchema lub cloudeventv01schema. Wartość domyślna to CustomInputSchema.

Type:	String
Position:	Named
Default value:	None
Required:	False
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, kolejka magazynu, połączenie hybrydowe, servicebusqueue, servicebustopic lub azurefunction. 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:	True
Accept wildcard characters:	False

-EndpointType

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

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

-EventSubscriptionName

Nazwa subskrypcji zdarzeń EventGrid.

Type:	String
Position:	Named
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:	True
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:	True
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ń (w przypadku tematów niestandardowych i domen) lub domyślne typy zdarzeń (dla innych typów tematów).

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

-Label

Etykiety subskrypcji zdarzeń.

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

-ResourceGroupName

Nazwa grupy zasobów.

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

-StorageQueueMessageTtl

Czas w milisekundach czasu wygaśnięcia komunikatu kolejki magazynu

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

-SubjectCaseSensitive

Filtr określający, że pole tematu powinno być porównywane w sposób uwzględniający wielkość liter. Jeśli nie zostanie określony, temat zostanie porównany w sposób niewrażliwy na wielkość liter.

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

-SystemTopicName

Nazwa tematu usługi EventGrid.

Type:	String
Position:	Named
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

String[]

Int32

DateTime

Int64

Hashtable[]

SwitchParameter

Dane wyjściowe

PSEventSubscription

Share via