Remove-AzureEnvironment
Supprime un environnement Azure de Windows PowerShell.
Remarque
Les cmdlets mentionnées dans cette documentation servent à gérer les 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-AzureEnvironment
-Name <String>
[-Force]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
Description
L’applet de commande Remove-AzureEnvironment supprime un environnement Azure de votre profil itinérant afin que Windows PowerShell ne puisse pas le trouver. Cette applet de commande ne supprime pas l’environnement de Microsoft Azure ou ne modifie pas l’environnement réel de quelque manière que ce soit.
Un environnement Azure un déploiement indépendant de Microsoft Azure, tel qu’AzureCloud pour Azure global et AzureChinaCloud pour Azure géré par 21Vianet en Chine. Vous pouvez également créer des environnements Azure locaux à l’aide d’Azure Pack et des applets de commande WAPack. Pour plus d’informations, consultez Azure Pack.
Exemples
Exemple 1 : Supprimer un environnement
PS C:\> Remove-AzureEnvironment -Name ContosoEnv
Cette commande supprime l’environnement ContosoEnv de Windows PowerShell.
Exemple 2 : Supprimer plusieurs environnements
PS C:\> Get-AzureEnvironment | Where-Object EnvironmentName -like "Contoso*" | ForEach-Object {Remove-AzureEnvironment -Name $_.EnvironmentName }
Cette commande supprime les environnements dont les noms commencent par « Contoso » de Windows PowerShell.
Paramètres
-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 |
-Name
Spécifie le nom de l’environnement à supprimer. Ce paramètre est obligatoire. Cette valeur de paramètre respecte la casse. Les caractères génériques ne sont pas autorisés.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
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 |
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.