New-AzConsumptionBudget

Referência

Módulo:: Az.Billing

Crie um orçamento em uma assinatura ou em um grupo de recursos.

Sintaxe

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

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

Description

O cmdlet New-AzConsumptionBudget cria um orçamento em uma assinatura ou em um grupo de recursos.

Exemplos

Exemplo 1: Criar um orçamento de custo com um nome de orçamento ao nível da subscrição

New-AzConsumptionBudget -Amount 60 -Name PSBudget -Category Cost -StartDate 2018-06-01 -EndDate 2018-11-01 -TimeGrain Monthly

Amount:  60		
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

Exemplo 2: Criar um orçamento de custo com um nome de orçamento no nível do grupo de recursos

New-AzConsumptionBudget -ResourceGroupName RGBudgets -Amount 60 -Name PSBudgetRG -Category Cost -StartDate 2018-06-01 -EndDate 2018-11-01 -TimeGrain Monthly

Amount:  60		
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

Parâmetros

-Amount

Valor de um orçamento.

Tipo:	Decimal
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Category

A categoria do orçamento pode ser custo ou uso.

Tipo:	String
Valores aceites:	Cost, Usage
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ContactEmail

Endereços de e-mail para enviar a notificação de orçamento quando o limite for excedido.

Tipo:	String[]
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ContactGroup

Grupos de ação para enviar a notificação de orçamento quando o limite for excedido.

Tipo:	String[]
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ContactRole

Funções de contato para enviar a notificação de orçamento quando o limite for excedido.

Tipo:	String[]
Valores aceites:	Owner, Reader, Contributor
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-EndDate

Data de fim (AAAA-MM-DD em UTC) do período de tempo de um orçamento.

Tipo:	Nullable<T>[DateTime]
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-MeterFilter

Lista de medidores separados por vírgulas para filtrar. Obrigatório se a categoria for uso.

Tipo:	String[]
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Name

Nome de um orçamento.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-NotificationEnabled

A notificação está habilitada ou não.

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-NotificationKey

Chave de uma notificação associada a um orçamento, necessária para criar uma notificação com opção de notificação habilitada, limite de notificação, e-mails de contato, grupos de contatos ou funções de contato.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-NotificationThreshold

Valor limite associado a uma notificação. A notificação é enviada quando o custo ou uso excedeu o limite. É sempre percentual e tem que estar entre 0 e 1000.

Tipo:	Nullable<T>[Decimal]
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ResourceFilter

Lista separada por vírgulas de instâncias de recursos para filtrar.

Tipo:	String[]
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ResourceGroupFilter

Lista separada por vírgulas de grupos de recursos para filtrar.

Tipo:	String[]
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ResourceGroupName

Grupo de Recursos de um orçamento.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-StartDate

Data de início (AAAA-MM-DD em UTC) do período de tempo de um orçamento. Não antes do mês atual para o grão de tempo mensal. Não antes de três meses para grãos trimestrais. Não antes de doze meses para o grão de tempo anual. Data de início futura não superior a três meses.

Tipo:	Nullable<T>[DateTime]
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-TimeGrain

O tempo do orçamento pode ser mensal, trimestral ou anual.

Tipo:	String
Valores aceites:	Monthly, Quarterly, Annually
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

Entradas

None

Saídas

PSBudget

Notas

Atualmente, o SDK do PowerShell para Consumo está disponível apenas para clientes do Enterprise Agreement.
O SDK do PowerShell para Consumo está usando uma versão mais antiga da API de Orçamentos e alguns itens não compatíveis com versões anteriores, como listar Orçamentos com filtros, não funcionarão conforme o esperado.

Partilhar via