Partager via

Get-AzResourceGroup

  • Référence
Module:
Az.Resources

Récupère le groupes de ressources.

Syntaxe

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
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:AzContext, 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:1
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:0
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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
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

String

Hashtable

Sorties

PSResourceGroup