Remove-AzResourceGroup

  • Référence
Module:
Az.Resources

Supprime un groupe de ressources.

Syntax

Remove-AzResourceGroup
      [-Name] <String>
      [-Force]
      [-AsJob]
      [-ApiVersion <String>]
      [-Pre]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzResourceGroup
      -Id <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.

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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AsJob

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

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

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
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

-Force

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

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

-Id

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

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

-Name

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

Type:String
Aliases:ResourceGroupName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

String

Sorties

Boolean