다음을 통해 공유


Update-AzEventGridSystemTopicEventSubscription

Event Grid 시스템 토픽 이벤트 구독의 속성을 업데이트합니다.

Syntax

Update-AzEventGridSystemTopicEventSubscription
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzEventGridSystemTopicEventSubscription
      -EventSubscriptionName <String>
      -ResourceGroupName <String>
      -SystemTopicName <String>
      [-DeadLetterEndpoint <String>]
      [-DeliveryAttributeMapping <Hashtable[]>]
      [-Endpoint <String>]
      [-EndpointType <String>]
      [-Label <String[]>]
      [-StorageQueueMessageTtl <Int64>]
      [-AdvancedFilter <Hashtable[]>]
      [-AdvancedFilteringOnArray]
      [-IncludedEventType <String[]>]
      [-SubjectBeginsWith <String>]
      [-SubjectEndsWith <String>]
      [-SubjectCaseSensitive]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Event Grid 시스템 토픽 이벤트 구독의 속성을 업데이트합니다. 기존 이벤트 구독의 필터, 대상 또는 레이블을 업데이트하는 데 사용할 수 있습니다.

예제

예 1

Update-AzEventGridSystemTopicEventSubscription -EventSubscriptionName ES1 -SystemTopicName Topic1 -ResourceGroupName MyResourceGroupName -Endpoint https://requestb.in/1kxxoui1

리소스 그룹 'MyResourceGroupName'의 시스템 토픽 'Topic1'에 대한 이벤트 구독 'ES1'의 엔드포인트를 ''로 업데이트https://requestb.in/1kxxoui1.

예제 2

$labels = "Finance", "HR"
Update-AzEventGridSystemTopicEventSubscription -EventSubscriptionName ES1 -SystemTopicName Topic1 -ResourceGroupName MyResourceGroupName -Label $labels

'MyResourceGroupName'의 시스템 토픽 'Topic1'에 대한 이벤트 구독 'ES1'의 속성을 새 레이블 $labels 업데이트.

예 3

Update-AzEventGridSystemTopicEventSubscription -EventSubscriptionName ES1 -SystemTopicName Topic1 -ResourceGroupName MyResourceGroupName -Endpoint https://requestb.in/1kxxoui1 -SubjectEndsWith "jpg"

새 엔드포인트 ''와 새 SubjectEndsWith 필터를 'jpg'로 사용하여 'MyResourceGroupName'의 시스템 토픽 'Topic1'에 대한 이벤트 구독 'ES1'의 속성을 업데이트https://requestb.in/1kxxoui1.

매개 변수

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

형식:Hashtable[]
Position:Named
기본값:None
필수:False
Accept pipeline input:True
Accept wildcard characters:False

-AdvancedFilteringOnArray

이 매개 변수의 존재는 배열에 대한 고급 필터링이 사용됨을 나타냅니다.

형식:SwitchParameter
Position:Named
기본값:None
필수:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

형식:SwitchParameter
Aliases:cf
Position:Named
기본값:None
필수:False
Accept pipeline input:False
Accept wildcard characters:False

-DeadLetterEndpoint

배달되지 않은 이벤트를 저장하는 데 사용되는 엔드포인트입니다. Storage Blob 컨테이너의 Azure 리소스 ID를 지정합니다. 예: /subscriptions/[SubscriptionId]/resourceGroups/[ResourceGroupName]/providers/Microsoft.Storage/storageAccounts/[StorageAccountName]/blobServices/default/containers/[ContainerName].

형식:String
Position:Named
기본값:None
필수:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

형식:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
기본값:None
필수: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"}

형식:Hashtable[]
Position:Named
기본값:None
필수:False
Accept pipeline input:True
Accept wildcard characters:False

-Endpoint

이벤트 구독 대상 엔드포인트입니다. 웹후크 URL 또는 EventHub, 스토리지 큐, hybridconnection, servicebusqueue, servicebustopic 또는 azurefunction의 Azure 리소스 ID일 수 있습니다. 예를 들어 하이브리드 연결의 리소스 ID는 /subscriptions/[Azure 구독 ID]/resourceGroups/[ResourceGroupName]/providers/Microsoft.Relay/namespaces/[NamespaceName]/hybrid커넥트ions/[Hybrid커넥트ionName] 형식을 사용합니다. Event Grid cmdlet을 실행하기 전에 대상 엔드포인트를 만들고 사용할 수 있어야 합니다.

형식:String
Position:Named
기본값:None
필수:False
Accept pipeline input:True
Accept wildcard characters:False

-EndpointType

엔드포인트 유형입니다. 웹후크, eventhub, storagequeue, hybridconnection, servicebusqueue, servicebustopic 또는 azurefunction일 수 있습니다. 기본값은 웹후크입니다.

형식:String
Position:Named
기본값:None
필수:False
Accept pipeline input:True
Accept wildcard characters:False

-EventSubscriptionName

EventGrid 이벤트 구독 이름입니다.

형식:String
Position:Named
기본값:None
필수:True
Accept pipeline input:True
Accept wildcard characters:False

-IncludedEventType

포함할 이벤트 유형 목록을 지정하는 필터입니다. 지정하지 않으면 모든 이벤트 유형(사용자 지정 토픽 및 할 일기본) 또는 기본 이벤트 형식(다른 토픽 형식의 경우)이 포함됩니다.

형식:String[]
Position:Named
기본값:None
필수:False
Accept pipeline input:True
Accept wildcard characters:False

-Label

이벤트 구독에 대한 레이블입니다.

형식:String[]
Position:Named
기본값:None
필수:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

리소스 그룹의 이름입니다.

형식:String
Position:Named
기본값:None
필수:True
Accept pipeline input:True
Accept wildcard characters:False

-StorageQueueMessageTtl

스토리지 큐 메시지의 TL(Time to Live) 시간(밀리초)입니다.

형식:Int64
Position:Named
기본값:None
필수:False
Accept pipeline input:True
Accept wildcard characters:False

-SubjectBeginsWith

지정된 제목 접두사와 일치하는 이벤트만 포함되도록 지정하는 필터입니다. 지정하지 않으면 모든 주체 접두사를 가진 이벤트가 포함됩니다.

형식:String
Position:Named
기본값:None
필수:False
Accept pipeline input:True
Accept wildcard characters:False

-SubjectCaseSensitive

대/소문자를 구분하는 방식으로 주체 필드를 비교해야 임을 지정하는 필터입니다. 지정하지 않으면 주체는 대/소문자를 구분하지 않는 방식으로 비교됩니다.

형식:SwitchParameter
Position:Named
기본값:None
필수:False
Accept pipeline input:True
Accept wildcard characters:False

-SubjectEndsWith

지정된 제목 접미사와 일치하는 이벤트만 포함되도록 지정하는 필터입니다. 지정하지 않으면 모든 제목 접미사가 있는 이벤트가 포함됩니다.

형식:String
Position:Named
기본값:None
필수:False
Accept pipeline input:True
Accept wildcard characters:False

-SystemTopicName

EventGrid 토픽 이름입니다.

형식:String
Position:Named
기본값:None
필수:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

형식:SwitchParameter
Aliases:wi
Position:Named
기본값:None
필수:False
Accept pipeline input:False
Accept wildcard characters:False

입력

String

String[]

Int64

Hashtable[]

SwitchParameter

출력

PSEventSubscription