New-AzEventGridPartnerTopicEventSubscription

참조

모듈:: Az.EventGrid

파트너 토픽에 대한 새 Azure Event Grid 이벤트 구독을 만듭니다.

Syntax

New-AzEventGridPartnerTopicEventSubscription
   -Name <String>
   -ResourceGroupName <String>
   -PartnerTopicName <String>
   [-AzureActiveDirectoryApplicationIdOrUri <String>]
   [-AzureActiveDirectoryTenantId <String>]
   [-DeadLetterEndpoint <String>]
   [-DeliveryAttributeMapping <Hashtable[]>]
   [-Endpoint <String>]
   [-EndpointType <String>]
   [-DeliverySchema <String>]
   [-EventTtl <Int32>]
   [-ExpirationDate <DateTime>]
   [-Label <String[]>]
   [-MaxDeliveryAttempt <Int32>]
   [-MaxEventsPerBatch <Int32>]
   [-PreferredBatchSizeInKiloByte <Int32>]
   [-StorageQueueMessageTtl <Int64>]
   [-AdvancedFilter <Hashtable[]>]
   [-AdvancedFilteringOnArray]
   [-IncludedEventType <String[]>]
   [-SubjectBeginsWith <String>]
   [-SubjectEndsWith <String>]
   [-SubjectCaseSensitive]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Azure Event Grid 파트너 토픽에 대한 새 이벤트 구독을 만듭니다.

예제

예 1

New-AzEventGridPartnerTopicEventSubscription -ResourceGroup MyResourceGroup -PartnerTopicName Topic1 -Endpoint https://requestb.in/19qlscd1 -EventSubscriptionName EventSubscription1

웹후크 대상 엔드포인트 https://requestb.in/19qlscd1를 사용하여 리소스 그룹 'MyResourceGroupName'에서 Azure Event Grid 파트너 토픽 'Topic1'에 대한 새 이벤트 구독 'EventSubscription1'을 만듭니다. 이 이벤트 구독은 기본 필터를 사용합니다.

예제 2

$includedEventTypes = "Microsoft.Resources.ResourceWriteFailure", "Microsoft.Resources.ResourceWriteSuccess"
$labels = "Finance", "HR"
New-AzEventGridPartnerTopicEventSubscription -ResourceGroup MyResourceGroup -PartnerTopicName Topic1 -EventSubscriptionName EventSubscription1 -Endpoint https://requestb.in/19qlscd1  -SubjectBeginsWith "TestPrefix" -SubjectEndsWith "TestSuffix" -IncludedEventType $includedEventTypes -Label $labels

웹후크 대상 엔드포인트 https://requestb.in/19qlscd1를 사용하여 리소스 그룹 'MyResourceGroup'에서 Sytem Topic 'Topic1'에 대한 새 이벤트 구독 'EventSubscription1'을 만듭니다. 이 이벤트 구독은 이벤트 유형 및 제목에 대한 추가 필터를 지정하며 해당 필터와 일치하는 이벤트만 대상 엔드포인트로 전달됩니다.

예 3

New-AzEventGridPartnerTopicEventSubscription -ResourceGroup MyResourceGroup -PartnerTopicName Topic1 -EventSubscriptionName EventSubscription1 -EndpointType "eventhub" -Endpoint "/subscriptions/55f3dcd4-cac7-43b4-990b-a139d62a1eb2/resourceGroups/TestRG/providers/Microsoft.EventHub/namespaces/ContosoNamespace/eventhubs/EH1"

지정된 이벤트 허브를 이벤트의 대상으로 사용하여 리소스 그룹 'MyResourceGroup'에서 Sytem Topic 'Topic1'에 대한 새 이벤트 구독 'EventSubscription1'을 만듭니다. 이 이벤트 구독은 기본 필터를 사용합니다.

매개 변수

-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")}

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

-AdvancedFilteringOnArray

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

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

-AzureActiveDirectoryApplicationIdOrUri

배달 요청에 전달자 토큰으로 포함될 액세스 토큰을 가져오는 Microsoft Entra 애플리케이션 ID 또는 URI입니다. 웹후크를 대상으로 하는 경우에만 적용됩니다.

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

-AzureActiveDirectoryTenantId

배달 요청에 전달자 토큰으로 포함될 액세스 토큰을 가져오는 Microsoft Entra 테넌트 ID입니다. 웹후크를 대상으로 하는 경우에만 적용됩니다.

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

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	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].

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
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:	True
Accept wildcard characters:	False

-DeliverySchema

대상에 이벤트를 전달할 때 사용할 스키마입니다. 가능한 값은 eventgridschema, CustomInputSchema 또는 cloudeventv01schema입니다. 기본값은 CustomInputSchema입니다.

Type:	String
Position:	Named
Default value:	None
Required:	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을 실행하기 전에 대상 엔드포인트를 만들고 사용할 수 있어야 합니다.

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

-EndpointType

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

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

-EventTtl

이벤트 배달 시간(분)입니다. 이 값은 1에서 1440 사이여야 합니다.

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

-ExpirationDate

이벤트 구독이 사용 중지된 후 이벤트 구독의 만료 날짜/시간을 결정합니다.

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

-IncludedEventType

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

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

-Label

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

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

-MaxDeliveryAttempt

이벤트를 배달하려는 최대 시도 횟수입니다. 이 값은 1에서 30 사이여야 합니다.

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

-MaxEventsPerBatch

일괄 처리의 최대 이벤트 수입니다. 이 값은 1에서 5000 사이여야 합니다. 이 매개 변수는 Endpint 형식이 웹후크일 때만 유효합니다.

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

-Name

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

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

-PartnerTopicName

Event Grid 파트너 토픽 이름입니다.

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

-PreferredBatchSizeInKiloByte

기본 배치 크기(킬로바이트)입니다. 이 값은 1에서 1024 사이여야 합니다. 이 매개 변수는 Endpint 형식이 웹후크일 때만 유효합니다.

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

-ResourceGroupName

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

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

-StorageQueueMessageTtl

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

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

-SubjectBeginsWith

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

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

-SubjectCaseSensitive

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

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

-SubjectEndsWith

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

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

-WhatIf

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

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

입력

String

String[]

Int32

DateTime

Int64

Hashtable[]

SwitchParameter

출력

PSEventSubscription