Set-AzConsumptionBudget
Обновите бюджет в подписке или группе ресурсов.
Синтаксис
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>]
Описание
Командлет Set-AzConsumption Budget обновляет бюджет в подписке или группе ресурсов.
Примеры
Пример 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
Сумма бюджета.
Тип: | Nullable<T>[Decimal] |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Category
Категория бюджета может быть затратами или использованием.
Тип: | String |
Допустимые значения: | Cost, Usage |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Confirm
Запрашивает подтверждение перед запуском cmdlet.
Тип: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ContactEmail
Адреса электронной почты для отправки уведомления о бюджете в момент превышения порогового значения.
Тип: | String[] |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ContactGroup
Группы действий для отправки уведомления о бюджете в момент превышения порогового значения.
Тип: | String[] |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ContactRole
Чтобы отправить уведомление о бюджете, обратитесь к ролям, чтобы отправить уведомление о превышении порогового значения.
Тип: | String[] |
Допустимые значения: | Owner, Reader, Contributor |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-DefaultProfile
Учетные данные, учетная запись, клиент и подписка, используемые для взаимодействия с Azure.
Тип: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-EndDate
Дата окончания (ГГГГ-ММ-ДД в формате UTC) периода времени бюджета.
Тип: | Nullable<T>[DateTime] |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-InputObject
Бюджетный объект.
Тип: | PSBudget |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-MeterFilter
Разделенный запятыми список метров для фильтрации. Требуется, если категория используется.
Тип: | String[] |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Name
Имя бюджета.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-NotificationEnabled
Уведомление включено. Если уведомление не указано, уведомление отключено по умолчанию.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-NotificationKey
Ключ уведомления, связанного с бюджетом, необходимый для создания уведомления с включенным переключателем, порогом уведомлений, адресами электронной почты, контактными группами или ролями контактов.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-NotificationThreshold
Пороговое значение, связанное с уведомлением. Уведомление отправляется при превышении порогового значения затрат или использования. Это всегда процент и должно быть от 0 до 1000.
Тип: | Nullable<T>[Decimal] |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ResourceFilter
Разделенный запятыми список экземпляров ресурсов для фильтрации.
Тип: | String[] |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ResourceGroupFilter
Разделенный запятыми список групп ресурсов для фильтрации.
Тип: | String[] |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ResourceGroupName
Группа ресурсов бюджета.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-StartDate
Дата начала (ГГГГ-ММ-ДД в формате UTC) периода времени бюджета. Не до текущего месяца для ежемесячного зерна. Не до трех месяцев для ежеквартально зерна. Не до двенадцати месяцев для ежегодного зерна. Дата начала будущего не более трех месяцев.
Тип: | Nullable<T>[DateTime] |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-TimeGrain
Время бюджета может быть ежемесячно, ежеквартально или ежегодно.
Тип: | String |
Допустимые значения: | Monthly, Quarterly, Annually |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.
Тип: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Входные данные
Выходные данные
Примечания
- В настоящее время пакет SDK PowerShell для потребления доступен только для Соглашение Enterprise клиентов.
- Пакет SDK PowerShell для потребления использует более старую версию API бюджетов и несколько не совместимых элементов, таких как перечисление бюджетов с фильтрами, не будет работать должным образом.