Partager via

Remove-AzResourceGroup

Module:
Az.Resources Module

Supprime un groupe de ressources.

Syntaxe

RemoveByResourceGroupName (Par défaut) 

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

RemoveByResourceGroupId 

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 à renvoyer 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 à renvoyer 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.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-AsJob

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure

Propriétés du paramètre

Type:IAzureContextContainer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Force

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Id

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:ResourceGroupId, ResourceId

Jeux de paramètres

RemoveByResourceGroupId
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Name

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:ResourceGroupName

Jeux de paramètres

RemoveByResourceGroupName
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

String

Sorties

Boolean