Add-AzMetricAlertRule

  • Referentie
Module:
Az.Monitor

Hiermee voegt u een op metrische gegevens gebaseerde waarschuwingsregel toe of werkt u deze bij (al buiten gebruik gesteld in de openbare cloud). Als u een nieuwe waarschuwingsregel voor metrische gegevens wilt maken, gebruikt u de cmdlet Add-AzMetricAlertRuleV2 .

Syntax

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

De cmdlet Add-AzMetricAlertRule voegt een waarschuwingsregel op basis van metrische gegevens toe of werkt deze bij. De toegevoegde regel is gekoppeld aan een resourcegroep en heeft een naam. Met deze cmdlet wordt het ShouldProcess-patroon geïmplementeerd, dat wil bijvoorbeeld dat de gebruiker om bevestiging wordt gevraagd voordat de resource daadwerkelijk wordt gemaakt, gewijzigd of verwijderd.

Voorbeelden

Voorbeeld 1: Een waarschuwingsregel voor metrische gegevens toevoegen aan een website

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

Met deze opdracht maakt u een waarschuwingsregel voor metrische gegevens voor een website.

Voorbeeld 2: Een regel uitschakelen

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

Met deze opdracht wordt een regel uitgeschakeld. Als de regel niet bestaat, wordt deze uitgeschakeld. Als de regel bestaat, wordt deze alleen uitgeschakeld.

Voorbeeld 3: Een regel toevoegen met acties

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

Met deze opdracht maakt u een waarschuwingsregel voor metrische gegevens voor een website.

Parameters

-Action

Hiermee geeft u een door komma's gescheiden lijst met acties op.

Type:List<T>[RuleAction]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Hiermee geeft u een beschrijving van de regel.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DisableRule

Hiermee schakelt u de regel uit. Als u deze parameter niet opgeeft, is de regel ingeschakeld.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Location

Hiermee geeft u de locatie op waar de regel is gedefinieerd.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-MetricName

Hiermee geeft u de naam op van de metrische waarde die door de regel wordt bewaakt. Geef deze parameter alleen op voor regels op basis van metrische gegevens.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Hiermee geeft u de naam van de regel.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Operator

Hiermee geeft u de relationele operator voor de voorwaarde van de regel. De aanvaardbare waarden voor deze parameter zijn:

  • GreaterThan
  • GreaterThanOrEqual
  • LessThan
  • LessThanOrEqual
Type:ConditionOperator
Accepted values:GreaterThan, GreaterThanOrEqual, LessThan, LessThanOrEqual
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Hiermee geeft u de naam van de resourcegroep voor de regel.

Type:String
Aliases:ResourceGroup
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TargetResourceId

Hiermee geeft u de id op van de resource die door de regel wordt bewaakt. OPMERKING: deze eigenschap kan niet worden bijgewerkt voor een bestaande waarschuwingsregel.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Threshold

Hiermee geeft u de drempelwaarde van de regel.

Type:Double
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TimeAggregationOperator

Hiermee geeft u de aggregatieoperator op die moet worden toegepast op het tijdvenster wanneer de regel wordt geëvalueerd.

Type:Nullable<T>[TimeAggregationOperator]
Accepted values:Average, Minimum, Maximum, Total, Last
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WindowSize

Hiermee geeft u de tijdvenstergrootte voor de regel om de gegevens te berekenen.

Type:TimeSpan
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Invoerwaarden

TimeSpan

ConditionOperator

Double

String

Nullable<T>[[Microsoft.Azure.Management.Monitor.Management.Models.TimeAggregationOperator, Microsoft.Azure.PowerShell.Cmdlets.Monitor, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]

SwitchParameter

List<T>[[Microsoft.Azure.Management.Monitor.Management.Models.RuleAction, Microsoft.Azure.PowerShell.Cmdlets.Monitor, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]

Uitvoerwaarden

PSAddAlertRuleOperationResponse