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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Erzwingt die Ausführung des Befehls ohne Aufforderung zur Bestätigung durch den Benutzer.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | String |
Aliases: | ResourceGroupName |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Pre
Gibt an, dass dieses Cmdlet vorab veröffentlichte API-Versionen berücksichtigt, wenn es automatisch bestimmt, welche Version verwendet werden soll.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Hashtable |
Aliases: | Tags |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
Ausgaben
Ähnliche Themen
Azure PowerShell
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für