Freigeben über

New-AzResourceGroup

Modul:
Az.Resources Module

Erstellt eine Azure-Ressourcengruppe.

Syntax

Default (Standardwert) 

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 zu erstellen, die der Ressourcengruppe hinzugefügt werden. 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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DefaultProfile

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

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Force

Erzwingt die Ausführung des Befehls, ohne eine Benutzerbestätigung zu verlangen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Location

Gibt den Speicherort der Ressourcengruppe an. Geben Sie einen Azure-Rechenzentrumsstandort an, z. B. West-USA oder Südostasien. 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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:1
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Ressourcengruppenname

Parametersätze

(All)
Position:0
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Pre

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:Hashtable
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Stichwörter

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-WhatIf

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

String

Hashtable

Ausgaben

PSResourceGroup