Get-AzResourceGroup

  • Référence
Module:
Az.Resources

Récupère le groupes de ressources.

Syntax

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

Description

L’applet de commande Get-AzResourceGroup 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-AzResourceGroup.

Exemples

Exemple 1 : Obtenir un groupe de ressources par nom

Get-AzResourceGroup -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

(Get-AzResourceGroup -Name "ContosoRG").Tags

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

Exemple 3 : Obtenir des groupes de ressources en fonction d’une balise

Get-AzResourceGroup -Tag @{'environment'='prod'}

Exemple 4 : Afficher les groupes de ressources par emplacement

Get-AzResourceGroup |
  Sort-Object Location,ResourceGroupName |
    Format-Table -GroupBy Location ResourceGroupName,ProvisioningState,Tags

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

Get-AzResourceGroup -Location westus2 |
  Sort-Object ResourceGroupName |
    Format-Wide ResourceGroupName -Column 4

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

Get-AzResourceGroup -Name 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
Default value:None
Required: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:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required: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
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Location

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

Type:String
Position:1
Default value:None
Required: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:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-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
Default value:None
Required: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
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Entrées

String

Hashtable

Sorties

PSResourceGroup