Partager via

Get-AzResourceGroup

Module:
Az.Resources Module

Obtient des groupes de ressources.

Syntaxe

GetByResourceGroupName (Par défaut) 

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

GetByResourceGroupId 

Get-AzResourceGroup
    [[-Location] <String>]
    [-Id <String>]
    [-ExpandProperties]
    [-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*

Exemple 7 : Obtenir un groupe de ressources avec des propriétés développées

Get-AzResourceGroup -Name "ContosoRG" -ExpandProperties

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.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DefaultProfile

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

Propriétés du paramètre

Type:IAzureContextContainer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ExpandProperties

Quand elle est spécifiée, la sortie inclut CreatedTime et ChangedTime d’une ressource.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Id

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:ResourceGroupId, ResourceId

Jeux de paramètres

GetByResourceGroupId
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Location

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:1
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:True
DontShow:False
Alias:ResourceGroupName

Jeux de paramètres

GetByResourceGroupName
Position:0
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Tag

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

Propriétés du paramètre

Type:Hashtable
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

GetByResourceGroupName
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

String

Hashtable

Sorties

PSResourceGroup