Partager via

Remove-AzureDataDisk

  • Référence
Module:
Azure

Supprime un disque de données d’une machine virtuelle Azure.

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-AzureDataDisk
      [-LUN] <Int32>
      [-DeleteVHD]
      -VM <IPersistentVM>
      [-Profile <AzureSMProfile>]
      [-InformationAction <ActionPreference>]
      [-InformationVariable <String>]
      [<CommonParameters>]

Description

L’applet de commande Remove-AzureDataDisk supprime un disque de données d’une machine virtuelle Azure. Par défaut, cette applet de commande ne supprime pas l’objet blob de disque de données du compte de stockage.

Exemples

Exemple 1 : Supprimer un disque de données

PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirtualMachine07" | Remove-AzureDataDisk -LUN 0

Cette commande obtient la machine virtuelle nommée VirtualMachine07 dans le service nommé ContosoService à l’aide de l’applet de commande Get-AzureVM . La commande transmet la machine virtuelle à l’applet de commande actuelle à l’aide de l’opérateur de pipeline. L’applet de commande actuelle supprime le disque de données contenant le numéro d’unité logique 0.

Exemple 2 : Supprimer un disque de données et le fichier de disque dur virtuel

PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirtualMachine07" | Remove-AzureDataDisk -LUN 0 -DeleteVHD | Update-AzureVM

Cette commande obtient la machine virtuelle nommée VirtualMachine07 dans le service nommé ContosoService. La commande transmet la machine virtuelle à l’applet de commande actuelle. L’applet de commande actuelle supprime le disque de données contenant le numéro d’unité logique 0. La commande inclut le paramètre DeleteVHD . Par conséquent, il supprime également le disque dur virtuel sous-jacent. La commande met à jour la machine virtuelle pour refléter vos modifications à l’aide de l’applet de commande Update-AzureVM .

Paramètres

-DeleteVHD

Indique que cette applet de commande supprime le disque de données et le disque dur virtuel (VHD) du stockage d’objets blob.

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

-InformationAction

Spécifie la façon dont cette applet de commande répond à un événement d’information.

Les valeurs valides pour ce paramètre sont :

  • Continuer
  • Ignorer
  • Demander
  • SilentlyContinue
  • Stop
  • Suspendre
Type:ActionPreference
Alias:infa
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InformationVariable

Spécifie une variable d’informations.

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

-LUN

Spécifie le numéro d’unité logique (LUN) du lecteur de données dans la machine virtuelle. Les valeurs valides sont : 0 à 15.

Type:Int32
Position:0
Valeur par défaut:None
Obligatoire:True
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

-VM

Spécifie l’objet de machine virtuelle attaché au disque de données. Pour obtenir un objet de machine virtuelle, utilisez l’applet de commande Get-AzureVM .

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