Add-AzMetricAlertRule
Přidá nebo aktualizuje pravidlo upozornění na základě metriky.
Syntaxe
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
PS C:\>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
PS C:\>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
PS C:\>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í.
Typ: | List<T>[RuleAction] |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
Typ: | SwitchParameter |
Aliasy: | cf |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-DefaultProfile
Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure
Typ: | IAzureContextContainer |
Aliasy: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Description
Určuje popis pravidla.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-DisableRule
Zakáže pravidlo. Pokud tento parametr nezadáte, pravidlo se povolí.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-Location
Určuje umístění, kde je pravidlo definováno.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-MetricName
Určuje název metriky, která pravidlo monitoruje. Tento parametr zadejte pouze pro pravidla založená na metrikách.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-Name
Určuje název pravidla.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-Operator
Určuje relační operátor pro podmínku pravidla. Tento parametr přijímá tyto hodnoty:
- GreaterThan
- GreaterThanOrEqual
- LessThan
- LessThanOrEqual
Typ: | ConditionOperator |
Přípustné hodnoty: | GreaterThan, GreaterThanOrEqual, LessThan, LessThanOrEqual |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-ResourceGroupName
Určuje název skupiny prostředků pravidla.
Typ: | String |
Aliasy: | ResourceGroup |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-TargetResourceId
Určuje ID prostředku, který pravidlo monitoruje. POZNÁMKA: Tuto vlastnost nelze aktualizovat pro existující pravidlo upozornění.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-Threshold
Určuje prahovou hodnotu pravidla.
Typ: | Double |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-TimeAggregationOperator
Určuje operátor agregace, který se má použít v časovém intervalu při vyhodnocování pravidla.
Typ: | Nullable<T>[TimeAggregationOperator] |
Přípustné hodnoty: | Average, Minimum, Maximum, Total, Last |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.
Typ: | SwitchParameter |
Aliasy: | wi |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-WindowSize
Určuje velikost časového intervalu pro pravidlo pro výpočet dat.
Typ: | TimeSpan |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
Vstupy
Nullable<T>[[Microsoft.Azure.Management.Monitor.Management.Models.TimeAggregationOperator, Microsoft.Azure.PowerShell.Cmdlets.Monitor, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]
List<T>[[Microsoft.Azure.Management.Monitor.Management.Models.RuleAction, Microsoft.Azure.PowerShell.Cmdlets.Monitor, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]
Výstupy
PSAddAlertRuleOperationResponse