Partager via

Get-AzureRmResourceGroupDeployment

  • Référence
Module:
AzureRM.Resources

Obtient les déploiements dans un groupe 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.

Syntaxe

Get-AzureRmResourceGroupDeployment
   [-ResourceGroupName] <String>
   [[-Name] <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmResourceGroupDeployment
   -Id <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

L’applet de commande Get-AzureRmResourceGroupDeployment obtient les déploiements dans un groupe de ressources Azure. Spécifiez le paramètre Name ou Id pour filtrer les résultats. Par défaut, Get-AzureRmResourceGroupDeployment obtient tous les déploiements pour un groupe de ressources spécifié. Une ressource Azure est une entité Azure gérée par l’utilisateur, telle qu’un serveur de base de données, une base de données ou un site web. Un groupe de ressources Azure est une collection de ressources Azure déployées en tant qu’unité. Un déploiement est l’opération qui rend les ressources dans le groupe de ressources disponibles pour une utilisation. Pour plus d’informations sur les ressources Azure et les groupes de ressources Azure, consultez l’applet de commande New-AzureRmResourceGroup. Vous pouvez utiliser cette applet de commande pour le suivi. Pour le débogage, utilisez cette applet de commande avec l’applet de commande Get-AzureRmLog.

Exemples

Exemple 1 : Obtenir tous les déploiements d’un groupe de ressources

PS C:\>Get-AzureRmResourceGroupDeployment -ResourceGroupName "ContosoLabsRG"

Cette commande obtient tous les déploiements pour le groupe de ressources ContosoLabsRG. La sortie affiche un déploiement pour un blog WordPress qui a utilisé un modèle de galerie.

Exemple 2 : Obtenir un déploiement par nom

PS C:\>Get-AzureRmResourceGroupDeployment -ResourceGroupName "ContosoLabsRG" -Name "DeployWebsite01"

Cette commande obtient le déploiement DeployWebsite01 du groupe de ressources ContosoLabsRG. Vous pouvez attribuer un nom à un déploiement lorsque vous le créez à l’aide des applets de commande New-AzureRmResourceGroup ou New-AzureRmResourceGroupDeployment . Si vous n’attribuez pas de nom, les applets de commande fournissent un nom par défaut basé sur le modèle utilisé pour créer le déploiement.

Exemple 3 : Obtenir les déploiements de tous les groupes de ressources

PS C:\>Get-AzureRmResourceGroup | Get-AzureRmResourceGroupDeployment | Format-Table ResourceGroupName, DeploymentName, ProvisioningState

Cette commande obtient tous les groupes de ressources de votre abonnement à l’aide de l’applet de commande Get-AzureRmResourceGroup. La commande transmet les groupes de ressources à l’applet de commande actuelle à l’aide de l’opérateur de pipeline. L’applet de commande actuelle obtient tous les déploiements de tous les groupes de ressources de l’abonnement et transmet les résultats à l’applet de commande Format-Table pour afficher leurs valeurs de propriété ResourceGroupName, DeploymentName et ProvisioningState.

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: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 déploiement du groupe de ressources à obtenir.

Type:String
Alias:DeploymentId, ResourceId
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifie le nom du déploiement à obtenir. Les caractères génériques ne sont pas autorisés.

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

-ResourceGroupName

Spécifie le nom d’un groupe de ressources. L’applet de commande obtient les déploiements pour le groupe de ressources spécifié par ce paramètre. Les caractères génériques ne sont pas autorisés. Ce paramètre est obligatoire et vous ne pouvez spécifier qu’un seul groupe de ressources dans chaque commande.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

Entrées

None

Sorties

Microsoft.Azure.Commands.ResourceManagement.Models. PSResourceGroupDeployment