New-AzureRmEventGridSubscription
Membuat Langganan Peristiwa Azure Event Grid baru ke topik, sumber daya Azure, langganan Azure, atau Grup Sumber Daya.
Peringatan
Modul AzureRM PowerShell telah resmi tidak digunakan lagi per 29 Februari 2024. Pengguna disarankan untuk bermigrasi dari AzureRM ke modul Az PowerShell untuk memastikan dukungan dan pembaruan yang berkelanjutan.
Meskipun modul AzureRM mungkin masih berfungsi, modul tersebut tidak lagi dipertahankan atau didukung, menempatkan penggunaan berkelanjutan berdasarkan kebijaksanaan dan risiko pengguna. Silakan merujuk ke sumber daya migrasi kami untuk panduan tentang transisi ke modul Az.
Sintaks
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>] Deskripsi
Buat langganan peristiwa baru ke topik Azure Event Grid, sumber daya Azure yang didukung, langganan Azure, atau Grup Sumber Daya. Untuk membuat langganan peristiwa ke langganan Azure yang saat ini dipilih, tentukan nama langganan peristiwa dan titik akhir tujuan. Untuk membuat langganan peristiwa ke grup sumber daya, tentukan nama grup sumber daya selain nama langganan peristiwa dan titik akhir tujuan. Untuk membuat langganan peristiwa ke topik Azure Event Grid, tentukan nama topik juga. Untuk membuat langganan peristiwa ke sumber daya Azure yang didukung, tentukan ID sumber daya lengkap sumber daya. Untuk melihat daftar jenis yang didukung, jalankan cmdlet Get-AzureRmEventGridTopicType.
Contoh
Contoh 1
PS C:\> New-AzureRmEventGridSubscription -ResourceGroup MyResourceGroup -TopicName Topic1 -Endpoint https://requestb.in/19qlscd1 -EventSubscriptionName EventSubscription1Membuat langganan peristiwa baru 'EventSubscription1' ke topik Azure Event Grid 'Topic1' di grup sumber daya 'MyResourceGroupName' dengan titik https://requestb.in/19qlscd1akhir tujuan webhook . Langganan kejadian ini menggunakan filter default.
Contoh 2
PS C:\> New-AzureRmEventGridSubscription -ResourceGroup MyResourceGroupName -Endpoint https://requestb.in/19qlscd1 -EventSubscriptionName EventSubscription1Membuat langganan peristiwa baru 'EventSubscription1' ke grup sumber daya 'MyResourceGroupName' dengan titik https://requestb.in/19qlscd1akhir tujuan webhook . Langganan kejadian ini menggunakan filter default.
Contoh 3
PS C:\> New-AzureRmEventGridSubscription -Endpoint https://requestb.in/19qlscd1 -EventSubscriptionName EventSubscription1Membuat langganan peristiwa baru 'EventSubscription1' ke langganan Azure yang saat ini dipilih dengan titik https://requestb.in/19qlscd1akhir tujuan webhook . Langganan kejadian ini menggunakan filter default.
Contoh 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 $labelsMembuat langganan peristiwa baru 'EventSubscription1' ke langganan Azure yang saat ini dipilih dengan titik https://requestb.in/19qlscd1akhir tujuan webhook . Langganan kejadian ini menentukan filter tambahan untuk jenis peristiwa dan subjek, dan hanya peristiwa yang cocok dengan filter tersebut yang akan dikirimkan ke titik akhir tujuan.
Contoh 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"Membuat langganan peristiwa baru 'EventSubscription1' ke langganan Azure yang saat ini dipilih dengan hub peristiwa yang ditentukan sebagai tujuan peristiwa. Langganan kejadian ini menggunakan filter default.
Contoh 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 EventSubscription1Membuat langganan peristiwa baru 'EventSubscription1' ke namespace Layanan EventHub dengan titik https://requestb.in/19qlscd1akhir tujuan webhhok yang ditentukan . Langganan kejadian ini menggunakan filter default.
Parameter
-Confirm
Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan azure
| Type: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Endpoint
Titik akhir tujuan langganan peristiwa. Ini bisa menjadi URL webhook atau ID sumber daya Azure dari EventHub.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-EndpointType
Jenis Titik Akhir. Ini bisa berupa webhook atau eventhub
| Type: | String |
| Accepted values: | webhook, eventhub, webhook, eventhub |
| Position: | 4 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-EventSubscriptionName
Nama langganan kejadian
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-IncludedEventType
Filter yang menentukan daftar jenis peristiwa yang akan disertakan. Jika tidak ditentukan, semua jenis peristiwa akan disertakan.
| Type: | String[] |
| Position: | 7 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-InputObject
Objek Topik EventGrid.
| Type: | PSTopic |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Label
Label untuk langganan peristiwa
| Type: | String[] |
| Position: | 8 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ResourceGroupName
Grup sumber daya topik.
| Type: | String |
| Aliases: | ResourceGroup |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ResourceId
Pengidentifikasi sumber daya tempat langganan peristiwa harus dibuat.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SubjectBeginsWith
Filter yang menentukan bahwa hanya peristiwa yang cocok dengan awalan subjek yang ditentukan yang akan disertakan. Jika tidak ditentukan, peristiwa dengan semua awalan subjek akan disertakan.
| Type: | String |
| Position: | 5 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SubjectCaseSensitive
Filter yang menentukan bahwa bidang subjek harus dibandingkan dengan cara peka huruf besar/kecil. Jika tidak ditentukan, subjek akan dibandingkan dengan cara yang tidak peka huruf besar/kecil.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SubjectEndsWith
Filter yang menentukan bahwa hanya peristiwa yang cocok dengan akhiran subjek yang ditentukan yang akan disertakan. Jika tidak ditentukan, peristiwa dengan semua akhiran subjek akan disertakan.
| Type: | String |
| Position: | 6 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TopicName
Nama topik tempat langganan peristiwa harus dibuat.
| Type: | String |
| Position: | 3 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Input
Parameter: InputObject (ByValue)
String[]