Partager via

Remove-AzureRmResourceGroup

  • Référence
Module:
AzureRM.Resources

Supprime un groupe de ressources.

Avertissement

Le module AzureRM PowerShell a été officiellement déprécié 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.

Il est possible que le module AzureRM fonctionne encore, mais il ne fait plus l’objet de maintenance ni de support. L’utilisateur peut continuer à s’en servir s’il le souhaite, à ses propres risques. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.

Syntaxe

Remove-AzureRmResourceGroup
      [-Name] <String>
      [-Force]
      [-AsJob]
      [-ApiVersion <String>]
      [-Pre]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureRmResourceGroup
      [-Id] <String>
      [-Force]
      [-AsJob]
      [-ApiVersion <String>]
      [-Pre]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

L’applet de commande Remove-AzureRmResourceGroup supprime un groupe de ressources Azure et ses ressources de l’abonnement actuel. Pour supprimer une ressource, mais laissez le groupe de ressources, utilisez l’applet de commande Remove-AzureRmResource.

Exemples

Exemple 1 : Supprimer un groupe de ressources

PS C:\>Remove-AzureRmResourceGroup -Name "ContosoRG01"

Cette commande supprime le groupe de ressources ContosoRG01 de l’abonnement. L’applet de commande vous invite à confirmer et ne retourne aucune sortie.

Exemple 2 : Supprimer un groupe de ressources sans confirmation

PS C:\>Get-AzureRmResourceGroup -Name "ContosoRG01" | Remove-AzureRmResourceGroup -Verbose -Force

Cette commande utilise l’applet de commande Get-AzureRmResourceGroup pour obtenir le groupe de ressources ContosoRG01, puis la transmet à Remove-AzureRmResourceGroup à l’aide de l’opérateur de pipeline. Le paramètre courant détaillé obtient des informations d’état sur l’opération et le paramètre Force supprime l’invite de confirmation.

Exemple 3 : Supprimer tous les groupes de ressources

PS C:\>Get-AzureRmResourceGroup | Remove-AzureRmResourceGroup

Cette commande utilise l’applet de commande Get-AzureRmResourceGroup pour obtenir tous les groupes de ressources, puis les transmet à Remove-AzureRmResourceGroup à l’aide de l’opérateur de pipeline.

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

-AsJob

Exécuter l’applet de commande en arrière-plan

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

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
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

-Force

Force l’exécution de la commande sans demander la confirmation de l’utilisateur.

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

-Id

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

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

-Name

Spécifie les noms des groupes de ressources à supprimer. Les caractères génériques ne sont pas autorisés.

Type:String
Alias:ResourceGroupName
Position:0
Valeur par défaut:None
Obligatoire:True
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

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False