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 |