Share via


Update-AzEventGridSubscription

Event Grid olay aboneliğinin özellikleri güncelleştirildi.

Syntax

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

Description

Event Grid olay aboneliğinin özellikleri güncelleştirildi. Bu, mevcut olay aboneliğinin filtresini, hedefini veya etiketlerini güncelleştirmek için kullanılabilir.

Örnekler

Örnek 1

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

'MyResourceGroupName' kaynak grubundaki 'Topic1' konusu için 'ES1' olay aboneliğinin uç noktasını 'https://requestb.in/1kxxoui1' olarak Güncelleştirmeler

Örnek 2

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

'MyResourceGroupName' kaynak grubundaki 'Topic1' konusu için 'ES1' olay aboneliğinin uç noktasını 'https://requestb.in/1kxxoui1' olarak Güncelleştirmeler

Örnek 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"

ContosoNamespace EventHub ad alanı için 'ES1' olay aboneliğinin özelliklerini yeni uç nokta 'https://requestb.in/1kxxoui1' olarak ve yeni SubjectEndsWith filtresi 'jpg' olarak Güncelleştirmeler

Örnek 4

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

'MyResourceGroupName' kaynak grubu için 'ES1' olay aboneliğinin özelliklerini yeni etiketlerle $labels Güncelleştirmeler.

Parametreler

-AdvancedFilter

Öznitelik tabanlı filtreleme için kullanılan birden çok Hashtable değeri dizisini belirten gelişmiş filtre. Her Karma Tablo değeri aşağıdaki anahtar-değer bilgilerine sahiptir: İşlem, Anahtar ve Değer veya Değerler. İşleç şu değerlerden biri olabilir: NumberIn, NumberNotIn, NumberLessThan, NumberGreaterThan, NumberLessThanOrEquals, NumberGreaterThanOrEquals, BoolEquals, StringIn, StringNotIn, StringBeginsWith, StringEndsWith veya StringContains. Anahtar, gelişmiş filtreleme ilkelerinin uygulandığı payload özelliğini temsil eder. Son olarak, Değer veya Değerler eşleştirilecek değeri veya değer kümesini temsil eder. Bu, karşılık gelen türün tek bir değeri veya bir değer dizisi olabilir. Gelişmiş filtre parametrelerine örnek olarak: $AdvancedFilters=@($AdvFilter 1, $AdvFilter 2) burada $AdvFilter 1=@{operator="NumberIn"; key="Data.Key1"; Values=@(1,2)} ve $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

Teslim isteklerine taşıyıcı belirteç olarak eklenecek erişim belirtecini almak için Microsoft Entra Uygulama Kimliği veya Uri'si. Yalnızca hedef olarak web kancası için geçerlidir.

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

-AzureActiveDirectoryTenantId

Teslim isteklerine taşıyıcı belirteç olarak eklenecek erişim belirtecini almak için Microsoft Entra kiracı kimliği. Yalnızca hedef olarak web kancası için geçerlidir.

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

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

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

-DeadLetterEndpoint

Teslim edilmemiş olayları depolamak için kullanılan uç nokta. Depolama blob kapsayıcısının Azure kaynak kimliğini belirtin. Örneğin: /subscriptions/[SubscriptionId]/resourceGroups/[ResourceGroupName]/providers/Microsoft. Depolama/storageAccounts/[Depolama AccountName]/blobServices/default/containers/[ContainerName].

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

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.

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

-DeliveryAttributeMapping

Bu sistem konusu olay aboneliği için teslim özniteliği eşlemeleri. Her teslim özniteliği eşlemesi aşağıdaki iki zorunlu alanı içermelidir: Ad ve Tür. Tür 'Static' veya 'Dynamic' olabilir. Tür 'Static' ise 'Value' ve 'IsSecret' özellikleri gereklidir. Tür 'Dynamic' ise ,'SourceField' özelliği gereklidir. DynamicAttributeMapping parametreleri örneği: $DeliveryAttributeMapping=@($DeliveryAttributeMapping 1, $DeliveryAttributeMapping 2) burada $DeliveryAttributeMapping 1=@{Name="Name1"; Type="Static"; Values="value"; IsSecret="false"} ve $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

Olay aboneliğinin oluşturulması gereken etki alanının adı.

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

-DomainTopicName

Olay aboneliğinin oluşturulması gereken etki alanı konusunun adı.

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

-Endpoint

Olay aboneliği hedef uç noktası. Bu bir web kancası URL'si veya EventHub, depolama kuyruğu, karma bağlantı veya servicebusqueue'nin Azure kaynak kimliği olabilir. Örneğin, karma bağlantının kaynak kimliği şu biçimdedir: /subscriptions/[Azure Abonelik Kimliği]/resourceGroups/[ResourceGroupName]/providers/Microsoft.Relay/namespaces/[NamespaceName]/hybrid Bağlan ions/[Hybrid Bağlan ionName]. Herhangi bir Event Grid cmdlet'ini yürütmeden önce hedef uç noktanın oluşturulması ve kullanılabilir olması beklenir.

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

-EndpointType

Uç Nokta Türü. Bu web kancası, eventhub, storagequeue, hybridconnection veya servicebusqueue olabilir. Varsayılan değer web kancasıdır.

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

Olay aboneliğinin adı

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

-EventTtl

Olay teslimi için dakika cinsinden süre. Bu değer 1 ile 1440 arasında olmalıdır

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

-ExpirationDate

Olay aboneliğinin sona erme Tarihi Saat değerini, etkinlik aboneliğinin kullanımdan kaldırmasının ardından belirler.

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

-IncludedEventType

Eklenecek olay türlerinin listesini belirten filtre. Belirtilmezse, tüm olay türleri eklenir.

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

-InputObject

EventGridSubscription nesnesi.

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

-Label

Olay aboneliği etiketleri

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

-MaxDeliveryAttempt

Olayı teslim etme girişimi sayısı üst sınırı. Bu değer 1 ile 30 arasında olmalıdır

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

-MaxEventsPerBatch

Toplu iş içindeki en fazla olay sayısı. Bu değer 1 ile 5000 arasında olmalıdır. Endpint Türü yalnızca web kancası olduğunda bu parametre geçerlidir.

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

-PreferredBatchSizeInKiloByte

Kilobayt cinsinden tercih edilen toplu iş boyutu. Bu değer 1 ile 1024 arasında olmalıdır. Endpint Türü yalnızca web kancası olduğunda bu parametre geçerlidir.

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

-ResourceGroupName

Konunun kaynak grubu.

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

-ResourceId

Olay aboneliğinin oluşturulduğu kaynağın tanımlayıcısı.

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

-SubjectBeginsWith

Yalnızca belirtilen konu ön eki ile eşleşen olayların dahil olacağını belirten filtre. Belirtilmezse, tüm konu ön eklerine sahip olaylar eklenir.

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

-SubjectEndsWith

Yalnızca belirtilen konu soneki ile eşleşen olayların dahil olacağını belirten filtre. Belirtilmezse, tüm konu soneklerini içeren olaylar eklenir.

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

-TopicName

Olay aboneliğinin oluşturulması gereken konunun adı.

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

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

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

Girişler

String

PSEventSubscription

Çıkışlar

PSEventSubscription