Compartilhar via


New-AzQuota

Crie o limite de cota para o recurso especificado com o valor solicitado. Para atualizar a cota, siga estas etapas:\n1. Use a operação GET para cotas e usos para determinar a quantidade de cota restante para o recurso específico e calcular o novo limite de cota. Estas etapas são detalhadas este exemplo.\n2. Use esta operação PUT para atualizar o limite de cota. Verifique o URI no cabeçalho do local para obter o status detalhado da solicitação.

Sintaxe

New-AzQuota
   -ResourceName <String>
   -Scope <String>
   [-Limit <ILimitJsonObject>]
   [-Name <String>]
   [-ResourceType <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzQuota
   -ResourceName <String>
   -Scope <String>
   -JsonString <String>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzQuota
   -ResourceName <String>
   -Scope <String>
   -JsonFilePath <String>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzQuota
   -InputObject <IQuotaIdentity>
   [-Limit <ILimitJsonObject>]
   [-Name <String>]
   [-ResourceType <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Crie o limite de cota para o recurso especificado com o valor solicitado. Para atualizar a cota, siga estas etapas:\n1. Use a operação GET para cotas e usos para determinar a quantidade de cota restante para o recurso específico e calcular o novo limite de cota. Estas etapas são detalhadas este exemplo.\n2. Use esta operação PUT para atualizar o limite de cota. Verifique o URI no cabeçalho do local para obter o status detalhado da solicitação.

Exemplos

Exemplo 1: Criar ou atualizar o limite de cota para o recurso especificado com o valor solicitado

$quota = Get-AzQuota -Scope "subscriptions/{subId}/providers/Microsoft.Network/locations/eastus2" -ResourceName "PublicIPAddresses"
$limit = New-AzQuotaLimitObject -Value ($quota.Limit.Value + 1)
New-AzQuota -Scope "subscriptions/{subId}/providers/Microsoft.Network/locations/eastus2" -ResourceName "PublicIPAddresses" -Name "PublicIPAddresses" -Limit $limit

Name              NameLocalizedValue  Unit  ETag
----              ------------------  ----  ----
PublicIPAddresses Public IP Addresses Count

Esse comando cria ou atualiza o limite de cota para o recurso especificado com o valor solicitado.

Parâmetros

-AsJob

Executar o comando como um trabalho

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultProfile

O parâmetro DefaultProfile não está funcional. Use o parâmetro SubscriptionId quando disponível se estiver executando o cmdlet em uma assinatura diferente.

Tipo:PSObject
Aliases:AzureRMContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Parâmetro de identidade

Tipo:IQuotaIdentity
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-JsonFilePath

Caminho do arquivo Json fornecido para a operação Create

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-JsonString

Cadeia de caracteres Json fornecida para a operação Create

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Limit

Propriedades de limite de cota de recursos.

Tipo:ILimitJsonObject
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Nome do recurso.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-NoWait

Execute o comando de forma assíncrona

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ResourceName

Nome do recurso para um determinado provedor de recursos. Por exemplo:

  • Nome do SKU para Microsoft.Compute
  • SKU ou TotalLowPriorityCores para Microsoft.MachineLearningServices para Microsoft.Network PublicIPAddresses.
Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ResourceType

O nome do tipo de recurso. Campo opcional.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Scope

O URI de recurso do Azure de destino. Por exemplo, /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/qms-test/providers/Microsoft.Batch/batchAccounts/testAccount/. Esse é o URI de recurso do Azure de destino para a operação List GET. Se a {resourceName} for adicionado após /quotas, será o URI de recurso do Azure de destino na operação GET para o recurso específico.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

IQuotaIdentity

Saídas

ICurrentQuotaLimitBase