New-AzureRmEventGridSubscription

Moduł:

AzureRM.EventGrid

Tworzy nową subskrypcję zdarzeń usługi Azure Event Grid w temacie, zasobie platformy Azure, subskrypcji platformy Azure lub grupie zasobów.

Ostrzeżenie

Moduł AzureRM PowerShell jest oficjalnie przestarzały od 29 lutego 2024 r. Zaleca się migrowanie użytkowników z modułu AzureRM do modułu Az programu PowerShell w celu zapewnienia ciągłej obsługi i aktualizacji.

Mimo że moduł AzureRM może nadal działać, nie jest już utrzymywany ani obsługiwany, umieszczając wszelkie dalsze zastosowania według uznania i ryzyka użytkownika. Zapoznaj się z naszymi zasobami migracji, aby uzyskać wskazówki dotyczące przejścia do modułu Az.

Składnia

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

Opis

Utwórz nową subskrypcję zdarzeń w temacie usługi Azure Event Grid, obsługiwanym zasobie platformy Azure, subskrypcji platformy Azure lub grupie zasobów. Aby utworzyć subskrypcję zdarzeń do aktualnie wybranej subskrypcji platformy Azure, określ nazwę subskrypcji zdarzeń i docelowy punkt końcowy. Aby utworzyć subskrypcję zdarzeń do grupy zasobów, określ nazwę grupy zasobów oprócz nazwy subskrypcji zdarzeń i docelowego punktu końcowego. Aby utworzyć subskrypcję zdarzeń w temacie usługi Azure Event Grid, określ również nazwę tematu. Aby utworzyć subskrypcję zdarzeń do obsługiwanego zasobu platformy Azure, określ pełny identyfikator zasobu. Aby wyświetlić listę obsługiwanych typów, uruchom polecenie cmdlet Get-AzureRmEventGridTopicType.

Przykłady

Przykład 1

PS C:\> New-AzureRmEventGridSubscription -ResourceGroup MyResourceGroup -TopicName Topic1 -Endpoint https://requestb.in/19qlscd1 -EventSubscriptionName EventSubscription1

Tworzy nową subskrypcję zdarzeń "EventSubscription1" do tematu 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

PS C:\> New-AzureRmEventGridSubscription -ResourceGroup MyResourceGroupName -Endpoint https://requestb.in/19qlscd1 -EventSubscriptionName EventSubscription1

Tworzy nową subskrypcję zdarzeń "EventSubscription1" do grupy zasobów "MyResourceGroupName" z docelowym punktem końcowym https://requestb.in/19qlscd1elementu webhook . Ta subskrypcja zdarzeń używa filtrów domyślnych.

Przykład 3

PS C:\> New-AzureRmEventGridSubscription -Endpoint https://requestb.in/19qlscd1 -EventSubscriptionName EventSubscription1

Tworzy nową subskrypcję zdarzeń "EventSubscription1" do aktualnie wybranej subskrypcji platformy Azure z docelowym punktem końcowym https://requestb.in/19qlscd1elementu webhook. Ta subskrypcja zdarzeń używa filtrów domyślnych.

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

Tworzy nową subskrypcję zdarzeń "EventSubscription1" do aktualnie wybranej subskrypcji platformy Azure 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 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"

Tworzy nową subskrypcję zdarzeń "EventSubscription1" do aktualnie wybranej subskrypcji platformy Azure z określonym centrum zdarzeń jako miejscem docelowym zdarzeń. Ta subskrypcja zdarzeń używa filtrów domyślnych.

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

Tworzy nową subskrypcję zdarzeń "EventSubscription1" do przestrzeni nazw usługi EventHub z określonym punktem końcowym https://requestb.in/19qlscd1docelowym elementu webhhok. Ta subskrypcja zdarzeń używa filtrów domyślnych.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:	SwitchParameter
Aliasy:	cf
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-DefaultProfile

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

Typ:	IAzureContextContainer
Aliasy:	AzureRmContext, AzureCredential
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Endpoint

Docelowy punkt końcowy subskrypcji zdarzeń. Może to być adres URL elementu webhook lub identyfikator zasobu platformy Azure w usłudze EventHub.

Typ:	String
Position:	1
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-EndpointType

Typ punktu końcowego. Może to być element webhook lub eventhub

Typ:	String
Dopuszczalne wartości:	webhook, eventhub, webhook, eventhub
Position:	4
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-EventSubscriptionName

Nazwa subskrypcji zdarzeń

Typ:	String
Position:	0
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	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ń.

Typ:	String[]
Position:	7
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-InputObject

EventGrid, obiekt tematu.

Typ:	PSTopic
Position:	0
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-Label

Etykiety subskrypcji zdarzeń

Typ:	String[]
Position:	8
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-ResourceGroupName

Grupa zasobów tematu.

Typ:	String
Aliasy:	ResourceGroup
Position:	2
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-ResourceId

Identyfikator zasobu, do którego ma zostać utworzona subskrypcja zdarzeń.

Typ:	String
Position:	0
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	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.

Typ:	String
Position:	5
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	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.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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.

Typ:	String
Position:	6
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-TopicName

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

Typ:	String
Position:	3
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-WhatIf

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

Typ:	SwitchParameter
Aliasy:	wi
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

Dane wejściowe

String

PSTopic

Parametry: InputObject (ByValue)

String[]

Dane wyjściowe

PSEventSubscription