New-AzScheduledQueryRule

模組:: Az.Monitor Module

建立排程查詢規則。

語法

CreateExpanded (預設值)

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

CreateViaJsonFilePath

New-AzScheduledQueryRule
    -Name <String>
    -ResourceGroupName <String>
    -JsonFilePath <String>
    [-SubscriptionId <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaJsonString

New-AzScheduledQueryRule
    -Name <String>
    -ResourceGroupName <String>
    -JsonString <String>
    [-SubscriptionId <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

建立排程查詢規則。

範例

範例 1：建立排程的查詢規則

$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

建立排程查詢規則

參數

-ActionCustomProperty

警示承載的屬性。

參數屬性

類型:	Hashtable
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateExpanded

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ActionGroupResourceId

動作群組資源標識碼，以在警示引發時叫用。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateExpanded

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-AutoMitigate

指出是否應該自動解決警示的旗標。默認值為 true。僅與 LogAlert 類型的規則相關。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateExpanded

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-CheckWorkspaceAlertsStorageConfigured

旗標，指出此排程的查詢規則是否應該儲存在客戶的記憶體中。默認值為 false。僅與 LogAlert 類型的規則相關。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateExpanded

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	參見

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-CriterionAllOf

要根據指定範圍評估的條件清單

參數屬性

類型:	ICondition[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateExpanded

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DefaultProfile

DefaultProfile 參數無法運作。如果針對不同的訂用帳戶執行 Cmdlet，請使用 SubscriptionId 參數。

參數屬性

類型:	PSObject
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	AzureRMContext, AzureCredential

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Description

排程查詢規則的描述。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateExpanded

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DisplayName

警示規則的顯示名稱

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateExpanded

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Enabled

指出是否啟用此排程查詢規則的旗標。值應該是 true 或 false

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateExpanded

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-EvaluationFrequency

以 ISO 8601 持續時間格式來評估排程查詢規則的頻率。只有 LogAlert 類型的規則才相關且必要。

參數屬性

類型:	TimeSpan
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateExpanded

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-JsonFilePath

提供給建立作業的 Json 檔案路徑

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateViaJsonFilePath

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-JsonString

提供給建立作業的 Json 字串

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateViaJsonString

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Kind

指出排程查詢規則的類型。預設值為LogAlert。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateExpanded

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Location

資源所在的地理位置

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateExpanded

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-MuteActionsDuration

在引發警示之後，將所選期間（ISO 8601 持續時間格式）的動作設為靜音。僅與 LogAlert 類型的規則相關。

參數屬性

類型:	TimeSpan
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateExpanded

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Name

規則的名稱。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-OverrideQueryTimeRange

如果指定，則會覆寫查詢時間範圍（預設值為 WindowSize*NumberOfEvaluationPeriods）。僅與 LogAlert 類型的規則相關。

參數屬性

類型:	TimeSpan
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateExpanded

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ResourceGroupName

資源群組的名稱。名稱不區分大小寫。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Scope

此排程查詢規則的範圍是資源標識碼的清單。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateExpanded

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Severity

警報的嚴重程度。應該是介於 [0-4] 之間的整數。值為 0 最嚴重。只有 LogAlert 類型的規則才相關且必要。

參數屬性

類型:	Int64
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateExpanded

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-SkipQueryValidation

指出是否應該驗證所提供查詢的旗標。默認值為 false。僅與 LogAlert 類型的規則相關。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateExpanded

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-SubscriptionId

目標訂用帳戶的標識碼。

參數屬性

類型:	String
預設值:	(Get-AzContext).Subscription.Id
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Tag

資源標籤。

參數屬性

類型:	Hashtable
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateExpanded

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-TargetResourceType

建立/更新警示之目標資源的資源類型清單。例如，如果範圍是資源群組，且 targetResourceTypes 是 Microsoft.Compute/virtualMachines，則會針對符合警示準則的資源群組中的每個虛擬機引發不同的警示。僅與 LogAlert 類型的規則相關

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateExpanded

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。指令未執行。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	威斯康辛

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-WindowSize

警示查詢將執行的時間週期（以 ISO 8601 持續時間格式表示）。只有 LogAlert 類型的規則才相關且必要。

參數屬性

類型:	TimeSpan
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateExpanded

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。如需詳細資訊，請參閱 about_CommonParameters。

輸出

IScheduledQueryRuleResource

意見反應

此頁面對您有幫助嗎？

共用方式為

New-AzScheduledQueryRule

語法

CreateExpanded (預設值)

CreateViaJsonFilePath

CreateViaJsonString

Description

範例

範例 1：建立排程的查詢規則

參數

-ActionCustomProperty

參數屬性

參數集

-ActionGroupResourceId

參數屬性

參數集

-AutoMitigate

參數屬性

參數集

-CheckWorkspaceAlertsStorageConfigured

參數屬性

參數集

-Confirm

參數屬性

參數集

-CriterionAllOf

參數屬性

參數集

-DefaultProfile

參數屬性

參數集

-Description

參數屬性

參數集

-DisplayName

參數屬性

參數集

-Enabled

參數屬性

參數集

-EvaluationFrequency

參數屬性

參數集

-JsonFilePath

參數屬性

參數集

-JsonString

參數屬性

參數集

-Kind

參數屬性

參數集

-Location

參數屬性

參數集

-MuteActionsDuration

參數屬性

參數集

-Name

參數屬性

參數集

-OverrideQueryTimeRange

參數屬性

參數集

-ResourceGroupName

參數屬性

參數集

-Scope

參數屬性

參數集

-Severity

參數屬性

參數集

-SkipQueryValidation

參數屬性

參數集

-SubscriptionId

參數屬性

參數集

-Tag