Sdílet prostřednictvím


Add-AzMetricAlertRule

Přidá nebo aktualizuje klasické pravidlo upozornění na základě metrik (už je vyřaděno ve veřejném cloudu). Pokud chcete vytvořit nové pravidlo upozornění na metriku, použijte rutinu Add-AzMetricAlertRuleV2 .

Syntax

Default (Výchozí)

Add-AzMetricAlertRule
    -WindowSize <TimeSpan>
    -Operator <ConditionOperator>
    -Threshold <Double>
    -TargetResourceId <String>
    -MetricName <String>
    -TimeAggregationOperator <TimeAggregationOperator>
    -Location <String>
    [-Description <String>]
    [-DisableRule]
    -ResourceGroupName <String>
    -Name <String>
    [-Action <System.Collections.Generic.List`1[Microsoft.Azure.Management.Monitor.Management.Models.RuleAction]>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Rutina Add-AzMetricAlertRule přidá nebo aktualizuje pravidlo upozornění na základě metrik. Přidané pravidlo je přidružené ke skupině prostředků a má název. Tato rutina implementuje model ShouldProcess, tj. může před vytvořením, úpravou nebo odebráním prostředku požádat uživatele o potvrzení.

Příklady

Příklad 1: Přidání pravidla upozornění na metriku na web

Add-AzMetricAlertRule -Name "metricRule5" -Location "East US" -ResourceGroup "Default-Web-EastUS" -Operator GreaterThan -Threshold 2 -WindowSize 00:05:00 -MetricName "Requests" -Description "Pura Vida" -TimeAggregationOperator Total
RequestId                                                                                                    StatusCode
---------                                                                                                    ----------
33574ccf-0b01-43b4-aa97-87e6bbcf1c11                                                                         Created

Tento příkaz vytvoří pravidlo upozornění na metriku pro web.

Příklad 2: Zakázání pravidla

Add-AzMetricAlertRule -Name "metricRule5" -Location "East US" -ResourceGroup Default-Web-EastUS -Operator GreaterThan -Threshold 2 -WindowSize 00:05:00 -MetricName "Requests" -TimeAggregationOperator Total
RequestId                                                                                                    StatusCode
---------                                                                                                    ----------
96c489f1-8529-46e1-a76d-2c1463ca3116                                                                                 OK

Tento příkaz zakáže pravidlo. Pokud pravidlo neexistuje, vytvoří ho zakázáno. Pokud pravidlo existuje, jednoduše ho zakáže.

Příklad 3: Přidání pravidla s akcemi

Add-AzMetricAlertRule -Name "metricRule5" -Location "East US" -ResourceGroup "Default-Web-EastUS" -Operator GreaterThan -Threshold 1 -TargetResourceId "/subscriptions/b93fb07a-6f93-30be-bf3e-4f0deca15f4f/resourceGroups/Default-Web-EastUS/providers/microsoft.web/sites/mywebsite" -MetricName "Requests" -TimeAggregationOperator Total
RequestId                                                                                                    StatusCode
---------                                                                                                    ----------
9a5bc388-c7ac-4dc6-aa70-f4bc29c2c712                                                                                 OK

Tento příkaz vytvoří pravidlo upozornění na metriku pro web.

Parametry

-Action

Určuje čárkami oddělený seznam akcí.

Vlastnosti parametru

Typ:

List<T>[RuleAction]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Confirm

Před spuštěním cmdletu vás vyzve k potvrzení.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:viz

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure

Vlastnosti parametru

Typ:IAzureContextContainer
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Description

Určuje popis pravidla.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-DisableRule

Zakáže pravidlo. Pokud tento parametr nezadáte, pravidlo se povolí.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Location

Určuje umístění, kde je pravidlo definováno.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-MetricName

Určuje název metriky, která pravidlo monitoruje. Tento parametr zadejte pouze pro pravidla založená na metrikách.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Name

Určuje název pravidla.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Operator

Určuje relační operátor pro podmínku pravidla. Přijatelné hodnoty pro tento parametr jsou:

  • GreaterThan
  • GreaterThanOrEqual
  • LessThan
  • LessThanOrEqual

Vlastnosti parametru

Typ:ConditionOperator
Default value:None
Přípustné hodnoty:GreaterThan, GreaterThanOrEqual, LessThan, LessThanOrEqual
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-ResourceGroupName

Určuje název skupiny prostředků pravidla.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:ResourceGroup

Sady parametrů

(All)
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-TargetResourceId

Určuje ID prostředku, který pravidlo monitoruje. POZNÁMKA: Tuto vlastnost nelze aktualizovat pro existující pravidlo upozornění.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Threshold

Určuje prahovou hodnotu pravidla.

Vlastnosti parametru

Typ:Double
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-TimeAggregationOperator

Určuje operátor agregace, který se má použít v časovém intervalu při vyhodnocování pravidla.

Vlastnosti parametru

Typ:

Nullable<T>[TimeAggregationOperator]

Default value:None
Přípustné hodnoty:Average, Minimum, Maximum, Total, Last
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Wi

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-WindowSize

Určuje velikost časového intervalu pro pravidlo pro výpočet dat.

Vlastnosti parametru

Typ:TimeSpan
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

TimeSpan

ConditionOperator

Double

String

Nullable<T>

SwitchParameter

List<T>

Výstupy

PSAddAlertRuleOperationResponse