Partager via

Remove-AzResourceGroup

  • Référence
Module:
Az.Resources

Supprime un groupe de ressources.

Syntaxe

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

Description

L’applet de commande Remove-AzResourceGroup 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-AzResource.

Exemples

Exemple 1 : Supprimer un groupe de ressources

Remove-AzResourceGroup -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

Get-AzResourceGroup -Name "ContosoRG01" | Remove-AzResourceGroup -Force

Cette commande utilise l’applet de commande Get-AzResourceGroup pour obtenir le groupe de ressources ContosoRG01, puis la transmet à Remove-AzResourceGroup à l’aide de l’opérateur de pipeline. Le paramètre Force supprime l’invite de confirmation.

Exemple 3 : Supprimer tous les groupes de ressources

Get-AzResourceGroup | Remove-AzResourceGroup

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

Exemple 4 : Supprimer des groupes de ressources utilisent ForceDeletionType

Remove-AzResourceGroup -Name "ContosoRG01" -ForceDeletionType "Microsoft.Compute/virtualMachineScaleSets,Microsoft.Compute/virtualMachines,Microsoft.Databricks/workspaces"

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

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: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

-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

-ForceDeletionType

Types de ressources que vous souhaitez forcer la suppression. Actuellement, seuls les éléments suivants sont pris en charge : forceDeletionTypes=Microsoft.Compute/virtualMachines,Microsoft.Compute/virtualMachineScaleSets

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

-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:Named
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

Entrées

String

Sorties

Boolean