Freigeben über


New-AzQuota

Erstellen Sie den Kontingentgrenzwert für die angegebene Ressource mit dem angeforderten Wert. Führen Sie zum Aktualisieren des Kontingents die folgenden Schritte aus:\n1. Verwenden Sie den GET-Vorgang für Kontingente und Verwendungen, um zu bestimmen, wie viel Kontingent für die spezifische Ressource verbleibt und um den neuen Kontingentgrenzwert zu berechnen. Diese Schritte sind in diesem Beispiel beschrieben.\n2. Verwenden Sie diesen PUT-Vorgang, um den Kontingentgrenzwert zu aktualisieren. Überprüfen Sie den URI im Positionsheader auf den detaillierten Status der Anforderung.

Syntax

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

Beschreibung

Erstellen Sie den Kontingentgrenzwert für die angegebene Ressource mit dem angeforderten Wert. Führen Sie zum Aktualisieren des Kontingents die folgenden Schritte aus:\n1. Verwenden Sie den GET-Vorgang für Kontingente und Verwendungen, um zu bestimmen, wie viel Kontingent für die spezifische Ressource verbleibt und um den neuen Kontingentgrenzwert zu berechnen. Diese Schritte sind in diesem Beispiel beschrieben.\n2. Verwenden Sie diesen PUT-Vorgang, um den Kontingentgrenzwert zu aktualisieren. Überprüfen Sie den URI im Positionsheader auf den detaillierten Status der Anforderung.

Beispiele

Beispiel 1: Erstellen oder Aktualisieren des Kontingentlimits für die angegebene Ressource mit dem angeforderten Wert

$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

Mit diesem Befehl wird das Kontingentlimit für die angegebene Ressource mit dem angeforderten Wert erstellt oder aktualisiert.

Parameter

-AsJob

Ausführen des Befehls als Auftrag

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Der Parameter DefaultProfile ist nicht funktionsfähig. Verwenden Sie den Parameter "SubscriptionId", wenn sie verfügbar ist, wenn Sie das Cmdlet für ein anderes Abonnement ausführen.

Typ:PSObject
Aliase:AzureRMContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Identity-Parameter

Typ:IQuotaIdentity
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-JsonFilePath

Pfad der JSON-Datei, die für den Erstellungsvorgang bereitgestellt wird

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-JsonString

Json-Zeichenfolge, die für den Create-Vorgang bereitgestellt wird

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Limit

Ressourcenkontingentbeschränkungseigenschaften.

Typ:ILimitJsonObject
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Ressourcenname.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NoWait

Asynchrones Ausführen des Befehls

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ResourceName

Ressourcenname für einen bestimmten Ressourcenanbieter. Zum Beispiel:

  • SKU-Name für Microsoft.Compute
  • SKU oder TotalLowPriorityCores für Microsoft.MachineLearningServices für Microsoft.Network PublicIPAddresses.
Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ResourceType

Der Name des Ressourcentyps. Optionales Feld.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Scope

Der Ziel-Azure-Ressourcen-URI. Beispiel: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/qms-test/providers/Microsoft.Batch/batchAccounts/testAccount/. Dies ist der Ziel-Azure-Ressourcen-URI für den Listen-GET-Vorgang. Wenn ein {resourceName} Objekt nach /quotasdem Hinzufügen hinzugefügt wird, handelt es sich um den Azure-Zielressourcen-URI im GET-Vorgang für die bestimmte Ressource.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

IQuotaIdentity

Ausgaben

ICurrentQuotaLimitBase