Dela via

New-AzScheduledQueryRule

  • Referens
Modul:
Az.Monitor

Skapar eller uppdaterar en schemalagd frågeregel.

Syntax

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

Skapar eller uppdaterar en schemalagd frågeregel.

Exempel

Exempel 1: Skapa schemalagd frågeregel

$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

Skapa schemalagd frågeregel

Parametrar

-ActionCustomProperty

Egenskaperna för en aviseringsnyttolast.

Typ:Hashtable
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ActionGroupResourceId

Resurs-ID för åtgärdsgrupp som ska anropas när aviseringen utlöses.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-AutoMitigate

Flaggan som anger om aviseringen ska matchas automatiskt eller inte. Standardvärdet är sant. Relevant endast för regler av typen LogAlert.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-CheckWorkspaceAlertsStorageConfigured

Flaggan som anger om den här schemalagda frågeregeln ska lagras i kundens lagring. Standardvärdet är falskt. Relevant endast för regler av typen LogAlert.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-CriterionAllOf

En lista över villkor som ska utvärderas mot de angivna omfången För att skapa, se AVSNITTET ANTECKNINGAR för CRITERIONALLOF-egenskaper och skapa en hash-tabell.

Typ:ICondition[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

Parametern DefaultProfile fungerar inte. Använd parametern SubscriptionId när den är tillgänglig om du kör cmdleten mot en annan prenumeration.

Typ:PSObject
Alias:AzureRMContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Description

Beskrivningen av den schemalagda frågeregeln.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DisplayName

Visningsnamnet för aviseringsregeln

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Enabled

Flaggan som anger om den här schemalagda frågeregeln är aktiverad. Värdet ska vara sant eller falskt

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-EvaluationFrequency

Hur ofta den schemalagda frågeregeln utvärderas representeras i ISO 8601-varaktighetsformat. Relevant och krävs endast för regler av typen LogAlert.

Typ:TimeSpan
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Kind

Anger typen av schemalagd frågeregel. Standardvärdet är LogAlert.

Typ:Kind
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Location

Den geo-plats där resursen finns

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-MuteActionsDuration

Stäng av åtgärder för den valda tidsperioden (i ISO 8601-varaktighetsformat) efter att aviseringen har utlösts. Relevant endast för regler av typen LogAlert.

Typ:TimeSpan
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Name

Namnet på regeln.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-OverrideQueryTimeRange

Om det anges åsidosätter det frågetidsintervallet (standardvärdet är WindowSize*NumberOfEvaluationPeriods). Relevant endast för regler av typen LogAlert.

Typ:TimeSpan
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ResourceGroupName

Namnet på resursgruppen. Namnet är skiftlägesokänsligt.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Scope

Listan över resurs-ID:t som den här schemalagda frågeregeln är begränsad till.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Severity

Allvarlighetsgrad för aviseringen. Bör vara ett heltal mellan [0–4]. Värdet 0 är allvarligast. Relevant och krävs endast för regler av typen LogAlert.

Typ:Int64
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SkipQueryValidation

Flaggan som anger om den angivna frågan ska verifieras eller inte. Standardvärdet är falskt. Relevant endast för regler av typen LogAlert.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SubscriptionId

ID för målprenumerationen.

Typ:String
Position:Named
Standardvärde:(Get-AzContext).Subscription.Id
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Tag

Resurstaggar.

Typ:Hashtable
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TargetResourceType

Lista över resurstypen för de målresurser där aviseringen skapas/uppdateras. Om omfånget till exempel är en resursgrupp och targetResourceTypes är Microsoft.Compute/virtualMachines utlöses en annan avisering för varje virtuell dator i resursgruppen som uppfyller aviseringsvillkoren. Endast relevant för regler av typen LogAlert

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WindowSize

Tidsperioden (i ISO 8601-varaktighetsformat) som aviseringsfrågan ska köras på (intervallstorlek). Relevant och krävs endast för regler av typen LogAlert.

Typ:TimeSpan
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Utdata

IScheduledQueryRuleResource