Partager via


Remove-AzureSubscription

Supprime un abonnement Azure de Windows PowerShell.

Remarque

Les applets de commande référencées dans cette documentation concernent la gestion des ressources Azure héritées qui utilisent les API Azure Service Manager (ASM). Ce module PowerShell hérité n’est pas recommandé lors de la création de ressources, car ASM est planifié pour la mise hors service. Pour plus d’informations, consultez la mise hors service d’Azure Service Manager.

Le module Az PowerShell est le module PowerShell recommandé pour la gestion des ressources Azure Resource Manager (ARM) avec PowerShell.

Syntaxe

Remove-AzureSubscription
      -SubscriptionName <String>
      [-Force]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureSubscription
      -SubscriptionId <String>
      [-Force]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

L’applet de commande Remove-AzureSubscription supprime un abonnement Azure de votre fichier de données d’abonnement afin que Windows PowerShell ne puisse pas le trouver. Cette applet de commande ne supprime pas l’abonnement de Microsoft Azure, ni modifie l’abonnement réel de quelque manière que ce soit.

Cette rubrique décrit l’applet de commande dans la version 0.8.10 du module Microsoft Azure PowerShell. Pour obtenir la version du module que vous utilisez, dans la console Azure PowerShell, tapez (Get-Module -Name Azure).Version.

Exemples

Exemple 1 : Supprimer un abonnement

C:\PS> Remove-AzureSubscription -SubscriptionName Test

Confirm
Are you sure you want to perform this action?
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"):

Cette commande supprime l’abonnement « Test » du fichier de données d’abonnement par défaut.

Exemple 2 : Supprimer d’un autre fichier de données d’abonnement

C:\PS> Remove-AzureSubscription -SubscriptionName Test -SubscriptionDataFile C:\Subs\MySubscriptions.xml -Force

Cette commande supprime l’abonnement test du fichier de données d’abonnement MySubscriptions.xml. La commande utilise le paramètre Force pour supprimer l’invite de confirmation.

Exemple 3 : Supprimer un abonnement dans un script

C:\PS> ...if (Remove-AzureSubscription -SubscriptionName Test -PassThru) {...}

Cette commande utilise la commande Remove-AzureSubscription dans une instruction If . Il utilise le paramètre PassThru , qui retourne une valeur booléenne, pour déterminer si le bloc de script dans l’instruction If est exécuté.

Paramètres

-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

-Force

Supprime l’invite de confirmation.

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

-PassThru

Retourne $True si la commande réussit et $False en cas d’échec. Par défaut, cette applet de commande ne retourne aucune sortie.

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

-Profile

Spécifie le profil Azure à partir duquel cette applet de commande lit. Si vous ne spécifiez pas de profil, cette applet de commande lit le profil par défaut local.

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

-SubscriptionId

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

-SubscriptionName

Type:String
Alias:Name
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
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

None

Vous pouvez diriger l’entrée vers cette applet de commande par nom de propriété, mais pas par valeur.

Sorties

None or System.Boolean

Si vous utilisez le paramètre PassThru , cette applet de commande retourne une valeur booléenne. Sinon, elle ne retourne aucune sortie.