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
$condition1
と$condition2
、($any1
または$any2
) が満たされたときに、サブスクリプションのアクティビティ ログ アラートを作成する
パラメーター
-Action
アクション グループの一覧。 構築するには、ACTIONGROUP プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。 構築するには、ACTION プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。
型: | IActionGroup[] |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Condition
アクティビティ ログ アラート ルールの条件の一覧。 構築するには、CONDITIONAL時プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。 構築するには、CONDITION プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。
型: | IAlertRuleAnyOfOrLeafCondition[] |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。
型: | PSObject |
Aliases: | AzureRMContext, AzureCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Description
このアクティビティ ログ アラート ルールの説明。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Enabled
このアクティビティ ログ アラート ルールが有効かどうかを示します。 アクティビティ ログ アラート ルールが有効になっていない場合、そのアクションはアクティブになりません。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Location
リソースの場所。 Azure アクティビティ ログ アラートはグローバル サービスであるため、ルールの場所は常に "グローバル" にする必要があります。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Name
アクティビティ ログ アラート ルールの名前。
型: | String |
Aliases: | ActivityLogAlertName |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ResourceGroupName
リソース グループの名前。 名前の大文字と小文字は区別されます。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Scope
プレフィックスとして使用されるリソース ID の一覧。 アラートは、これらのプレフィックスのいずれかに該当するリソース ID を持つアクティビティ ログ イベントにのみ適用されます。 このリストには、少なくとも 1 つの項目が含まれている必要があります。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SubscriptionId
ターゲット サブスクリプションの ID。
型: | String |
配置: | Named |
規定値: | (Get-AzContext).Subscription.Id |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Tag
リソースのタグ。
型: | Hashtable |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |