Add-AzMetricAlertRule
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
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]]
Uitvoerwaarden
PSAddAlertRuleOperationResponse