New-AzActivityLogAlert
新しいアクティビティ ログ アラート ルールを作成するか、既存のアクティビティ ログ アラート ルールを更新します。
構文
New-AzActivityLogAlert
-Name <String>
-ResourceGroupName <String>
[-SubscriptionId <String>]
-Action <IActionGroup[]>
-Condition <IAlertRuleAnyOfOrLeafCondition[]>
-Location <String>
-Scope <String[]>
[-Description <String>]
[-Enabled <Boolean>]
[-Tag <Hashtable>]
[-DefaultProfile <PSObject>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
新しいアクティビティ ログ アラート ルールを作成するか、既存のアクティビティ ログ アラート ルールを更新します。
例
例 1: アクティビティ ログ アラートを作成する
$scope = "subscriptions/"+(Get-AzContext).Subscription.ID
$actiongroup=New-AzActivityLogAlertActionGroupObject -Id $ActionGroupResourceId -WebhookProperty @{"sampleWebhookProperty"="SamplePropertyValue"}
$condition1=New-AzActivityLogAlertAlertRuleAnyOfOrLeafConditionObject -Equal Administrative -Field category
$condition2=New-AzActivityLogAlertAlertRuleAnyOfOrLeafConditionObject -Equal Error -Field level
$any1=New-AzActivityLogAlertAlertRuleLeafConditionObject -Field properties.incidentType -Equal Maintenance
$any2=New-AzActivityLogAlertAlertRuleLeafConditionObject -Field properties.incidentType -Equal Incident
$condition3=New-AzActivityLogAlertAlertRuleAnyOfOrLeafConditionObject -AnyOf $any1,$any2
New-AzActivityLogAlert -Name $AlertName -ResourceGroupName $ResourceGroupName -Action $actiongroup -Condition @($condition1,$condition2,$condition3) -Location global -Scope $scope
サブスクリプションのアクティビティ ログ アラートを作成する (完了した日時と $condition2
($any1
または$any2
) 場合$condition1
)
パラメーター
-Action
アクション グループの一覧。 構築するには、ACTIONGROUP プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。 構築するには、ACTION プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。
Type: | IActionGroup[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Condition
アクティビティ ログ アラート ルールの条件の一覧。 構築するには、CONDITIONAL時プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。 構築するには、CONDITION プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。
Type: | IAlertRuleAnyOfOrLeafCondition[] |
Position: | Named |
Default value: | None |
Required: | True |
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 |
-DefaultProfile
Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。
Type: | PSObject |
Aliases: | AzureRMContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
このアクティビティ ログ アラート ルールの説明。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Enabled
このアクティビティ ログ アラート ルールが有効かどうかを示します。 アクティビティ ログ アラート ルールが有効になっていない場合、そのアクションはアクティブになりません。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Location
リソースの場所。 Azure アクティビティ ログ アラートはグローバル サービスであるため、ルールの場所は常に "グローバル" にする必要があります。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
アクティビティ ログ アラート ルールの名前。
Type: | String |
Aliases: | ActivityLogAlertName |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
リソース グループの名前。 名前の大文字と小文字は区別されます。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Scope
プレフィックスとして使用されるリソース ID の一覧。 アラートは、これらのプレフィックスのいずれかに該当するリソース ID を持つアクティビティ ログ イベントにのみ適用されます。 このリストには、少なくとも 1 つの項目が含まれている必要があります。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SubscriptionId
ターゲット サブスクリプションの ID。
Type: | String |
Position: | Named |
Default value: | (Get-AzContext).Subscription.Id |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Tag
リソースのタグ。
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
出力
メモ
別名
複合パラメーターのプロパティ
以下で説明するパラメーターを作成するには、適切なプロパティを含むハッシュ テーブルを作成します。 ハッシュ テーブルの詳細については、Get-Help about_Hash_Tablesを実行します。
ACTION <IActionGroup[]>
: アクション グループの一覧。 構築するには、ACTIONGROUP プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。
Id <String>
: アクション グループのリソース ID。 null または空にすることはできません。[WebhookProperty <IActionGroupWebhookProperties>]
: post 操作に含めるカスタム プロパティのディクショナリ。 これらのデータは Webhook ペイロードに追加されます。[(Any) <String>]
: このオブジェクトに追加できるプロパティを示します。
CONDITION <IAlertRuleAnyOfOrLeafCondition[]>
: アクティビティ ログ アラート ルールの条件の一覧。 構築するには、CONDITIONAL時プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。
[ContainsAny <String[]>]
: イベントのフィールドの値は、条件が満たされているかどうかを判断するために、この配列内の値と比較されます (大文字と小文字は区別されません)。[Equal <String>]
: イベントのフィールドの値はこの値と比較され (大文字と小文字は区別されません)、条件が満たされているかどうかを判断します。[Field <String>]
: この条件で調べるアクティビティ ログ イベントのフィールドの名前。 このフィールドに指定できる値は (大文字と小文字は区別されません):'resourceId'、'category'、'caller'、'level'、'operationName'、'resourceGroup'、'resourceProvider'、'status'、'subStatus'、'resourceType'、または 'properties' で始まるもの。[AnyOf <IAlertRuleLeafCondition[]>]
: メンバー リーフ条件の少なくとも 1 つが満たされたときに満たされるアクティビティ ログ アラート ルールの条件。[ContainsAny <String[]>]
: イベントのフィールドの値は、条件が満たされているかどうかを判断するために、この配列内の値と比較されます (大文字と小文字は区別されません)。[Equal <String>]
: イベントのフィールドの値はこの値と比較され (大文字と小文字は区別されません)、条件が満たされているかどうかを判断します。[Field <String>]
: この条件で調べるアクティビティ ログ イベントのフィールドの名前。 このフィールドに指定できる値は (大文字と小文字は区別されません):'resourceId'、'category'、'caller'、'level'、'operationName'、'resourceGroup'、'resourceProvider'、'status'、'subStatus'、'resourceType'、または 'properties' で始まるもの。