Delen via


New-AzScheduledQueryRule

Hiermee maakt of werkt u een geplande queryregel bij.

Syntaxis

New-AzScheduledQueryRule
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   [-ActionCustomProperty <Hashtable>]
   [-ActionGroupResourceId <String[]>]
   [-AutoMitigate]
   [-CheckWorkspaceAlertsStorageConfigured]
   [-CriterionAllOf <ICondition[]>]
   [-Description <String>]
   [-DisplayName <String>]
   [-Enabled]
   [-EvaluationFrequency <TimeSpan>]
   [-Kind <Kind>]
   [-MuteActionsDuration <TimeSpan>]
   [-OverrideQueryTimeRange <TimeSpan>]
   [-Scope <String[]>]
   [-Severity <Int64>]
   [-SkipQueryValidation]
   [-Tag <Hashtable>]
   [-TargetResourceType <String[]>]
   [-WindowSize <TimeSpan>]
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Hiermee maakt of werkt u een geplande queryregel bij.

Voorbeelden

Voorbeeld 1: Een geplande queryregel maken

$subscriptionId=(Get-AzContext).Subscription.Id
$dimension = New-AzScheduledQueryRuleDimensionObject -Name Computer -Operator Include -Value *
$condition=New-AzScheduledQueryRuleConditionObject -Dimension $dimension -Query "Perf | where ObjectName == `"Processor`" and CounterName == `"% Processor Time`" | summarize AggregatedValue = avg(CounterValue) by bin(TimeGenerated, 5m), Computer" -TimeAggregation "Average" -MetricMeasureColumn "AggregatedValue" -Operator "GreaterThan" -Threshold "70" -FailingPeriodNumberOfEvaluationPeriod 1 -FailingPeriodMinFailingPeriodsToAlert 1
New-AzScheduledQueryRule -Name test-rule -ResourceGroupName test-group -Location eastus -DisplayName test-rule -Scope "/subscriptions/$subscriptionId/resourceGroups/test-group/providers/Microsoft.Compute/virtualMachines/test-vm" -Severity 4 -WindowSize ([System.TimeSpan]::New(0,10,0)) -EvaluationFrequency ([System.TimeSpan]::New(0,5,0)) -CriterionAllOf $condition

Geplande queryregel maken

Parameters

-ActionCustomProperty

De eigenschappen van een nettolading van een waarschuwing.

Type:Hashtable
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ActionGroupResourceId

Resource-id's van de actiegroep die moeten worden aangeroepen wanneer de waarschuwing wordt geactiveerd.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-AutoMitigate

De vlag die aangeeft of de waarschuwing automatisch moet worden opgelost of niet. De standaardwaarde is waar. Alleen relevant voor regels van het type LogAlert.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-CheckWorkspaceAlertsStorageConfigured

De vlag die aangeeft of deze geplande queryregel moet worden opgeslagen in de opslag van de klant. De standaardwaarde is onwaar. Alleen relevant voor regels van het type LogAlert.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

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

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-CriterionAllOf

Een lijst met voorwaarden die moeten worden geƫvalueerd op basis van de opgegeven bereiken Om te maken, raadpleegt u de sectie NOTES voor DE EIGENSCHAPPEN CRITERIAALLOF en maakt u een hash-tabel.

Type:ICondition[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De parameter DefaultProfile is niet functioneel. Gebruik de parameter SubscriptionId indien beschikbaar als u de cmdlet uitvoert voor een ander abonnement.

Type:PSObject
Aliassen:AzureRMContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Description

De beschrijving van de geplande queryregel.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DisplayName

De weergavenaam van de waarschuwingsregel

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Enabled

De vlag die aangeeft of deze geplande queryregel is ingeschakeld. Waarde moet waar of onwaar zijn

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-EvaluationFrequency

Hoe vaak de geplande queryregel wordt geƫvalueerd in iso 8601-duurnotatie. Relevant en alleen vereist voor regels van het soort LogAlert.

Type:TimeSpan
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Kind

Geeft het type geplande queryregel aan. De standaardwaarde is LogAlert.

Type:Kind
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Location

De geografische locatie waar de resource zich bevindt

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MuteActionsDuration

Demp acties voor de gekozen periode (in ISO 8601-duurnotatie) nadat de waarschuwing is geactiveerd. Alleen relevant voor regels van het type LogAlert.

Type:TimeSpan
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

De naam van de regel.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-OverrideQueryTimeRange

Als dit is opgegeven, wordt het tijdsbereik van de query overschreven (standaard is WindowSize*NumberOfEvaluationPeriods). Alleen relevant voor regels van het type LogAlert.

Type:TimeSpan
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ResourceGroupName

De naam van de resourcegroep. De naam is niet hoofdlettergevoelig.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Scope

De lijst met resource-id's waarop deze geplande queryregel is gericht.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Severity

Ernst van de waarschuwing. Moet een geheel getal tussen [0-4] zijn. De waarde van 0 is het zwaarst. Relevant en alleen vereist voor regels van het soort LogAlert.

Type:Int64
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SkipQueryValidation

De vlag die aangeeft of de opgegeven query moet worden gevalideerd of niet. De standaardwaarde is onwaar. Alleen relevant voor regels van het type LogAlert.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SubscriptionId

De id van het doelabonnement.

Type:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Tag

Resourcetags.

Type:Hashtable
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-TargetResourceType

Lijst met resourcetypen van de doelresource(s) waarop de waarschuwing wordt gemaakt/bijgewerkt. Als het bereik bijvoorbeeld een resourcegroep is en targetResourceTypes Microsoft.Compute/virtualMachines is, wordt een andere waarschuwing geactiveerd voor elke virtuele machine in de resourcegroep die voldoet aan de waarschuwingscriteria. Alleen relevant voor regels van het type LogAlert

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

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

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WindowSize

De periode (in ISO 8601-duurnotatie) waarop de waarschuwingsquery wordt uitgevoerd (bin-grootte). Relevant en alleen vereist voor regels van het soort LogAlert.

Type:TimeSpan
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Uitvoerwaarden

IScheduledQueryRuleResource