Set-AzConsumptionBudget
更新訂用帳戶或資源群組中的預算。
Syntax
Set-AzConsumptionBudget
[-DefaultProfile <IAzureContextContainer>]
-Name <String>
[-Amount <Decimal>]
[-Category <String>]
[-TimeGrain <String>]
[-StartDate <DateTime>]
[-EndDate <DateTime>]
[-ResourceGroupName <String>]
[-MeterFilter <String[]>]
[-ResourceFilter <String[]>]
[-ResourceGroupFilter <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzConsumptionBudget
[-DefaultProfile <IAzureContextContainer>]
-Name <String>
[-Amount <Decimal>]
[-Category <String>]
[-TimeGrain <String>]
[-StartDate <DateTime>]
[-EndDate <DateTime>]
[-ResourceGroupName <String>]
[-MeterFilter <String[]>]
[-ResourceFilter <String[]>]
[-ResourceGroupFilter <String[]>]
-NotificationKey <String>
[-NotificationEnabled]
[-NotificationThreshold <Decimal>]
[-ContactEmail <String[]>]
[-ContactGroup <String[]>]
[-ContactRole <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzConsumptionBudget
[-DefaultProfile <IAzureContextContainer>]
-InputObject <PSBudget>
[-Amount <Decimal>]
[-Category <String>]
[-TimeGrain <String>]
[-StartDate <DateTime>]
[-EndDate <DateTime>]
[-MeterFilter <String[]>]
[-ResourceFilter <String[]>]
[-ResourceGroupFilter <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzConsumptionBudget
[-DefaultProfile <IAzureContextContainer>]
-InputObject <PSBudget>
[-Amount <Decimal>]
[-Category <String>]
[-TimeGrain <String>]
[-StartDate <DateTime>]
[-EndDate <DateTime>]
[-MeterFilter <String[]>]
[-ResourceFilter <String[]>]
[-ResourceGroupFilter <String[]>]
-NotificationKey <String>
[-NotificationEnabled]
[-NotificationThreshold <Decimal>]
[-ContactEmail <String[]>]
[-ContactGroup <String[]>]
[-ContactRole <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Set-AzConsumptionBudget Cmdlet 會更新訂用帳戶或資源群組中的預算。
範例
範例 1：以訂用帳戶層級預算名稱的新金額更新預算
Set-AzConsumptionBudget -Name PSBudget -Amount 75
Amount: 75
Category: Cost
CurrentSpend: null
Id: subscriptions/1caaa5a3-2b66-438e-8ab4-bce37d518c5d/providers/Microsoft.Consumption/budgets/PSBudget
Name: PSBudget
TimeGrain: Monthly
TimePeriod: EndDate: 11/1/2018 12:00:00 AM
StartDate: 6/1/2018 12:00:00 AM
Type: Microsoft.Consumption/budgets範例 2：當成本或使用量達到訂用帳戶層級 90% 金額的閾值時，以通知更新預算
Set-AzConsumptionBudget -Name PSBudget -NotificationKey notificationKey-ps1234 -NotificationEnabled -NotificationThreshold 90 -ContactEmail @('johndoe@contoso.com','janesmith@contoso.com') -ContactRole Owner,Reader,Contributor
Amount: 75
Category: Cost
CurrentSpend: null
Id: subscriptions/1caaa5a3-2b66-438e-8ab4-bce37d518c5d/providers/Microsoft.Consumption/budgets/PSBudget
Name: PSBudget
Notification: NotificationKey: notificationKey-ps1234
Threshold: 90
Enabled: true
ContactEmail: johndoe@contoso.com,janesmith@contoso.com
ContactRole: Owner,Reader,Contributor
TimeGrain: Monthly
TimePeriod: EndDate: 11/1/2018 12:00:00 AM
StartDate: 6/1/2018 12:00:00 AM
Type: Microsoft.Consumption/budgets範例 3：以資源群組層級預算名稱的新金額更新預算
Set-AzConsumptionBudget -ResourceGroupName RGBudgets -Name PSBudgetRG -Amount 75
Amount: 75
Category: Cost
CurrentSpend: null
Id: subscriptions/1caaa5a3-2b66-438e-8ab4-bce37d518c5d/resourceGroups/RGBudgets/providers/Microsoft.Consumption/budgets/PSBudgetRG
Name: PSBudgetRG
TimeGrain: Monthly
TimePeriod: EndDate: 11/1/2018 12:00:00 AM
StartDate: 6/1/2018 12:00:00 AM
Type: Microsoft.Consumption/budgets參數
-Amount
預算金額。
| Type: | Nullable<T>[Decimal] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Category
預算的類別可以是成本或使用量。
| Type: | String |
| Accepted values: | Cost, Usage |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
執行 Cmdlet 之前先提示您確認。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ContactEmail
超過臨界值時，要傳送預算通知的電子郵件位址。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ContactGroup
當超過臨界值時，要傳送預算通知的動作群組。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ContactRole
連絡角色，以在超過臨界值時將預算通知傳送至 。
| Type: | String[] |
| Accepted values: | Owner, Reader, Contributor |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EndDate
預算時段的結束日期（UTC 的YYYY-MM-DD）。
| Type: | Nullable<T>[DateTime] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Budget 物件。
| Type: | PSBudget |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-MeterFilter
要篩選的計量逗號分隔清單。 如果類別是使用量，則為必要專案。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
預算的名稱。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NotificationEnabled
通知已啟用。 如果未指定，預設會停用通知。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NotificationKey
與預算相關聯的通知索引鍵，建立已啟用通知的切換、通知閾值、聯繫人電子郵件、聯繫人群組或聯繫人角色所需的通知。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NotificationThreshold
與通知相關聯的臨界值。 當成本或使用量超過閾值時，就會傳送通知。 一律為百分比，且必須介於 0 到 1000 之間。
| Type: | Nullable<T>[Decimal] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ResourceFilter
要篩選的資源實例逗號分隔清單。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ResourceGroupFilter
要篩選的資源群組逗號分隔清單。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ResourceGroupName
預算的資源群組。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StartDate
預算時間週期的開始日期（UTC 為YYYY-MM-DD）。 每月時間粒紋不在當月之前。 在每季時間糧食的三個月之前沒有。 不是在每年的 12 個月時間糧食之前。 未來開始日期不超過三個月。
| Type: | Nullable<T>[DateTime] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TimeGrain
預算的時間粒紋可以是每月、每季或每年。
| Type: | String |
| Accepted values: | Monthly, Quarterly, Annually |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
輸入
輸出
備註
- 目前，PowerShell SDK for Consumption 僅適用於 Enterprise 合約 客戶。
- PowerShell SDK for Consumption 是使用舊版的 Budgets API，而很少有回溯不相容的專案，例如列出具有篩選條件的預算將無法如預期般運作。
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應