Megosztás:

Add-AzMetricAlertRuleV2

Modul:
Az.Monitor Module

V2 (nem klasszikus) metrikaalapú riasztási szabályt ad hozzá vagy frissít.

Szintaxis

CreateAlertByResourceId (Alapértelmezett) 

Add-AzMetricAlertRuleV2
    -Name <String>
    -ResourceGroupName <String>
    -WindowSize <TimeSpan>
    -Frequency <TimeSpan>
    -TargetResourceId <String>
    -Condition <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Insights.OutputClasses.IPSMultiMetricCriteria]>
    -Severity <Int32>
    [-AutoMitigate <Boolean>]
    [-ActionGroup <ActivityLogAlertActionGroup[]>]
    [-ActionGroupId <String[]>]
    [-DisableRule]
    [-Description <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateAlertByScopes 

Add-AzMetricAlertRuleV2
    -Name <String>
    -ResourceGroupName <String>
    -WindowSize <TimeSpan>
    -Frequency <TimeSpan>
    -TargetResourceScope <String[]>
    -Condition <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Insights.OutputClasses.IPSMultiMetricCriteria]>
    -Severity <Int32>
    [-TargetResourceType <String>]
    [-TargetResourceRegion <String>]
    [-AutoMitigate <Boolean>]
    [-ActionGroup <ActivityLogAlertActionGroup[]>]
    [-ActionGroupId <String[]>]
    [-DisableRule]
    [-Description <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Leírás

V2 (nem klasszikus) metrikaalapú riasztási szabályt ad hozzá vagy frissít. A hozzáadott szabály egy erőforráscsoporthoz van társítva, és neve van. Ez a parancsmag implementálja a ShouldProcess mintát, azaz megerősítést kérhet a felhasználótól az erőforrás létrehozása, módosítása vagy eltávolítása előtt.

Példák

1. példa: Metrikariasztási szabály hozzáadása virtuális géphez

$act = [Microsoft.Azure.Management.Monitor.Management.Models.ActivityLogAlertActionGroup]::New("/subscriptions/00000000-0000-0000-0000-0000000/resourcegroups/default-activitylogalerts/providers/Microsoft.Insights/actiongroups/actionGroupDemo")
Add-AzMetricAlertRuleV2 -Name PS3182019 -ResourceGroupName xxxxRG -WindowSize 0:5 -Frequency 0:5 -TargetResourceScope "/subscriptions/00000000-0000-0000-0000-0000000/resourceGroups/012345/providers/Microsoft.Compute/virtualMachines/VM1", "/subscriptions/00000000-0000-0000-0000-0000000/resourceGroups/012345/providers/Microsoft.Compute/virtualMachines/VM2" -TargetResourceType "Microsoft.Compute/virtualMachines" -TargetResourceRegion "eastus" -Description "This is description" -Severity 4 -ActionGroup $act -Condition $condition

Description          : This is description
Severity             : 4
Enabled              : True
Scopes               : {/subscriptions/00000000-0000-0000-0000-0000000/resourceGroups/012345/providers/Microsoft.Compute/virtualMachines/VM1,
                       /subscriptions/00000000-0000-0000-0000-0000000/resourceGroups/012345/providers/Microsoft.Compute/virtualMachines/VM2}
EvaluationFrequency  : 00:05:00
WindowSize           : 00:05:00
TargetResourceType   : Microsoft.Compute/virtualMachines
TargetResourceRegion : eastus
Criteria             : Microsoft.Azure.Management.Monitor.Models.MetricAlertMultipleResourceMultipleMetricCriteria
AutoMitigate         :
Actions              : {/subscriptions/00000000-0000-0000-0000-0000000/resourcegroups/default-activitylogalerts/providers/Microsoft.Insights/actiongroups/demo}
LastUpdatedTime      :
Id                   : /subscriptions/00000000-0000-0000-0000-0000000/resourceGroups/xxxxRG/providers/Microsoft.Insights/metricAlerts/PS3182019
Name                 : PS3182019
Type                 : Microsoft.Insights/metricAlerts
Location             : global
Tags                 :

Ez a parancs létrehoz egy metrikariasztási szabályt egy virtuális géphez. $condition a New-AzMetricAlertRuleV2Criteria parancsmag kimenete

2. példa: Metrikariariasztási szabály hozzáadása az előfizetés összes virtuális gépéhez

$act = [Microsoft.Azure.Management.Monitor.Management.Models.ActivityLogAlertActionGroup]::New("/subscriptions/00000000-0000-0000-0000-0000000/resourcegroups/default-activitylogalerts/providers/Microsoft.Insights/actiongroups/actionGroupDemo")
Add-AzMetricAlertRuleV2 -Name AllVM -ResourceGroupName xxxxRG -WindowSize 0:5 -Frequency 0:5 -TargetResourceScope "/subscriptions/00000000-0000-0000-0000-0000000" -TargetResourceType "Microsoft.Compute/virtualMachines" -TargetResourceRegion "eastus" -Description "This is description" -Severity 4 -ActionGroup $act -Condition $condition

Description          : This is description
Severity             : 4
Enabled              : True
Scopes               : {/subscriptions/00000000-0000-0000-0000-0000000}
EvaluationFrequency  : 00:05:00
WindowSize           : 00:05:00
TargetResourceType   : Microsoft.Compute/virtualMachines
TargetResourceRegion : eastus
Criteria             : Microsoft.Azure.Management.Monitor.Models.MetricAlertMultipleResourceMultipleMetricCriteria
AutoMitigate         :
Actions              : {/subscriptions/00000000-0000-0000-0000-0000000/resourcegroups/default-activitylogalerts/providers/Microsoft.Insights/actiongroups/demo}
LastUpdatedTime      :
Id                   : /subscriptions/00000000-0000-0000-0000-0000000/resourceGroups/xxxxRG/providers/Microsoft.Insights/metricAlerts/AllVM
Name                 : AllVM
Type                 : Microsoft.Insights/metricAlerts
Location             : global
Tags                 :

Ez a parancs létrehoz egy metrikariasztási szabályt az előfizetésben lévő összes virtuális géphez, amely az Eastusban található

3. példa: Metrikariasztási szabály letiltása

Get-AzMetricAlertRuleV2 -ResourceGroupName alertstest  -Name TestAlertRule | Add-AzMetricAlertRuleV2 -DisableRule

Description          : This new Metric alert rule was created from Powershell version: 1.0.1
Severity             : 4
Enabled              : False
Scopes               : {/subscriptions/00000000-0000-0000-0000-0000000/resourceGroups/alertstest/providers/Microsoft.Insights/components/alertstestFunction}
EvaluationFrequency  : 00:05:00
WindowSize           : 00:05:00
TargetResourceType   :
TargetResourceRegion :
Criteria             : Microsoft.Azure.Management.Monitor.Models.MetricAlertSingleResourceMultipleMetricCriteria
AutoMitigate         :
Actions              : {/subscriptions/00000000-0000-0000-0000-0000000/resourcegroups/default-activitylogalerts/providers/Microsoft.Insights/actiongroups/demo1}
LastUpdatedTime      :
Id                   : /subscriptions/00000000-0000-0000-0000-0000000/resourceGroups/alertstest/providers/Microsoft.Insights/metricAlerts/TestAlertRule
Name                 : TestAlertRule
Type                 : Microsoft.Insights/metricAlerts
Location             : global
Tags                 :

Ez a parancs letiltja a metrikariasztási szabályt. Itt a Get-AzMetricAlertRuleV2 kimenetét az Add-AzMetricAlertRuleV2-be megyünk

4. példa: Metrikariasztási szabály hozzáadása dimenziókkal

$act = [Microsoft.Azure.Management.Monitor.Management.Models.ActivityLogAlertActionGroup]::New("/subscriptions/00000000-0000-0000-0000-0000000/resourcegroups/default-activitylogalerts/providers/Microsoft.Insights/actiongroups/actionGroupDemo")
$dim1 = New-AzMetricAlertRuleV2DimensionSelection -DimensionName "availabilityResult/name" -ValuesToInclude "gdtest"
$dim2 = New-AzMetricAlertRuleV2DimensionSelection -DimensionName "availabilityResult/location" -ValuesToInclude "*"
$criteria = New-AzMetricAlertRuleV2Criteria -MetricName "availabilityResults/availabilityPercentage" -DimensionSelection $dim1,$dim2 -TimeAggregation Average -Operator GreaterThan -Threshold 2
Add-AzMetricAlertRuleV2 -Name AlertWithDim -ResourceGroupName alertstest -WindowSize 00:05:00 -Frequency 00:05:00 -TargetResourceId "/subscriptions/00000000-0000-0000-0000-0000000/resourceGroups/alertstest/providers/Microsoft.Insights/components/alertstestFunction" -Condition $criteria -ActionGroup $act -DisableRule -Severity 4

Description          : This new Metric alert rule was created from Powershell version: 1.0.0
Severity             : 4
Enabled              : False
Scopes               : {/subscriptions/00000000-0000-0000-0000-0000000/resourceGroups/alertstest/providers/Microsoft.Insights/components/alertstestFunction}
EvaluationFrequency  : 00:05:00
WindowSize           : 00:05:00
TargetResourceType   :
TargetResourceRegion :
Criteria             : Microsoft.Azure.Management.Monitor.Models.MetricAlertSingleResourceMultipleMetricCriteria
AutoMitigate         :
Actions              : {/subscriptions/00000000-0000-0000-0000-0000000/resourcegroups/default-activitylogalerts/providers/Microsoft.Insights/actiongroups/actionGroupDemo}
LastUpdatedTime      :
Id                   : /subscriptions/00000000-0000-0000-0000-0000000/resourceGroups/alertstest/providers/Microsoft.Insights/metricAlerts/AlertWithDim
Name                 : AlertWithDim
Type                 : Microsoft.Insights/metricAlerts
Location             : global
Tags                 :

Ha összetettebb metrikariasztási szabályt szeretne létrehozni, például a dimenzióértékek kiválasztását vagy több feltételt tartalmazó szabály létrehozásához használja a New-AzMetricAlertRuleV2DimensionSelection és a New-AzMetricAlertRuleV2Criteria segédparancsmagokat.

A fenti parancsmagok metrikariasztási szabályt hoznak létre dimenziókkal.

Paraméterek

-ActionGroup

A szabály műveletcsoportja

Paramétertulajdonságok

Típus:

ActivityLogAlertActionGroup[]

Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False
Aliasok:Műveletek

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:False
Érték a csővezetékből:True
Érték a csővezetékből az ingatlan név szerint:True
Érték a maradék argumentumokból:False

-ActionGroupId

A szabály műveletcsoport-azonosítója

Paramétertulajdonságok

Típus:

String[]

Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:False
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:True
Érték a maradék argumentumokból:False

-AutoMitigate

Az a jelző, amely jelzi, hogy a riasztást automatikusan fel kell-e oldani vagy sem

Paramétertulajdonságok

Típus:Boolean
Alapértelmezett érték:True
Támogató vadkártyák:False
Don't Show:False

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:False
Érték a csővezetékből:True
Érték a csővezetékből az ingatlan név szerint:True
Érték a maradék argumentumokból:False

-Condition

A szabály feltétele

Paramétertulajdonságok

Típus:

List<T>[IPSMultiMetricCriteria]

Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False
Aliasok:Feltételek

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:True
Érték a csővezetékből:True
Érték a csővezetékből az ingatlan név szerint:True
Érték a maradék argumentumokból:False

-Confirm

Megerősítést kér a parancsmag futtatása előtt.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False
Aliasok:Cf

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:False
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:False
Érték a maradék argumentumokból:False

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.

Paramétertulajdonságok

Típus:IAzureContextContainer
Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False
Aliasok:AzContext, AzureRmContext, AzureCredential

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:False
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:False
Érték a maradék argumentumokból:False

-Description

A metrikariasztási szabály leírása

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:False
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:True
Érték a maradék argumentumokból:False

-DisableRule

A letiltó szabály (állapot) jelzője

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:False
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:True
Érték a maradék argumentumokból:False

-Frequency

A szabály kiértékelési gyakorisága

Paramétertulajdonságok

Típus:TimeSpan
Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False
Aliasok:EvaluationFrequency

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:True
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:True
Érték a maradék argumentumokból:False

-Name

A metrikariasztási szabály neve

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:True
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:True
Érték a maradék argumentumokból:False

-ResourceGroupName

Az erőforráscsoport neve

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False
Aliasok:ResourceGroup

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:True
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:True
Érték a maradék argumentumokból:False

-Severity

A metrikariasztási szabály súlyossága

Paramétertulajdonságok

Típus:Int32
Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:True
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:True
Érték a maradék argumentumokból:False

-TargetResourceId

A szabály célerőforrás-azonosítója

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False

Paraméterhalmazok

CreateAlertByResourceId
Pozíció:Named
Kötelező:True
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:True
Érték a maradék argumentumokból:False

-TargetResourceRegion

A szabály célerőforrás-régiója

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False

Paraméterhalmazok

CreateAlertByScopes
Pozíció:Named
Kötelező:False
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:True
Érték a maradék argumentumokból:False

-TargetResourceScope

A szabály célerőforrás-hatóköre

Paramétertulajdonságok

Típus:

String[]

Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False
Aliasok:Scopes

Paraméterhalmazok

CreateAlertByScopes
Pozíció:Named
Kötelező:True
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:True
Érték a maradék argumentumokból:False

-TargetResourceType

A szabály célerőforrás-típusa

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False

Paraméterhalmazok

CreateAlertByScopes
Pozíció:Named
Kötelező:False
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:True
Érték a maradék argumentumokból:False

-WhatIf

Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False
Aliasok:Wi

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:False
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:False
Érték a maradék argumentumokból:False

-WindowSize

A szabály ablakmérete

Paramétertulajdonságok

Típus:TimeSpan
Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False

Paraméterhalmazok

(All)
Pozíció:Named
Kötelező:True
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:True
Érték a maradék argumentumokból:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bemenetek

String

TimeSpan

String

List<T>

Microsoft.Azure.Management.Monitor.Models.ActivityLogAlertActionGroup

SwitchParameter

Int32

Kimenetek

PSMetricAlertRuleV2