Bagikan melalui

New-AzScheduledQueryRule

  • Referensi
Modul:
Az.Monitor

Membuat atau memperbarui aturan kueri terjadwal.

Sintaks

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

Deskripsi

Membuat atau memperbarui aturan kueri terjadwal.

Contoh

Contoh 1: Membuat aturan kueri terjadwal

$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

Membuat aturan kueri terjadwal

Parameter

-ActionCustomProperty

Properti payload pemberitahuan.

Jenis:Hashtable
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ActionGroupResourceId

Id sumber daya Grup Tindakan untuk dipanggil saat pemberitahuan diaktifkan.

Jenis:String[]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-AutoMitigate

Bendera yang menunjukkan apakah pemberitahuan harus diselesaikan secara otomatis atau tidak. Defaultnya adalah true. Hanya relevan untuk aturan jenis LogAlert.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-CheckWorkspaceAlertsStorageConfigured

Bendera yang menunjukkan apakah aturan kueri terjadwal ini harus disimpan di penyimpanan pelanggan. Defaultnya adalah false. Hanya relevan untuk aturan jenis LogAlert.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

Jenis:SwitchParameter
Alias:cf
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-CriterionAllOf

Daftar kondisi untuk dievaluasi terhadap cakupan yang ditentukan Untuk membangun, lihat bagian CATATAN untuk properti CRITERIONALLOF dan membuat tabel hash.

Jenis:ICondition[]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-DefaultProfile

Parameter DefaultProfile tidak berfungsi. Gunakan parameter SubscriptionId saat tersedia jika menjalankan cmdlet terhadap langganan yang berbeda.

Jenis:PSObject
Alias:AzureRMContext, AzureCredential
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Description

Deskripsi aturan kueri terjadwal.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-DisplayName

Nama tampilan aturan pemberitahuan

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Enabled

Bendera yang menunjukkan apakah aturan kueri terjadwal ini diaktifkan. Nilai harus benar atau salah

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-EvaluationFrequency

Seberapa sering aturan kueri terjadwal dievaluasi diwakili dalam format durasi ISO 8601. Relevan dan diperlukan hanya untuk aturan jenis LogAlert.

Jenis:TimeSpan
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Kind

Menunjukkan jenis aturan kueri terjadwal. Defaultnya adalah LogAlert.

Jenis:Kind
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Location

Lokasi geografis tempat sumber daya berada

Jenis:String
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-MuteActionsDuration

Matikan suara tindakan untuk periode waktu yang dipilih (dalam format durasi ISO 8601) setelah pemberitahuan diaktifkan. Hanya relevan untuk aturan jenis LogAlert.

Jenis:TimeSpan
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Name

Nama aturan.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-OverrideQueryTimeRange

Jika ditentukan, maka ambil alih rentang waktu kueri (defaultnya adalah WindowSize*NumberOfEvaluationPeriods). Hanya relevan untuk aturan jenis LogAlert.

Jenis:TimeSpan
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ResourceGroupName

Nama grup sumber daya. Nama ini tidak peka huruf besar/kecil.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-Scope

Daftar id sumber daya yang dilingkup oleh aturan kueri terjadwal ini.

Jenis:String[]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Severity

Tingkat keparahan pemberitahuan. Harus berupa bilangan bulat antara [0-4]. Nilai 0 paling parah. Relevan dan diperlukan hanya untuk aturan jenis LogAlert.

Jenis:Int64
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-SkipQueryValidation

Bendera yang menunjukkan apakah kueri yang disediakan harus divalidasi atau tidak. Defaultnya adalah false. Hanya relevan untuk aturan jenis LogAlert.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-SubscriptionId

ID langganan target.

Jenis:String
Position:Named
Nilai default:(Get-AzContext).Subscription.Id
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Tag

Tag sumber daya.

Jenis:Hashtable
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-TargetResourceType

Daftar jenis sumber daya sumber daya target tempat pemberitahuan dibuat/diperbarui. Misalnya jika cakupannya adalah grup sumber daya dan targetResourceTypes adalah Microsoft.Compute/virtualMachines, maka pemberitahuan yang berbeda akan diaktifkan untuk setiap komputer virtual dalam grup sumber daya yang memenuhi kriteria pemberitahuan. Hanya relevan untuk aturan jenis LogAlert

Jenis:String[]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Jenis:SwitchParameter
Alias:wi
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-WindowSize

Periode waktu (dalam format durasi ISO 8601) tempat kueri Pemberitahuan akan dijalankan (ukuran bin). Relevan dan diperlukan hanya untuk aturan jenis LogAlert.

Jenis:TimeSpan
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Output