Partager via

Remove-WAPackVMRole

  • Référence
Module:
Azure

Supprime les objets de rôle de machine virtuelle.

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-WAPackVMRole
      -VMRole <VMRole>
      [-PassThru]
      [-Force]
      [-Profile <AzureSMProfile>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-WAPackVMRole
      -VMRole <VMRole>
      -CloudServiceName <String>
      [-PassThru]
      [-Force]
      [-Profile <AzureSMProfile>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Ces rubriques sont déconseillées et seront supprimées à l’avenir. Cette rubrique décrit l’applet de commande dans la version 0.8.1 du module Microsoft Azure PowerShell. Pour connaître la version du module que vous utilisez, à partir de la console Azure PowerShell, tapez (Get-Module -Name Azure).Version.

L’applet de commande Remove-WAPackVMRole supprime les objets de rôle de machine virtuelle.

Exemples

Exemple 1 : Supprimer un rôle de machine virtuelle (créé à l’aide du portail WAP)

PS C:\> $VMRole = Get-WAPackVMRole -Name "ContosoVMRole01"
PS C:\> Remove-WAPackVMRole -VMRole $VMRole

La première commande obtient le rôle de machine virtuelle nommé ContosoVMRole01 à l’aide de l’applet de commande Get-WAPackVMRole , puis stocke cet objet dans la variable $VMRole.

La deuxième commande supprime le rôle de machine virtuelle stocké dans $VMRole. La commande vous invite à confirmer. En supposant que ce rôle de machine virtuelle a été créé à l’aide du portail WAP, il n’est pas nécessaire de spécifier le nom du service cloud.

Exemple 2 : Supprimer un rôle de machine virtuelle créé après la création manuelle d’un service cloud

PS C:\> $VMRole = Get-WAPackVMRole -Name "ContosoVMRole02"
PS C:\> Remove-WAPackVMRole -VMRole $VMRole -CloudServiceName "ContosoCloudService02"

La première commande obtient le rôle de machine virtuelle nommé « ContosoVMRole02 » à l’aide de l’applet de commande Get-WAPackVMRole , puis stocke cet objet dans la variable $VMRole.

La deuxième commande supprime le rôle de machine virtuelle stocké dans $VMRole. La commande vous invite à confirmer. En supposant que ce rôle de machine virtuelle n’a pas été créé à l’aide du portail, l’utilisateur doit spécifier le nom du service cloud. Dans ce cas, nommé « ContosoCloudService02 ».

Exemple 3 : Supprimer un rôle de machine virtuelle sans confirmation

PS C:\> $VMRole = Get-WAPackVMRole -Name "ContosoVMRole03"
PS C:\> Remove-WAPackVMRole -VMRole $VMRole -Force

La première commande obtient le service cloud nommé ContosoVMRole03 à l’aide de l’applet de commande Get-WAPackVMRole , puis stocke cet objet dans la variable $VMRole.

La deuxième commande supprime le rôle de machine virtuelle stocké dans $VMRole. Cette commande inclut le paramètre Force . La commande ne vous invite pas à confirmer.

Paramètres

-CloudServiceName

Spécifie le nom du service cloud du rôle de machine virtuelle.

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

-Confirm

Vous demande une confirmation avant d’exécuter la commande cmdlet.

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

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

-PassThru

Retourne un objet représentant l’élément que vous utilisez. Par défaut, cette applet de commande ne génère aucun résultat.

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

-VMRole

Spécifie un rôle de machine virtuelle. Pour obtenir un rôle de machine virtuelle, utilisez l’applet de commande Get-WAPackVMRole .

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