New-AzScheduledQueryRule

Sintassi

Default (Impostazione predefinita)

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>]

Descrizione

Esempio

Esempio 1: Creare una regola di query pianificata

$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

Parametri

-ActionCustomProperty

Proprietà di un payload di avviso.

Proprietà dei parametri

Set di parametri

-ActionGroupResourceId

ID risorsa gruppo di azioni da richiamare quando viene generato l'avviso.

Proprietà dei parametri

Set di parametri

-AutoMitigate

Flag che indica se l'avviso deve essere risolto automaticamente o meno. Il valore predefinito è vero. Rilevante solo per le regole del tipo LogAlert.

Proprietà dei parametri

Set di parametri

-CheckWorkspaceAlertsStorageConfigured

Flag che indica se questa regola di query pianificata deve essere archiviata nella risorsa di archiviazione del cliente. Il valore predefinito è false. Rilevante solo per le regole del tipo LogAlert.

Proprietà dei parametri

Set di parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Set di parametri

-CriterionAllOf

Elenco di condizioni da valutare rispetto agli ambiti specificati Da costruire, vedere la sezione NOTES per le proprietà CRITERIAALLOF e creare una tabella hash.

Proprietà dei parametri

Set di parametri

-DefaultProfile

Il parametro DefaultProfile non è funzionale. Usare il parametro SubscriptionId quando disponibile se si esegue il cmdlet su una sottoscrizione diversa.

Proprietà dei parametri

Set di parametri

-Description

Descrizione della regola di query pianificata.

Proprietà dei parametri

Set di parametri

-DisplayName

Nome visualizzato della regola di avviso

Proprietà dei parametri

Set di parametri

-Enabled

Flag che indica se questa regola di query pianificata è abilitata. Il valore deve essere true o false

Proprietà dei parametri

Set di parametri

-EvaluationFrequency

Frequenza con cui la regola di query pianificata viene valutata rappresentata nel formato di durata ISO 8601. Rilevante e obbligatorio solo per le regole di tipo LogAlert.

Proprietà dei parametri

Set di parametri

-Kind

Indica il tipo di regola di query pianificata. Il valore predefinito è LogAlert.

Proprietà dei parametri

Set di parametri

-Location

Posizione geografica in cui risiede la risorsa

Proprietà dei parametri

Set di parametri

-MuteActionsDuration

Disattivare le azioni per il periodo di tempo scelto (in formato di durata ISO 8601) dopo l'invio dell'avviso. Rilevante solo per le regole del tipo LogAlert.

Proprietà dei parametri

Set di parametri

-Name

Nome della regola.

Proprietà dei parametri

Set di parametri

-OverrideQueryTimeRange

Se specificato, esegue l'override dell'intervallo di tempo della query (il valore predefinito è WindowSize*NumberOfEvaluationPeriods). Rilevante solo per le regole del tipo LogAlert.

Proprietà dei parametri

Set di parametri

-ResourceGroupName

Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.

Proprietà dei parametri

Set di parametri

-Scope

L'elenco di ID risorsa a cui questa regola di query pianificata ha come ambito.

Proprietà dei parametri

Set di parametri

-Severity

Gravità dell'avviso. Deve essere un numero intero compreso tra [0-4]. Il valore 0 è più grave. Rilevante e obbligatorio solo per le regole di tipo LogAlert.

Proprietà dei parametri

Set di parametri

-SkipQueryValidation

Flag che indica se la query specificata deve essere convalidata o meno. Il valore predefinito è false. Rilevante solo per le regole del tipo LogAlert.

Proprietà dei parametri

Set di parametri

-SubscriptionId

ID della sottoscrizione di destinazione.

Proprietà dei parametri

Set di parametri

-Tag

Tag di risorsa.

Proprietà dei parametri

Set di parametri

-TargetResourceType

Elenco del tipo di risorsa delle risorse di destinazione in cui viene creato/aggiornato l'avviso. Ad esempio, se l'ambito è un gruppo di risorse e targetResourceTypes è Microsoft.Compute/virtualMachines, verrà generato un avviso diverso per ogni macchina virtuale nel gruppo di risorse che soddisfano i criteri di avviso. Rilevante solo per le regole del tipo LogAlert

Proprietà dei parametri

Set di parametri

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Proprietà dei parametri

Set di parametri

-WindowSize

Periodo di tempo (in formato di durata ISO 8601) in cui verrà eseguita la query di avviso (dimensioni bin). Rilevante e obbligatorio solo per le regole di tipo LogAlert.

Proprietà dei parametri

Set di parametri

CommonParameters

Output

IScheduledQueryRuleResource