Get-AzResource

Référence

Module:: Az.Resources

Obtient des ressources.

Syntax

Get-AzResource
   [-Name <String>]
   [-ResourceType <String>]
   [-ODataQuery <String>]
   [-ResourceGroupName <String>]
   [-TagName <String>]
   [-TagValue <String>]
   [-ExpandProperties]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzResource
   -ResourceId <String>
   [-ODataQuery <String>]
   [-ExpandProperties]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzResource
   [-Name <String>]
   [-ResourceType <String>]
   [-ODataQuery <String>]
   [-ResourceGroupName <String>]
   -Tag <Hashtable>
   [-ExpandProperties]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

L’applet de commande Get-AzResource obtient les ressources Azure.

Exemples

Exemple 1 : Obtenir toutes les ressources dans l’abonnement actuel

Get-AzResource | Format-Table

Name    ResourceGroupName  ResourceType                            Location
----    -----------------  ------------                            --------
testVM  testRG             Microsoft.Compute/virtualMachines       westus
disk    testRG             Microsoft.Compute/disks                 westus
nic     testRG             Microsoft.Network/networkInterfaces     westus
nsg     testRG             Microsoft.Network/networkSecurityGroups westus
ip      testRG             Microsoft.Network/publicIPAddresses     westus
vnet    testRG             Microsoft.Network/virtualNetworks       westus
testKV  otherRG            Microsoft.KeyVault/vaults               eastus
storage otherResourceGroup Microsoft.Storage/storageAccounts       eastus
testVM2 otherResourceGroup Microsoft.Compute/virtualMachines       eastus

Cette commande obtient toutes les ressources de l’abonnement actuel.

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

Get-AzResource -ResourceGroupName testRG | Format-Table

Name   ResourceGroupName ResourceType                            Location
----   ----------------- ------------                            --------
testVM testRG            Microsoft.Compute/virtualMachines       westus
disk   testRG            Microsoft.Compute/disks                 westus
nic    testRG            Microsoft.Network/networkInterfaces     westus
nsg    testRG            Microsoft.Network/networkSecurityGroups westus
ip     testRG            Microsoft.Network/publicIPAddresses     westus
vnet   testRG            Microsoft.Network/virtualNetworks       westus

Cette commande obtient toutes les ressources du groupe de ressources « testRG ».

Exemple 3 : Obtenir toutes les ressources dont le groupe de ressources correspond au caractère générique fourni carte

Get-AzResource -ResourceGroupName other* | Format-Table

Name    ResourceGroupName  ResourceType                      Location
----    -----------------  ------------                      --------
testKV  otherRG            Microsoft.KeyVault/vaults         eastus
storage otherResourceGroup Microsoft.Storage/storageAccounts eastus
testVM2 otherResourceGroup Microsoft.Compute/virtualMachines eastus

Cette commande obtient toutes les ressources dont le groupe de ressources appartient aux êtres avec « autre ».

Exemple 4 : Obtenir toutes les ressources avec un nom donné

Get-AzResource -Name testVM | Format-List

Name              : testVM
ResourceGroupName : testRG
ResourceType      : Microsoft.Compute/virtualMachines
Location          : westus
ResourceId        : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM
Tags              :
                    Name    Value
                    ======  ========
                    Dept    IT
                    Year    2002
                    Status  Approved

Cette commande obtient toutes les ressources dont le nom de ressource est « testVM ».

Exemple 5 : Obtenir toutes les ressources dont le nom correspond au caractère générique fourni carte

Get-AzResource -Name test* | Format-Table

Name    ResourceGroupName  ResourceType                      Location
----    -----------------  ------------                      --------
testVM  testRG             Microsoft.Compute/virtualMachines westus
testKV  otherRG            Microsoft.KeyVault/vaults         eastus
testVM2 otherResourceGroup Microsoft.Compute/virtualMachines eastus

Cette commande obtient toutes les ressources dont le nom de ressource commence par « test ».

Exemple 6 : Obtenir toutes les ressources d’un type de ressource donné

Get-AzResource -ResourceType Microsoft.Compute/virtualMachines | Format-Table

Name    ResourceGroupName  ResourceType                      Location
----    -----------------  ------------                      --------
testVM  testRG             Microsoft.Compute/virtualMachines westus
testVM2 otherResourceGroup Microsoft.Compute/virtualMachines eastus

Cette commande obtient toutes les ressources des abonnements actuels qui sont des machines virtuelles.

Exemple 7 : Obtenir une ressource par ID de ressource

Get-AzResource -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM

Name              : testVM
ResourceGroupName : testRG
ResourceType      : Microsoft.Compute/virtualMachines
Location          : westus
ResourceId        : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM
Tags              :
                    Name    Value
                    ======  ========
                    Dept    IT
                    Year    2002
                    Status  Approved

Cette commande obtient la ressource avec l’ID de ressource fourni, qui est une machine virtuelle appelée « testVM » dans le groupe de ressources « testRG ».

Paramètres

-ApiVersion

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

-ExpandProperties

Quand elle est spécifiée, développe les propriétés de la ressource.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Nom de la ou des ressources à récupérer. 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:	ResourceName
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

-ODataQuery

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Pre

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

Groupe de ressources auquel appartient la ou les ressources récupérées. 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
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

-ResourceId

Spécifie l’ID de ressource complet, comme dans l’exemple suivant /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.Compute/virtualMachines

Type:	String
Aliases:	Id
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ResourceType

Type de ressource de la ou des ressources à récupérer. Par exemple, Microsoft.Compute/virtualMachines

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Tag

Obtient les ressources qui ont la balise Azure spécifiée. Entrez une table de hachage avec une clé de nom ou des clés Nom et Valeur. Les caractères génériques carte ne sont pas pris en charge. Une « balise » est une paire nom-valeur que vous pouvez appliquer aux ressources et aux groupes de ressources. Utilisez des balises pour catégoriser vos ressources, telles que par service ou centre de coûts, ou pour suivre les notes ou les commentaires sur les ressources. Pour ajouter une balise à une ressource, utilisez le paramètre Tag des applets de commande New-AzResource ou Set-AzResource. Pour créer une balise prédéfinie, utilisez l’applet de commande New-AzTag. Pour obtenir de l’aide sur les tables de hachage dans Windows PowerShell, exécutez « Get-Help about_Hashtables ».

Type:	Hashtable
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-TagName

Clé dans la balise de la ou des ressources à récupérer.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TagValue

Valeur dans la balise de la ou des ressources à récupérer.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entrées

String

Sorties

PSResource

Get-AzResource

Syntax

Description

Exemples

Exemple 1 : Obtenir toutes les ressources dans l’abonnement actuel

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

Exemple 3 : Obtenir toutes les ressources dont le groupe de ressources correspond au caractère générique fourni carte

Exemple 4 : Obtenir toutes les ressources avec un nom donné

Exemple 5 : Obtenir toutes les ressources dont le nom correspond au caractère générique fourni carte

Exemple 6 : Obtenir toutes les ressources d’un type de ressource donné

Exemple 7 : Obtenir une ressource par ID de ressource

Paramètres

-ApiVersion

-DefaultProfile

-ExpandProperties

-Name

-ODataQuery

-Pre

-ResourceGroupName

-ResourceId

-ResourceType

-Tag

-TagName

-TagValue

Entrées

Sorties

Commentaires

Ressources supplémentaires

Get-AzResource

Syntax

Description

Exemples

Exemple 1 : Obtenir toutes les ressources dans l’abonnement actuel

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

Exemple 3 : Obtenir toutes les ressources dont le groupe de ressources correspond au caractère générique fourni carte

Exemple 4 : Obtenir toutes les ressources avec un nom donné

Exemple 5 : Obtenir toutes les ressources dont le nom correspond au caractère générique fourni carte

Exemple 6 : Obtenir toutes les ressources d’un type de ressource donné

Exemple 7 : Obtenir une ressource par ID de ressource

Paramètres

-ApiVersion

-DefaultProfile

-ExpandProperties

-Name

-ODataQuery

-Pre

-ResourceGroupName

-ResourceId

-ResourceType

-Tag

-TagName

-TagValue

Entrées

Sorties

Liens associés

Commentaires

Ressources supplémentaires