Freigeben über

Set-AzureRmResourceGroup

  • Referenz
Modul:
AzureRM.Resources

Ändert eine Ressourcengruppe.

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul möglicherweise weiterhin funktioniert, wird es nicht mehr gewartet, und es wird kein Support mehr angeboten. Die weitere Nutzung erfolgt daher nach Ermessen und Risiko des Benutzers. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

Syntax

Set-AzureRmResourceGroup
   [-Name] <String>
   [-Tag] <Hashtable>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzureRmResourceGroup
   [-Tag] <Hashtable>
   [-Id] <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-AzureRmResourceGroup ändert die Eigenschaften einer Ressourcengruppe. Mit diesem Cmdlet können Sie die Azure-Tags hinzufügen, ändern oder löschen, die auf eine Ressourcengruppe angewendet wurden. Geben Sie den Parameter Name an, um die Ressourcengruppe und den Tag-Parameter zu identifizieren, um die Tags zu ändern. Sie können dieses Cmdlet nicht verwenden, um den Namen einer Ressourcengruppe zu ändern.

Beispiele

Beispiel 1: Anwenden eines Tags auf eine Ressourcengruppe

PS C:\>Set-AzureRmResourceGroup -Name "ContosoRG" -Tag @{Department="IT"}

Mit diesem Befehl wird ein Abteilungstag mit dem Wert "IT" auf eine Ressourcengruppe angewendet, die keine vorhandenen Tags enthält.

Beispiel 2: Hinzufügen von Tags zu einer Ressourcengruppe

PS C:\>$Tags = (Get-AzureRmResourceGroup -Name "ContosoRG").Tags
PS C:\> $Tags
PS C:\> $Tags += @{"Status"="Approved"; "FY2016"=$null}
PS C:\> Set-AzureRmResourceGroup -Name "ContosoRG" -Tag $Tags
PS C:> (Get-AzureRmResourceGroup -Name "ContosoRG").Tags

In diesem Beispiel wird ein Status-Tag mit dem Wert "Genehmigt" und einem FY2016-Tag zu einer Ressourcengruppe hinzugefügt, die über vorhandene Tags verfügt. Da die von Ihnen angegebenen Tags die vorhandenen Tags ersetzen, müssen Sie die vorhandenen Tags in die neue Tagauflistung einschließen oder sie verlieren. Der erste Befehl ruft die ContosoRG-Ressourcengruppe ab und verwendet die Dot-Methode, um den Wert der Tags-Eigenschaft abzurufen. Der Befehl speichert die Tags in der variablen $Tags. Der zweite Befehl ruft die Tags in der $Tags Variablen ab. Der dritte Befehl verwendet den += Zuordnungsoperator, um die Tags Status und FY2016 dem Array von Tags in der $Tags Variablen hinzuzufügen. Der vierte Befehl verwendet den Tag-Parameter von Set-AzureRmResourceGroup , um die Tags in der variablen $Tags auf die ContosoRG-Ressourcengruppe anzuwenden. Der fünfte Befehl ruft alle Tags ab, die auf die ContosoRG-Ressourcengruppe angewendet werden. Die Ausgabe zeigt, dass die Ressourcengruppe das Department-Tag und die beiden neuen Tags", "Status" und "FY2015", aufweist.

Beispiel 3: Löschen aller Tags für eine Ressourcengruppe

PS C:\>Set-AzureRmResourceGroup -Name "ContosoRG" -Tag @{}

Dieser Befehl gibt den Tag-Parameter mit einem leeren Hashtabellenwert an, um alle Tags aus der ContosoRG-Ressourcengruppe zu löschen.

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

-DefaultProfile

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

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

-Id

Gibt die ID der zu ändernden Ressourcengruppe an.

Typ:String
Aliase:ResourceGroupId, ResourceId
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen der zu ändernden Ressourcengruppe an.

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"} Ein Tag ist ein Name-Wert-Paar, das Sie erstellen und auf Ressourcen und Ressourcengruppen anwenden können. Nachdem Sie Ressourcen und Gruppen Tags zugewiesen haben, können Sie den Tag-Parameter von Get-AzureRmResource und Get-AzureRmResourceGroup verwenden, um nach Ressourcen und Gruppen nach Tagnamen oder 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. Um ein Tag hinzuzufügen oder zu ändern, müssen Sie die Sammlung von Tags für die Ressourcengruppe ersetzen. Um ein Tag zu löschen, geben Sie eine Hashtabelle mit allen Tags ein, die derzeit auf die Ressourcengruppe angewendet werden, aus "Get-AzureRmResourceGroup", mit Ausnahme des Tags, das Sie löschen möchten. Um alle Tags aus einer Ressourcengruppe zu löschen, geben Sie eine leere Hashtabelle an: @{}.

Typ:Hashtable
Aliase:Tags
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

Microsoft.Azure.Commands.Resources.Models.PSResourceGroup