共用方式為


New-AzMetricAlertRuleV2Criteria

建立可用來建立新計量警示的本機準則物件

語法

New-AzMetricAlertRuleV2Criteria
   -MetricName <String>
   [-MetricNamespace <String>]
   [-SkipMetricValidation <Boolean>]
   [-DimensionSelection <PSMetricDimension[]>]
   -TimeAggregation <String>
   -Operator <String>
   -Threshold <Double>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzMetricAlertRuleV2Criteria
   [-DynamicThreshold]
   -MetricName <String>
   [-MetricNamespace <String>]
   [-SkipMetricValidation <Boolean>]
   [-DimensionSelection <PSMetricDimension[]>]
   -TimeAggregation <String>
   -Operator <String>
   [-ThresholdSensitivity <String>]
   [-ViolationCount <Int32>]
   [-ExaminedAggregatedPointCount <Int32>]
   [-IgnoreDataBefore <DateTime>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzMetricAlertRuleV2Criteria
   [-WebTest]
   -WebTestId <String>
   -ApplicationInsightsId <String>
   [-FailedLocationCount <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

New-AzMetricAlertRuleV2Criteria Cmdlet 會建立本機計量準則物件,以做為輸入 Add-AzMetricAlertRuleV2 Cmdlet 來建立新的計量警示規則。

範例

範例 1:建立簡單的計量警示準則

New-AzMetricAlertRuleV2Criteria -MetricName "Percentage CPU" -MetricNameSpace "Microsoft.Compute/virtualMachines" -TimeAggregation Average -Operator GreaterThan -Threshold 5

CriterionType        : StaticThresholdCriterion
OperatorProperty     : GreaterThan
Threshold            : 5
AdditionalProperties :
Name                 : metric1
MetricName           : Percentage CPU
MetricNamespace      : Microsoft.Compute/virtualMachines
TimeAggregation      : Average
Dimensions           :

此命令會建立可用於計量警示規則的簡單計量警示準則

範例 2:建立動態計量警示準則

New-AzMetricAlertRuleV2Criteria -DynamicThreshold -MetricName "Percentage CPU" -MetricNameSpace "Microsoft.Compute/virtualMachines" -TimeAggregation Average -Operator GreaterThan -ThresholdSensitivity Medium -ViolationCount 2 -ExaminedAggregatedPointCount 4

CriterionType        : DynamicThresholdCriterion
OperatorProperty     : GreaterThan
AlertSensitivity     : Medium
FailingPeriods       : Microsoft.Azure.Management.Monitor.Models.DynamicThresholdFailingPeriods
IgnoreDataBefore     :
AdditionalProperties :
Name                 : metric1
MetricName           : Percentage CPU
MetricNamespace      : Microsoft.Compute/virtualMachines
TimeAggregation      : Average
Dimensions           :

此命令會建立動態計量警示準則,可用於計量警示規則

範例 3:建立更複雜的計量警示準則

New-AzMetricAlertRuleV2DimensionSelection -DimensionName "availabilityResult/name" -ValuesToInclude "gdtest" | New-AzMetricAlertRuleV2Criteria -MetricName "availabilityResults/availabilityPercentage" -TimeAggregation Average -Operator GreaterThan -Threshold 2

CriterionType        : StaticThresholdCriterion
OperatorProperty     : GreaterThan
Threshold            : 2
AdditionalProperties :
Name                 : metric1
MetricName           : availabilityResults/availabilityPercentage
MetricNamespace      :
TimeAggregation      : Average
Dimensions           : {availabilityResult/name}

這組命令會建立更複雜的計量警示準則,其中包含維度選取

範例 4:建立 Webtest 可用性準則

New-AzMetricAlertRuleV2Criteria -WebTest -WebTestId "/subscriptions/00000000-0000-0000-0000-0000000/resourceGroups/012345/providers/Microsoft.Insights/webtests/PingTest-appInsights" -ApplicationInsightsId "/subscriptions/00000000-0000-0000-0000-0000000/resourceGroups/012345/providers/Microsoft.Insights/components/appInsights" -FailedLocationCount 3

CriterionType        : WebtestLocationAvailabilityCriterion
WebTestId            : /subscriptions/00000000-0000-0000-0000-0000000/resourceGroups/012345/providers/Microsoft.Insights/webtests/PingTest-appInsights
ComponentId          : /subscriptions/00000000-0000-0000-0000-0000000/resourceGroups/012345/providers/Microsoft.Insights/components/appInsights
FailedLocationCount  : 3
AdditionalProperties :

此命令會建立可在計量警示規則中使用的 Webtest 可用性準則

參數

-ApplicationInsightsId

Application Insights 資源標識符。

類型:String
別名:componentId
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:IAzureContextContainer
別名:AzContext, AzureRmContext, AzureCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-DimensionSelection

維度條件清單

類型:PSMetricDimension[]
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-DynamicThreshold

使用動態閾值類型的 Switch 參數

類型:SwitchParameter
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-ExaminedAggregatedPointCount

檢查點總數

類型:Int32
別名:TotalPeriod, NumberOfExaminedAggregatedPoints
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-FailedLocationCount

引發警示的失敗位置數目下限。

類型:Int32
別名:AlertLocationThreshold
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-IgnoreDataBefore

IgnoreDataBefore 參數

類型:DateTime
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-MetricName

規則的計量名稱

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-MetricNamespace

計量的命名空間

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Operator

規則條件運算元

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-SkipMetricValidation

允許在尚未發出的自定義計量上建立警示規則,方法是略過計量驗證

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Threshold

規則條件的臨界值

類型:Double
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-ThresholdSensitivity

規則條件的敏感度

類型:String
別名:Sensitivity
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-TimeAggregation

用來跨視窗間隔匯總多個計量值的匯總作業

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-ViolationCount

引發警示所需的所選回溯時間範圍內所需的違規次數下限

類型:Int32
別名:FailingPeriod, NumberOfViolations
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-WebTest

使用可用性準則類型的 Switch 參數

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-WebTestId

Application Insights Web 測試標識符。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

輸入

PSMetricDimension[]

輸出

IPSMultiMetricCriteria