Remove-WAPackVMRole

Référence

Module:: Azure

Supprime les objets de rôle de machine virtuelle.

Notes

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Gestion des services. Pour ce qui est des cmdlets permettant de gérer des ressources Azure Resource Manager, consultez le Module Az PowerShell.

Syntax

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
Default value:	None
Required:	True
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

-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

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