Freigeben über


New-AzResourceGroup

Erstellt eine Azure-Ressourcengruppe.

Syntax

New-AzResourceGroup
   [-Name] <String>
   [-Location] <String>
   [-Tag <Hashtable>]
   [-Force]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-AzResourceGroup erstellt eine Azure-Ressourcengruppe. Sie können eine Ressourcengruppe erstellen, indem Sie nur einen Namen und einen Speicherort verwenden und dann das Cmdlet New-AzResource verwenden, um Ressourcen zum Hinzufügen zur Ressourcengruppe zu erstellen. Verwenden Sie das Cmdlet New-AzResourceGroupDeployment, um einer vorhandenen Ressourcengruppe eine Bereitstellung hinzuzufügen. Verwenden Sie das Cmdlet New-AzResource , um einer vorhandenen Ressourcengruppe eine Ressource hinzuzufügen. Eine Azure-Ressource ist eine vom Benutzer verwaltete Azure-Entität, z. B. ein Datenbankserver, eine Datenbank oder eine Website. Eine Azure-Ressourcengruppe ist eine Sammlung von Azure-Ressourcen, die als Einheit bereitgestellt werden.

Beispiele

Beispiel 1: Erstellen einer leeren Ressourcengruppe

New-AzResourceGroup -Name RG01 -Location "South Central US"

Dieser Befehl erstellt eine Ressourcengruppe ohne Ressourcen. Sie können die Cmdlets New-AzResource oder New-AzResourceGroupDeployment verwenden, um dieser Ressourcengruppe Ressourcen und Bereitstellungen hinzuzufügen.

Beispiel 2: Erstellen einer leeren Ressourcengruppe mithilfe von Positionsparametern

New-AzResourceGroup RG01 "South Central US"

Dieser Befehl erstellt eine Ressourcengruppe ohne Ressourcen.

Beispiel 3: Erstellen einer Ressourcengruppe mit Tags

New-AzResourceGroup -Name RG01 -Location "South Central US" -Tag @{Empty=$null; Department="Marketing"}

Mit diesem Befehl wird eine leere Ressourcengruppe erstellt. Dieser Befehl ist identisch mit dem Befehl in Beispiel 1, mit der Ausnahme, dass er der Ressourcengruppe Tags zuweist. Das erste Tag namens "Leer" kann verwendet werden, um Ressourcengruppen zu identifizieren, die keine Ressourcen haben. Das zweite Tag heißt "Abteilung" und hat den Wert "Marketing". Sie können ein Tag wie diese verwenden, um Ressourcengruppen für die Verwaltung oder Budgetierung zu kategorisieren.

Parameter

-ApiVersion

Gibt die API-Version an, die vom Ressourcenanbieter unterstützt wird. Sie können eine andere Version als die Standardversion angeben.

Typ:String
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:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Force

Erzwingt die Ausführung des Befehls ohne Aufforderung zur Bestätigung durch den Benutzer.

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

-Location

Gibt den Speicherort der Ressourcengruppe an. Geben Sie einen Azure-Rechenzentrumsstandort an, z. B. „USA, Westen“ oder „Asien, Südosten“. Sie können eine Ressourcengruppe an einem beliebigen Ort platzieren. Die Ressourcengruppe muss sich nicht an demselben Speicherort wie Ihr Azure-Abonnement oder an demselben Speicherort wie ihre Ressourcen befinden. Verwenden Sie das Cmdlet "Get-AzResourceProvider" mit dem Parameter "ProviderNamespace ", um zu ermitteln, welcher Speicherort jeden Ressourcentyp unterstützt.

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

-Name

Gibt einen Namen für die Ressourcengruppe an. Der Ressourcenname muss im Abonnement eindeutig sein. Wenn bereits eine Ressourcengruppe mit diesem Namen vorhanden ist, werden Sie von den Befehlen zur Bestätigung aufgefordert, bevor Sie die vorhandene Ressourcengruppe ersetzen.

Typ:String
Aliase:ResourceGroupName
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Pre

Gibt an, dass dieses Cmdlet vorab veröffentlichte API-Versionen berücksichtigt, wenn es automatisch bestimmt, welche Version verwendet werden soll.

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

-Tag

Schlüssel-Wert-Paare in Form einer Hashtabelle. Beispiel: @{key0="value0"; key1=$null; key2="value2"} Um ein Tag hinzuzufügen oder zu ändern, müssen Sie die Sammlung von Tags für die Ressourcengruppe ersetzen. Nachdem Sie Ressourcen und Gruppen Tags zugewiesen haben, können Sie den Tag-Parameter von "Get-AzResource" und "Get-AzResourceGroup" verwenden, um nach Ressourcen und Gruppen nach Tagnamen oder nach Namen und Wert zu suchen. Sie können Kategorien verwenden, um Ihre Ressourcen zu kategorisieren, z. B. nach Abteilung oder Kostenstelle, oder um Notizen oder Kommentare zu den Ressourcen nachzuverfolgen. Verwenden Sie das Cmdlet "Get-AzTag", um Ihre vordefinierten Tags abzurufen.

Typ:Hashtable
Aliase:Tags
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
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:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

String

Hashtable

Ausgaben

PSResourceGroup