Freigeben über

Get-AzureRmResourceGroup

  • Referenz
Modul:
AzureRM.Resources

Ruft Ressourcengruppen ab.

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

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

Beschreibung

Das Cmdlet "Get-AzureRmResourceGroup " ruft Azure-Ressourcengruppen im aktuellen Abonnement ab. Sie können alle Ressourcengruppen abrufen oder eine Ressourcengruppe anhand des Namens oder anderer Eigenschaften angeben. Standardmäßig ruft dieses Cmdlet alle Ressourcengruppen im aktuellen Abonnement ab. Weitere Informationen zu Azure-Ressourcen und Azure-Ressourcengruppen finden Sie im Cmdlet New-AzureRmResourceGroup.

Beispiele

Beispiel 1: Abrufen einer Ressourcengruppe anhand des Namens

PS C:\>Get-AzureRmResourceGroup -Name "EngineerBlog"

Dieser Befehl ruft die Azure-Ressourcengruppe in Ihrem Abonnement namens EngineerBlog ab.

Beispiel 2: Abrufen aller Tags einer Ressourcengruppe

PS C:\>(Get-AzureRmResourceGroup -Name "ContosoRG").Tags

Dieser Befehl ruft die Ressourcengruppe "ContosoRG" ab und zeigt die Tags an, die dieser Gruppe zugeordnet sind.

Beispiel 3: Anzeigen der Ressourcengruppen nach Standort

PS C:\> Get-AzureRmResourceGroup |
  Sort Location,ResourceGroupName |
  Format-Table -GroupBy Location ResourceGroupName,ProvisioningState,Tags

Beispiel 4: Anzeigen der Namen aller Ressourcengruppen an einem bestimmten Speicherort

PS C:\> Get-AzureRmResourceGroup -Location westus2 |
   Sort ResourceGroupName | 
   Format-Wide ResourceGroupName -Column 4

Beispiel 5: Anzeigen der Ressourcengruppen, deren Namen mit "WebServer" beginnen

PS C:\> Get-AzureRmResourceGroup | Where ResourceGroupName -like WebServer*

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 abzurufenden Ressourcengruppe an. Platzhalterzeichen sind nicht zulässig.

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

-Location

Gibt den Speicherort der abzurufenden Ressourcengruppe an.

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

-Name

Gibt den Namen der abzurufenden Ressourcengruppe an. Dieser Parameter unterstützt Wildcards am Anfang und/oder Ende der Zeichenfolge.

Typ:String
Aliase:ResourceGroupName
Position:Named
Standardwert:None
Erforderlich:False
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

Die Taghashtable zum Filtern von Ressourcengruppen nach.

Typ:Hashtable
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

Microsoft.Azure.Commands.ResourceManagement.PSResourceGroup