New-AzEventGridSubscription

모듈:

Az.EventGrid

지정된 범위에 따라 새 이벤트 구독을 비동기적으로 만들거나 기존 이벤트 구독을 만듭니다.

구문

New-AzEventGridSubscription
   -Name <String>
   -Scope <String>
   [-DeadLetterWithResourceIdentityType <String>]
   [-DeadLetterWithResourceIdentityUserAssignedIdentity <String>]
   [-DeliveryWithResourceIdentityDestination <IEventSubscriptionDestination>]
   [-DeliveryWithResourceIdentityType <String>]
   [-DeliveryWithResourceIdentityUserAssignedIdentity <String>]
   [-Destination <IEventSubscriptionDestination>]
   [-EventDeliverySchema <String>]
   [-ExpirationTimeUtc <DateTime>]
   [-FilterAdvancedFilter <IAdvancedFilter[]>]
   [-FilterEnableAdvancedFilteringOnArray]
   [-FilterIncludedEventType <String[]>]
   [-FilterIsSubjectCaseSensitive]
   [-FilterSubjectBeginsWith <String>]
   [-FilterSubjectEndsWith <String>]
   [-Label <String[]>]
   [-RetryPolicyEventTimeToLiveInMinute <Int32>]
   [-RetryPolicyMaxDeliveryAttempt <Int32>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzEventGridSubscription
   -Name <String>
   -Scope <String>
   -JsonString <String>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzEventGridSubscription
   -Name <String>
   -Scope <String>
   -JsonFilePath <String>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzEventGridSubscription
   -InputObject <IEventGridIdentity>
   [-DeadLetterWithResourceIdentityType <String>]
   [-DeadLetterWithResourceIdentityUserAssignedIdentity <String>]
   [-DeliveryWithResourceIdentityDestination <IEventSubscriptionDestination>]
   [-DeliveryWithResourceIdentityType <String>]
   [-DeliveryWithResourceIdentityUserAssignedIdentity <String>]
   [-Destination <IEventSubscriptionDestination>]
   [-EventDeliverySchema <String>]
   [-ExpirationTimeUtc <DateTime>]
   [-FilterAdvancedFilter <IAdvancedFilter[]>]
   [-FilterEnableAdvancedFilteringOnArray]
   [-FilterIncludedEventType <String[]>]
   [-FilterIsSubjectCaseSensitive]
   [-FilterSubjectBeginsWith <String>]
   [-FilterSubjectEndsWith <String>]
   [-Label <String[]>]
   [-RetryPolicyEventTimeToLiveInMinute <Int32>]
   [-RetryPolicyMaxDeliveryAttempt <Int32>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

지정된 범위에 따라 새 이벤트 구독을 비동기적으로 만들거나 기존 이벤트 구독을 만듭니다.

예제

예제 1: 새 이벤트 구독을 비동기적으로 만들거나 지정된 범위에 따라 기존 이벤트 구독을 업데이트합니다.

$obj = New-AzEventGridWebHookEventSubscriptionDestinationObject -EndpointUrl "https://azpsweb.azurewebsites.net/api/updates"
New-AzEventGridSubscription -Name azps-eventsub -Scope "subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" -Destination $obj -FilterIsSubjectCaseSensitive:$false

Name          ResourceGroupName
----          -----------------
azps-eventsub

새 이벤트 구독을 비동기적으로 만들거나 지정된 범위에 따라 기존 이벤트 구독을 업데이트합니다.

예제 2: 새 이벤트 구독을 비동기적으로 만들거나 지정된 범위에 따라 기존 이벤트 구독을 업데이트합니다.

$obj = New-AzEventGridWebHookEventSubscriptionDestinationObject -EndpointUrl "https://azpsweb.azurewebsites.net/api/updates"
$topic = Get-AzEventGridTopic -ResourceGroupName azps_test_group_eventgrid -Name azps-topic
New-AzEventGridSubscription -Name azps-eventsub -Scope $topic.Id -Destination $obj -FilterIsSubjectCaseSensitive:$false -FilterSubjectBeginsWith "ExamplePrefix" -FilterSubjectEndsWith "ExampleSuffix"

Name          ResourceGroupName
----          -----------------
azps-eventsub azps_test_group_eventgrid

새 이벤트 구독을 비동기적으로 만들거나 지정된 범위에 따라 기존 이벤트 구독을 업데이트합니다.

매개 변수

-AsJob

작업으로 명령 실행

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Confirm

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

형식:	SwitchParameter
별칭:	cf
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DeadLetterWithResourceIdentityType

사용되는 관리 ID의 형식입니다. 'SystemAssigned, UserAssigned' 형식에는 암시적으로 생성된 ID와 사용자 할당 ID 집합이 모두 포함됩니다. 'None' 형식은 모든 ID를 제거합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DeadLetterWithResourceIdentityUserAssignedIdentity

리소스와 연결된 사용자 ID입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DefaultProfile

DefaultProfile 매개 변수가 작동하지 않습니다. 다른 구독에 대해 cmdlet을 실행하는 경우 사용 가능한 경우 SubscriptionId 매개 변수를 사용합니다.

형식:	PSObject
별칭:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DeliveryWithResourceIdentityDestination

이벤트 구독에 대해 이벤트를 배달해야 하는 대상에 대한 정보입니다. Azure Event Grid의 ID를 사용하여 배달/배달 못 한 편지 중에 사용되는 인증 토큰을 획득합니다.

형식:	IEventSubscriptionDestination
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DeliveryWithResourceIdentityType

사용되는 관리 ID의 형식입니다. 'SystemAssigned, UserAssigned' 형식에는 암시적으로 생성된 ID와 사용자 할당 ID 집합이 모두 포함됩니다. 'None' 형식은 모든 ID를 제거합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DeliveryWithResourceIdentityUserAssignedIdentity

리소스와 연결된 사용자 ID입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Destination

이벤트 구독에 대해 이벤트를 배달해야 하는 대상에 대한 정보입니다. Azure Event Grid의 ID를 사용하여 배달/배달 못 한 편지 중에 사용되는 인증 토큰을 획득합니다.

형식:	IEventSubscriptionDestination
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-EventDeliverySchema

이벤트 구독에 대한 이벤트 배달 스키마입니다.

형식:	String
별칭:	DeliverySchema
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ExpirationTimeUtc

이벤트 구독의 만료 시간입니다.

형식:	DateTime
별칭:	ExpirationDate
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-FilterAdvancedFilter

이벤트 구독을 필터링하는 데 사용되는 고급 필터의 배열입니다.

형식:	IAdvancedFilter[]
별칭:	AdvancedFilter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-FilterEnableAdvancedFilteringOnArray

단수 값을 예상하는 대신 고급 필터를 값 배열에 대해 평가할 수 있습니다.

형식:	SwitchParameter
별칭:	AdvancedFilteringOnArray
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-FilterIncludedEventType

이벤트 구독의 일부여야 하는 적용 가능한 이벤트 유형 목록입니다. 모든 기본 이벤트 유형을 구독하려면 IncludedEventTypes를 null로 설정합니다.

형식:	String[]
별칭:	IncludedEventType
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-FilterIsSubjectCaseSensitive

filtershould의 SubjectBeginsWith 및 SubjectEndsWith 속성을 대/소문자를 구분하여 비교할지 지정합니다.

형식:	SwitchParameter
별칭:	SubjectCaseSensitive
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-FilterSubjectBeginsWith

리소스 경로 접두사를 기반으로 이벤트 구독에 대한 이벤트를 필터링하는 선택적 문자열입니다. 이 형식은 이벤트의 게시자에 따라 달라집니다. 와일드카드 문자는 이 경로에서 지원되지 않습니다.

형식:	String
별칭:	SubjectBeginsWith
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-FilterSubjectEndsWith

리소스 경로 접미사를 기반으로 이벤트 구독에 대한 이벤트를 필터링하는 선택적 문자열입니다. 와일드카드 문자는 이 경로에서 지원되지 않습니다.

형식:	String
별칭:	SubjectEndsWith
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-InputObject

ID 매개 변수

형식:	IEventGridIdentity
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-JsonFilePath

만들기 작업에 제공된 Json 파일의 경로

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-JsonString

만들기 작업에 제공된 Json 문자열

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Label

사용자 정의 레이블 목록입니다.

형식:	String[]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Name

이벤트 구독의 이름입니다. 이벤트 구독 이름은 길이가 3자에서 64자 사이여야 하며 영숫자만 사용해야 합니다.

형식:	String
별칭:	EventSubscriptionName
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-NoWait

명령을 비동기적으로 실행

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-PassThru

명령이 성공하면 true를 반환합니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-RetryPolicyEventTimeToLiveInMinute

이벤트에 대한 Time To Live(분)입니다.

형식:	Int32
별칭:	EventTtl
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-RetryPolicyMaxDeliveryAttempt

이벤트에 대한 배달 재시도 최대 횟수입니다.

형식:	Int32
별칭:	MaxDeliveryAttempt
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Scope

이벤트 구독을 만들거나 업데이트해야 하는 리소스의 식별자입니다. 범위는 구독, 리소스 그룹 또는 리소스 공급자 네임스페이스 또는 EventGrid 토픽에 속하는 최상위 리소스일 수 있습니다. 예를 들어 구독에 '/subscriptions/{subscriptionId}/'를 사용하고, 리소스 그룹에는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}'을 사용합니다. 및 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}' 및 EventGrid 토픽에 대한 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/topics/{topicName}'

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

형식:	SwitchParameter
별칭:	wi
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

입력

IEventGridIdentity

출력

IEventSubscription