Set-AzConsumptionBudget

Modul:

Az.Billing

Perbarui anggaran dalam langganan atau grup sumber daya.

Sintaks

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

Deskripsi

Cmdlet Set-AzConsumptionBudget memperbarui anggaran dalam langganan atau grup sumber daya.

Contoh

Contoh 1: Memperbarui anggaran dengan jumlah baru dengan nama anggaran di tingkat langganan

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

Contoh 2: Memperbarui anggaran dengan pemberitahuan saat biaya atau penggunaan mencapai ambang batas 90 persen dari jumlah di tingkat langganan

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

Contoh 3: Memperbarui anggaran dengan jumlah baru dengan nama anggaran di tingkat grup sumber daya

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

Parameter

-Amount

Jumlah anggaran.

Jenis:	Nullable<T>[Decimal]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Category

Kategori anggaran dapat berupa biaya atau penggunaan.

Jenis:	String
Nilai yang diterima:	Cost, Usage
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

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

-ContactEmail

Alamat email untuk mengirim pemberitahuan anggaran ke saat ambang batas terlampaui.

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

-ContactGroup

Grup tindakan untuk mengirim pemberitahuan anggaran ke saat ambang batas terlampaui.

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

-ContactRole

Peran kontak untuk mengirim pemberitahuan anggaran ke saat ambang batas terlampaui.

Jenis:	String[]
Nilai yang diterima:	Owner, Reader, Contributor
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan Azure.

Jenis:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-EndDate

Tanggal selesai (YYYY-MM-DD dalam UTC) periode waktu anggaran.

Jenis:	Nullable<T>[DateTime]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-InputObject

Objek anggaran.

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

-MeterFilter

Daftar meter yang dipisahkan koma untuk difilter. Diperlukan jika kategori adalah penggunaan.

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

-Name

Nama anggaran.

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

-NotificationEnabled

Pemberitahuan diaktifkan. Jika tidak ditentukan, pemberitahuan dinonaktifkan secara default.

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

-NotificationKey

Kunci pemberitahuan yang terkait dengan anggaran, diperlukan untuk membuat pemberitahuan dengan sakelar yang diaktifkan pemberitahuan, ambang pemberitahuan, email kontak, grup kontak, atau peran kontak.

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

-NotificationThreshold

Nilai ambang yang terkait dengan pemberitahuan. Pemberitahuan dikirim ketika biaya atau penggunaan melebihi ambang batas. Selalu persen dan harus antara 0 dan 1000.

Jenis:	Nullable<T>[Decimal]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-ResourceFilter

Daftar instans sumber daya yang dipisahkan koma untuk difilter.

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

-ResourceGroupFilter

Daftar grup sumber daya yang dipisahkan koma untuk difilter.

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

-ResourceGroupName

Grup Sumber Daya anggaran.

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

-StartDate

Tanggal mulai (YYYY-MM-DD dalam UTC) periode waktu anggaran. Tidak sebelum bulan ini untuk butir waktu bulanan. Tidak sebelum tiga bulan untuk biji-bijian waktu triwulanan. Tidak sebelum dua belas bulan untuk biji-bijian waktu tahunan. Tanggal mulai di masa mendatang tidak lebih dari tiga bulan.

Jenis:	Nullable<T>[DateTime]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-TimeGrain

Butir waktu anggaran dapat menjadi bulanan, triwulanan, atau tahunan.

Jenis:	String
Nilai yang diterima:	Monthly, Quarterly, Annually
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

Input

PSBudget

Output

PSBudget

Catatan

• Saat ini, PowerShell SDK for Consumption hanya tersedia untuk Perjanjian Enterprise pelanggan.
• PowerShell SDK for Consumption menggunakan versi API Anggaran yang lebih lama dan beberapa item yang tidak kompatibel ke belakang seperti mencantumkan Anggaran dengan filter tidak akan berfungsi seperti yang diharapkan.