New-AzEventGridNamespaceTopicEventSubscription
指定されたパラメーターを使用して、名前空間トピックのイベント サブスクリプションを非同期で作成または更新します。 既存のイベント サブスクリプションは、この API で更新されます。
構文
New-AzEventGridNamespaceTopicEventSubscription
-EventSubscriptionName <String>
-NamespaceName <String>
-ResourceGroupName <String>
[-SubscriptionId <String>]
-TopicName <String>
[-DeliveryConfigurationDeliveryMode <String>]
[-EventDeliverySchema <String>]
[-FilterConfigurationFilter <IFilter[]>]
[-FilterConfigurationIncludedEventType <String[]>]
[-IdentityType <String>]
[-QueueEventTimeToLive <TimeSpan>]
[-QueueMaxDeliveryCount <Int32>]
[-QueueReceiveLockDurationInSecond <Int32>]
[-UserAssignedIdentity <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzEventGridNamespaceTopicEventSubscription
-EventSubscriptionName <String>
-NamespaceName <String>
-ResourceGroupName <String>
[-SubscriptionId <String>]
-TopicName <String>
-JsonString <String>
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzEventGridNamespaceTopicEventSubscription
-EventSubscriptionName <String>
-NamespaceName <String>
-ResourceGroupName <String>
[-SubscriptionId <String>]
-TopicName <String>
-JsonFilePath <String>
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzEventGridNamespaceTopicEventSubscription
-EventSubscriptionName <String>
-TopicInputObject <IEventGridIdentity>
[-DeliveryConfigurationDeliveryMode <String>]
[-EventDeliverySchema <String>]
[-FilterConfigurationFilter <IFilter[]>]
[-FilterConfigurationIncludedEventType <String[]>]
[-IdentityType <String>]
[-QueueEventTimeToLive <TimeSpan>]
[-QueueMaxDeliveryCount <Int32>]
[-QueueReceiveLockDurationInSecond <Int32>]
[-UserAssignedIdentity <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzEventGridNamespaceTopicEventSubscription
-EventSubscriptionName <String>
-TopicName <String>
-NamespaceInputObject <IEventGridIdentity>
[-DeliveryConfigurationDeliveryMode <String>]
[-EventDeliverySchema <String>]
[-FilterConfigurationFilter <IFilter[]>]
[-FilterConfigurationIncludedEventType <String[]>]
[-IdentityType <String>]
[-QueueEventTimeToLive <TimeSpan>]
[-QueueMaxDeliveryCount <Int32>]
[-QueueReceiveLockDurationInSecond <Int32>]
[-UserAssignedIdentity <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzEventGridNamespaceTopicEventSubscription
-InputObject <IEventGridIdentity>
[-DeliveryConfigurationDeliveryMode <String>]
[-EventDeliverySchema <String>]
[-FilterConfigurationFilter <IFilter[]>]
[-FilterConfigurationIncludedEventType <String[]>]
[-IdentityType <String>]
[-QueueEventTimeToLive <TimeSpan>]
[-QueueMaxDeliveryCount <Int32>]
[-QueueReceiveLockDurationInSecond <Int32>]
[-UserAssignedIdentity <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
指定されたパラメーターを使用して、名前空間トピックのイベント サブスクリプションを非同期で作成または更新します。 既存のイベント サブスクリプションは、この API で更新されます。
例
例 1: 指定されたパラメーターを使用して、名前空間トピックのイベント サブスクリプションを非同期に作成します。
$TimeSpan = New-TimeSpan -Hours 1 -Minutes 25
New-AzEventGridNamespaceTopicEventSubscription -EventSubscriptionName azps-eventsubname -NamespaceName azps-eventgridnamespace -ResourceGroupName azps_test_group_eventgrid -TopicName azps-topic -DeliveryConfigurationDeliveryMode Queue -QueueReceiveLockDurationInSecond 60 -QueueMaxDeliveryCount 4 -QueueEventTimeToLive $TimeSpan -EventDeliverySchema CloudEventSchemaV1_0
Name ResourceGroupName
---- -----------------
azps-eventsubname azps_test_group_eventgrid指定されたパラメーターを使用して、名前空間トピックのイベント サブスクリプションを非同期に作成します。 既存のイベント サブスクリプションは、この API で更新されます。
パラメーター
-AsJob
コマンドをジョブとして実行する
| 型: | SwitchParameter |
| Position: | Named |
| 既定値: | None |
| 必須: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
| 型: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| 既定値: | None |
| 必須: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
DefaultProfile パラメーターは機能しません。 別のサブスクリプションに対してコマンドレットを実行する場合は、使用可能な場合は SubscriptionId パラメーターを使用します。
| 型: | PSObject |
| Aliases: | AzureRMContext, AzureCredential |
| Position: | Named |
| 既定値: | None |
| 必須: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeliveryConfigurationDeliveryMode
イベント サブスクリプションの配信モード。
| 型: | String |
| Position: | Named |
| 既定値: | None |
| 必須: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EventDeliverySchema
イベント サブスクリプションのイベント配信スキーマ。
| 型: | String |
| Position: | Named |
| 既定値: | None |
| 必須: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EventSubscriptionName
作成されるイベント サブスクリプションの名前。 イベント サブスクリプション名の長さは 3 ~ 100 文字で、英数字のみを使用する必要があります。
| 型: | String |
| Position: | Named |
| 既定値: | None |
| 必須: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FilterConfigurationFilter
イベント サブスクリプションのフィルター処理に使用されるフィルターの配列。
| 型: | IFilter[] |
| Position: | Named |
| 既定値: | None |
| 必須: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FilterConfigurationIncludedEventType
イベント サブスクリプションの一部である必要がある適用可能なイベントの種類の一覧。 すべての既定のイベントの種類をサブスクライブする場合は、IncludedEventTypes を null に設定します。
| 型: | String[] |
| Position: | Named |
| 既定値: | None |
| 必須: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IdentityType
使用されるマネージド ID の種類。 型 'SystemAssigned, UserAssigned' には、暗黙的に作成された ID とユーザー割り当て ID のセットの両方が含まれます。 型 'None' では、任意の ID が削除されます。
| 型: | String |
| Position: | Named |
| 既定値: | None |
| 必須: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
IDENTITY パラメーター
| 型: | IEventGridIdentity |
| Position: | Named |
| 既定値: | None |
| 必須: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-JsonFilePath
作成操作に指定された Json ファイルのパス
| 型: | String |
| Position: | Named |
| 既定値: | None |
| 必須: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JsonString
作成操作に指定された Json 文字列
| 型: | String |
| Position: | Named |
| 既定値: | None |
| 必須: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NamespaceInputObject
IDENTITY パラメーター
| 型: | IEventGridIdentity |
| Position: | Named |
| 既定値: | None |
| 必須: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-NamespaceName
名前空間の名前。
| 型: | String |
| Position: | Named |
| 既定値: | None |
| 必須: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NoWait
コマンドを非同期的に実行する
| 型: | SwitchParameter |
| Position: | Named |
| 既定値: | None |
| 必須: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-QueueEventTimeToLive
メッセージが発行された時点からサブスクリプションで使用できるメッセージの長さを決定する ISO 8601 形式の期間。この期間の値は、次の形式で表されます: 'P(n)Y(n)M(n)DT(n)H(n)M(n)S'。 - (n) は、(n) に続く各 time 要素の値に置き換えられます。
- P は期間 (または期間) 指定子であり、常に期間の先頭に配置されます。
- Y は年指定子であり、年数の値に従います。
- M は月の指定子であり、月数の値に従います。
- W は週指定子で、週数の値に従います。
- D は日指定子で、日数の値に従います。
- T は時間指定子で、時刻コンポーネントの前に置きます。
- H は時間指定子で、時間数の値に従います。
- M は分指定子であり、分数の値に従います。
- S は 2 番目の指定子で、秒数の値に従います。この期間の値は、トピックの EventRetentionInDays より大きく設定することはできません。 これは省略可能なフィールドで、最小値は 1 分で、最大値はトピックの EventRetentionInDays 値によって決まります。 有効な値の例を次に示します。 -'P0DT23H12M' または 'PT23H12M': 期間は 23 時間 12 分です。
- 'P1D' または 'P1DT0H0M0S': 1 日の期間。
| 型: | TimeSpan |
| Position: | Named |
| 既定値: | None |
| 必須: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-QueueMaxDeliveryCount
イベントの最大配信数。
| 型: | Int32 |
| Position: | Named |
| 既定値: | None |
| 必須: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-QueueReceiveLockDurationInSecond
メッセージが (クライアントによって) 受信され、受け入れ、解放、または拒否されるのを待機している最大期間 (秒単位)。クライアントがメッセージを受信した後にこの時間が経過し、受け入れ済み (未処理)、リリース済み、または拒否済みに移行されていない場合、メッセージは再配信に使用できます。 これは省略可能なフィールドです。既定値は 60 秒、最小値は 60 秒、最大値は 300 秒です。
| 型: | Int32 |
| Position: | Named |
| 既定値: | None |
| 必須: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ResourceGroupName
ユーザーのサブスクリプション内のリソース グループの名前。
| 型: | String |
| Aliases: | ResourceGroup |
| Position: | Named |
| 既定値: | None |
| 必須: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SubscriptionId
Microsoft Azure サブスクリプションを一意に識別するサブスクリプション資格情報。 サブスクリプション ID は、全ての修理依頼についてURI の一部を生じさせます。
| 型: | String |
| Position: | Named |
| 既定値: | (Get-AzContext).Subscription.Id |
| 必須: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TopicInputObject
IDENTITY パラメーター
| 型: | IEventGridIdentity |
| Position: | Named |
| 既定値: | None |
| 必須: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TopicName
名前空間トピックの名前。
| 型: | String |
| Position: | Named |
| 既定値: | None |
| 必須: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserAssignedIdentity
リソースに関連付けられているユーザー ID。
| 型: | String |
| Aliases: | IdentityId |
| Position: | Named |
| 既定値: | None |
| 必須: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| 既定値: | None |
| 必須: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
出力
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
Azure PowerShell
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示