New-AzActivityLogAlert

  • リファレンス
モジュール:
Az.Monitor

新しいアクティビティ ログ アラート ルールを作成するか、既存のアクティビティ ログ アラート ルールを更新します。

構文

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

出力

IActivityLogAlertResource