Add-AzVMDataDisk

  • Référence
Module:
Az.Compute

Ajoute un disque de données à une machine virtuelle.

Syntaxe

Add-AzVMDataDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-VhdUri] <String>]
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-Lun] <Int32>
   [-CreateOption] <String>
   [[-SourceImageUri] <String>]
   [-DiskEncryptionSetId <String>]
   [-DeleteOption <String>]
   [-SourceResourceId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzVMDataDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-Lun] <Int32>
   [-CreateOption] <String>
   [[-ManagedDiskId] <String>]
   [[-StorageAccountType] <String>]
   [-DiskEncryptionSetId <String>]
   [-WriteAccelerator]
   [-DeleteOption <String>]
   [-SourceResourceId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

L’applet de commande Add-AzVMDataDisk ajoute un disque de données à une machine virtuelle. Vous pouvez ajouter un disque de données lorsque vous créez une machine virtuelle. Vous pouvez également ajouter un disque de données à une machine virtuelle existante.

Exemples

Exemple 1 : Ajouter des disques de données à une nouvelle machine virtuelle

$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
$DataDiskVhdUri01 = "https://contoso.blob.core.windows.net/test/data1.vhd"
$DataDiskVhdUri02 = "https://contoso.blob.core.windows.net/test/data2.vhd"
$DataDiskVhdUri03 = "https://contoso.blob.core.windows.net/test/data3.vhd"
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name 'DataDisk1' -Caching 'ReadOnly' -DiskSizeInGB 10 -Lun 0 -VhdUri $DataDiskVhdUri01 -CreateOption Empty
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name 'DataDisk2' -Caching 'ReadOnly' -DiskSizeInGB 11 -Lun 1 -VhdUri $DataDiskVhdUri02 -CreateOption Empty
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name 'DataDisk3' -Caching 'ReadOnly' -DiskSizeInGB 12 -Lun 2 -VhdUri $DataDiskVhdUri03 -CreateOption Empty

La première commande crée un objet machine virtuelle avant de le stocker dans la variable $VirtualMachine. La commande attribue un nom et une taille à la machine virtuelle. Les trois commandes suivantes attribuent les chemins d’accès de trois disques de données aux variables $DataDiskVhdUri01, $DataDiskVhdUri02 et $DataDiskVhdUri03. Cette approche est uniquement destinée à la lisibilité des commandes suivantes. Les trois commandes finales ajoutent chacun un disque de données à la machine virtuelle stockée dans $VirtualMachine. La commande spécifie le nom et l’emplacement du disque et d’autres propriétés du disque. L’URI de chaque disque est stocké dans $DataDiskVhdUri01, $DataDiskVhdUri02 et $DataDiskVhdUri03.

Exemple 2 : Ajouter un disque de données à une machine virtuelle existante

$VirtualMachine = Get-AzVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07"
Add-AzVMDataDisk -VM $VirtualMachine -Name "disk1" -VhdUri "https://contoso.blob.core.windows.net/vhds/diskstandard03.vhd" -LUN 0 -Caching ReadOnly -DiskSizeinGB 1 -CreateOption Empty
Update-AzVM -ResourceGroupName "ResourceGroup11" -VM $VirtualMachine

La première commande obtient la machine virtuelle nommée VirtualMachine07 à l’aide de l’applet de commande Get-AzVM . La commande stocke la machine virtuelle dans la variable $VirtualMachine . La deuxième commande ajoute un disque de données à la machine virtuelle stockée dans $VirtualMachine. La commande finale met à jour l’état de la machine virtuelle stockée dans $VirtualMachine dans ResourceGroup11.

Exemple 3 : Ajouter un disque de données à une nouvelle machine virtuelle à partir d’une image utilisateur généralisée

$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
$DataImageUri = "https://contoso.blob.core.windows.net/system/Microsoft.Compute/Images/captured/dataimage.vhd"
$DataDiskUri = "https://contoso.blob.core.windows.net/test/datadisk.vhd"
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name "disk1" -SourceImageUri $DataImageUri -VhdUri $DataDiskUri -Lun 0 -DiskSizeinGB 10 -CreateOption FromImage

La première commande crée un objet de machine virtuelle et le stocke dans la variable $VirtualMachine. La commande attribue un nom et une taille à la machine virtuelle. Les deux commandes suivantes attribuent des chemins d’accès pour l’image de données et les disques de données aux variables $DataImageUri et $DataDiskUri respectivement. Cette approche est utilisée pour améliorer la lisibilité des commandes suivantes. Les commandes finales ajoutent un disque de données à la machine virtuelle stockée dans $VirtualMachine. La commande spécifie le nom et l’emplacement du disque et d’autres propriétés du disque.

Exemple 4 : Ajouter des disques de données à une nouvelle machine virtuelle à partir d’une image utilisateur spécialisée

$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
$DataDiskUri = "https://contoso.blob.core.windows.net/test/datadisk.vhd"
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name "dd1" -VhdUri $DataDiskUri -Lun 0 -DiskSizeinGB 10 -CreateOption Attach

La première commande crée un objet de machine virtuelle et le stocke dans la variable $VirtualMachine. La commande attribue un nom et une taille à la machine virtuelle. Les commandes suivantes attribuent des chemins d’accès du disque de données à la variable $DataDiskUri. Cette approche est utilisée pour améliorer la lisibilité des commandes suivantes. La commande finale ajoute un disque de données à la machine virtuelle stockée dans $VirtualMachine. La commande spécifie le nom et l’emplacement du disque et d’autres propriétés du disque.

Paramètres

-Caching

Spécifie le mode de mise en cache du disque. Les valeurs valides pour ce paramètre sont :

  • Lecture seule
  • Lecture/écriture
  • Aucune valeur par défaut est ReadWrite. La modification de cette valeur entraîne le redémarrage de la machine virtuelle. Ce paramètre affecte la cohérence et les performances du disque.
Type:CachingTypes
Valeurs acceptées:None, ReadOnly, ReadWrite
Position:3
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-CreateOption

Spécifie si cette applet de commande crée un disque dans la machine virtuelle à partir d’une plateforme ou d’une image utilisateur, crée un disque vide ou attache un disque existant. Les valeurs valides pour ce paramètre sont :

  • Joindre. Spécifiez cette option pour créer une machine virtuelle à partir d’un disque spécialisé. Lorsque vous spécifiez cette option, ne spécifiez pas le paramètre SourceImageUri . Le VhdUri est tout ce qui est nécessaire pour indiquer à la plateforme Azure l’emplacement du disque dur virtuel (VHD) à attacher en tant que disque de données à la machine virtuelle.
  • Vide. Spécifiez cette option pour créer un disque de données vide.
  • FromImage. Spécifiez cette option pour créer une machine virtuelle à partir d’une image ou d’un disque généralisé. Lorsque vous spécifiez cette option, vous devez également spécifier le paramètre SourceImageUri pour indiquer à la plateforme Azure l’emplacement du disque dur virtuel à attacher en tant que disque de données. Le paramètre VhdUri est utilisé comme emplacement identifiant l’emplacement où le disque dur virtuel du disque de données sera stocké lorsqu’il est utilisé par la machine virtuelle.
  • Vide. Cette valeur est utilisée lors de la création d’un disque de données vide.
  • Copier. Cette valeur est utilisée pour créer un disque de données à partir d’un instantané ou d’un autre disque. Restauration : cette valeur est utilisée pour créer un disque de données à partir d’un point de restauration de disque.
Type:String
Position:6
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DeleteOption

Option De suppression de disque de données. Spécifie l’action à effectuer sur le disque après la suppression de la machine virtuelle. Les options sont les suivantes : Détacher, Supprimer.

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

-DiskEncryptionSetId

Spécifie l’ID de ressource du jeu de chiffrement de disque managé du client. Cela ne peut être spécifié que pour le disque managé.

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

-DiskSizeInGB

Spécifie la taille, en gigaoctets, d’un disque vide à attacher à une machine virtuelle.

Type:Nullable<T>[Int32]
Position:4
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Lun

Spécifie le numéro d’unité logique (LUN) d’un disque de données.

Type:Nullable<T>[Int32]
Position:5
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ManagedDiskId

Spécifie l’ID d’un disque managé.

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

-Name

Spécifie le nom du disque de données à ajouter.

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

-SourceImageUri

Spécifie l’URI source du disque attaché à cette applet de commande.

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

-SourceResourceId

ID ARM du point de restauration d’instantané ou de disque à partir duquel créer un disque.

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

-StorageAccountType

Spécifie le type de compte de stockage du disque managé.

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

-VhdUri

Spécifie l’URI (Uniform Resource Identifier) du fichier de disque dur virtuel (VHD) à créer lorsqu’une image de plateforme ou une image utilisateur est utilisée. Cette applet de commande copie l’objet volumineux binaire d’image (objet blob) à cet emplacement. Il s’agit de l’emplacement à partir duquel démarrer la machine virtuelle.

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

-VM

Spécifie l’objet de machine virtuelle locale auquel ajouter un disque de données. Vous pouvez utiliser l’applet de commande Get-AzVM pour obtenir un objet de machine virtuelle. Vous pouvez utiliser l’applet de commande New-AzVMConfig pour créer un objet de machine virtuelle.

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

-WriteAccelerator

Spécifie si WriteAccelerator doit être activé ou désactivé sur un disque de données managé.

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

Entrées

PSVirtualMachine

String

CachingTypes

Nullable<T>[[System.Int32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Sorties

PSVirtualMachine

PSVirtualMachineScaleSetVM