Update-AzEventGridSubscription
Обновлены свойства подписки на события Сетки событий.
Синтаксис
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>]
Описание
Обновлены свойства подписки на события Сетки событий. Это можно использовать для обновления фильтра, назначения или меток существующей подписки на события.
Примеры
Пример 1
Update-AzEventGridSubscription -EventSubscriptionName ES1 -TopicName Topic1 -ResourceGroup MyResourceGroupName -Endpoint https://requestb.in/1kxxoui1
Обновления конечную точку подписки на событие "ES1" раздела "Topic1" в группе ресурсов MyResourceGroupName" в "https://requestb.in/1kxxoui1"
Пример 2
Get-AzEventGridSubscription -EventSubscriptionName ES1 -TopicName Topic1 -ResourceGroup MyResourceGroupName | Update-AzEventGridSubscription -Endpoint https://requestb.in/1kxxoui1
Обновления конечную точку подписки на событие "ES1" раздела "Topic1" в группе ресурсов MyResourceGroupName" в "https://requestb.in/1kxxoui1"
Пример 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"
Обновления свойства подписки на события "ES1" для пространства имен EventHub ContosoNamespace с новой конечной точкой как "https://requestb.in/1kxxoui1" и новым фильтром SubjectEndsWith как jpg
Пример 4
$labels = "Finance", "HR"
Update-AzEventGridSubscription -EventSubscriptionName ES1 -ResourceGroup MyResourceGroupName -Label $labels
Обновления свойства подписки на событие "ES1" для группы ресурсов MyResourceGroupName с новыми метками $labels.
Параметры
-AdvancedFilter
Расширенный фильтр, указывающий массив нескольких хэш-значений, используемых для фильтрации на основе атрибутов. Каждое хэш-значение имеет следующие сведения о ключах: операции, ключ и значение или значения. Оператор может быть одним из следующих значений: NumberIn, NumberNotIn, NumberLessThan, NumberGreaterThan, NumberLessThanOrEquals, NumberGreaterThanOrEquals, BoolEquals, StringIn, StringNotIn, StringBeginsWith, StringEndsWith или StringContains. Ключ представляет свойство полезных данных, в котором применяются расширенные политики фильтрации. Наконец, значение или значения представляют значение или набор соответствующих значений. Это может быть одно значение соответствующего типа или массив значений. Пример расширенных параметров фильтра: $AdvancedFilters=@($AdvFilter 1, $AdvFilter 2), где $AdvFilter 1=@{operator="NumberIn"; key="Data.Key1"; Values=@(1,2)} и $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
Идентификатор приложения Microsoft Entra или URI для получения маркера доступа, который будет включен в качестве маркера носителя в запросах на доставку. Применимо только для веб-перехватчика в качестве назначения.
Type: | String |
Aliases: | AliasAadAppIdUri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AzureActiveDirectoryTenantId
Идентификатор клиента Microsoft Entra для получения маркера доступа, который будет включен в качестве маркера носителя в запросах на доставку. Применимо только для веб-перехватчика в качестве назначения.
Type: | String |
Aliases: | AliasAadTenantId |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Запрос подтверждения перед выполнением командлета.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadLetterEndpoint
Конечная точка, используемая для хранения незавершенных событий. Укажите идентификатор ресурса Azure для контейнера больших двоичных объектов служба хранилища. Например: /subscriptions/[SubscriptionId]/resourceGroups/[ResourceGroupName]/providers/Microsoft. служба хранилища/storageAccounts/[служба хранилища AccountName]/blobServices/default/container/[ContainerName].
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeliveryAttributeMapping
Сопоставления атрибутов доставки для этой подписки на события раздела системы. Каждое сопоставление атрибутов доставки должно содержать следующие два обязательных поля: имя и тип. Тип может быть статическим или динамическим. Если тип имеет значение Static, то требуются свойства Value и IsSecret. Если тип имеет значение Dynamic, то требуется свойство SourceField. Пример параметров DynamicAttributeMapping: $DeliveryAttributeMapping=@($DeliveryAttributeMapping 1, $DeliveryAttributeMapping 2), где $DeliveryAttributeMapping 1=@{Name="Name1"; Type="Static"; Values="value"; IsSecret="false"} и $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
Имя домена, для которого должна быть создана подписка на событие.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DomainTopicName
Имя раздела домена, в котором должна быть создана подписка на события.
Type: | String |
Position: | 3 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Endpoint
Конечная точка назначения подписки на события. Это может быть URL-адрес веб-перехватчика или идентификатор ресурса Azure для EventHub, очереди хранилища, гибридного подключения или servicebusqueue. Например, идентификатор ресурса для гибридного подключения имеет следующую форму: /subscriptions/[идентификатор подписки Azure]/resourceGroups/[ResourceGroupName]/providers/Microsoft.Relay/namespaces/[NamespaceName]/hybrid Подключение ions/[Hybrid Подключение ionName]. Ожидается, что целевая конечная точка будет создана и доступна для использования перед выполнением командлетов Сетки событий.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EndpointType
Тип конечной точки. Это может быть веб-перехватчик, eventhub, storagequeue, hybridconnection или servicebusqueue. Значением по умолчанию является веб-перехватчик.
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
Имя для этой подписки на события
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-EventTtl
Время в минутах доставки события. Это значение должно быть от 1 до 1440
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExpirationDate
Определяет срок действия даты и времени окончания срока действия подписки на события, после которой подписка на события будет прекращена.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncludedEventType
Фильтр, указывающий список типов событий для включения. Если не указано, будут включены все типы событий.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Объект EventGridSubscription.
Type: | PSEventSubscription |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Label
Метки для подписки на события
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxDeliveryAttempt
Максимальное количество попыток доставки события. Это значение должно быть от 1 до 30
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxEventsPerBatch
Максимальное количество событий в пакете. Это значение должно быть от 1 до 5000. Этот параметр действителен, если тип Endpint является только веб-перехватчиком.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PreferredBatchSizeInKiloByte
Предпочтительный размер пакета в килобайтах. Это значение должно быть от 1 до 1024. Этот параметр действителен, если тип Endpint является только веб-перехватчиком.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Группа ресурсов раздела.
Type: | String |
Aliases: | ResourceGroup |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceId
Идентификатор ресурса, для которого была создана подписка на событие.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SubjectBeginsWith
Фильтр, указывающий, что будут включены только события, соответствующие указанному префиксу субъекта. Если не указано, будут включены события со всеми префиксами субъекта.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SubjectEndsWith
Фильтр, указывающий, что будут включены только события, соответствующие указанному суффиксу субъекта. Если это не указано, будут включены события со всеми суффиксами субъекта.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TopicName
Имя раздела, для которого должна быть создана подписка на событие.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Показывает, что произойдет при запуске командлета. Командлет не выполняется.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Входные данные
Выходные данные
Azure PowerShell
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по