Partager via


Get-AzureRmResourceGroup

Récupère le groupes de ressources.

Avertissement

Le module AzureRM PowerShell a été officiellement déconseillé depuis 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.

Bien que le module AzureRM puisse toujours fonctionner, il n’est plus conservé ou pris en charge, plaçant toute utilisation continue à la discrétion et au risque de l’utilisateur. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.

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

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
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

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

Type:String
Aliases:ResourceGroupId, ResourceId
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:True
Accept wildcard characters:False

-Location

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

Type:String
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String
Aliases:ResourceGroupName
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:True
Accept wildcard characters: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
Accept pipeline input:False
Accept wildcard characters: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
Accept pipeline input:True
Accept wildcard characters:False

Entrées

None

Sorties

Microsoft.Azure.Commands.ResourceManagement.PSResourceGroup