Partager via


Get-AzureRmResourceGroup

Récupère le groupes de ressources.

Avertissement

Le module AzureRM PowerShell a été officiellement déprécié le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.

Il est possible que le module AzureRM fonctionne encore, mais il ne fait plus l’objet de maintenance ni de support. L’utilisateur peut continuer à s’en servir s’il le souhaite, à ses propres risques. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.

Syntaxe

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>]

Description

L’applet de commande Get-AzureRmResourceGroup obtient des groupes de ressources Azure dans l’abonnement actuel. Vous pouvez obtenir tous les groupes de ressources ou spécifier un groupe de ressources par nom ou par d’autres propriétés. Par défaut, cette applet de commande obtient tous les groupes de ressources de l’abonnement actuel. Pour plus d’informations sur les ressources Azure et les groupes de ressources Azure, consultez l’applet de commande New-AzureRmResourceGroup.

Exemples

Exemple 1 : Obtenir un groupe de ressources par nom

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

Cette commande obtient le groupe de ressources Azure dans votre abonnement nommé EngineerBlog.

Exemple 2 : Obtenir toutes les balises d’un groupe de ressources

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

Cette commande obtient le groupe de ressources nommé ContosoRG et affiche les balises associées à ce groupe.

Exemple 3 : Afficher les groupes de ressources par emplacement

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

Exemple 4 : Afficher les noms de tous les groupes de ressources dans un emplacement particulier

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

Exemple 5 : Afficher les groupes de ressources dont les noms commencent par WebServer

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

Paramètres

-ApiVersion

Spécifie la version de l’API prise en charge par le fournisseur de ressources. Vous pouvez spécifier une version différente de la version par défaut.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure

Type:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Id

Spécifie l’ID du groupe de ressources à obtenir. Les caractères génériques ne sont pas autorisés.

Type:String
Alias:ResourceGroupId, ResourceId
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Location

Spécifie l’emplacement du groupe de ressources à obtenir.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Name

Spécifie le nom du groupe de ressources à obtenir. Ce paramètre prend en charge les caractères génériques au début et/ou à la fin de la chaîne.

Type:String
Alias:ResourceGroupName
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Pre

Indique que cette applet de commande prend en compte les versions d’API en préversion lorsqu’elle détermine automatiquement la version à utiliser.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Tag

Table de hachage de balise pour filtrer les groupes de ressources par.

Type:Hashtable
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

Entrées

None

Sorties

Microsoft.Azure.Commands.ResourceManagement.PSResourceGroup