Partager via

Add-AzVMDataDisk

Module:
Az.Compute Module

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

Syntaxe

VmNormalDiskParameterSetName (Par défaut) 

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>]

VmManagedDiskParameterSetName 

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, ou vous pouvez 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 de machine virtuelle, puis la stocke dans la variable $VirtualMachine. La commande affecte un nom et une taille à la machine virtuelle. Les trois commandes suivantes attribuent des chemins d’accès de trois disques de données aux variables $DataDiskVhdUri 01, $DataDiskVhdUri 02 et $DataDiskVhdUri 03. 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 $DataDiskVhdUri 01, $DataDiskVhdUri 02 et $DataDiskVhdUri 03.

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 affecte 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 affecte 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 acceptables pour ce paramètre sont les suivantes :

  • ReadOnly
  • ReadWrite
  • 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.

Propriétés du paramètre

Type:CachingTypes
Valeur par défaut:None
Valeurs acceptées:None, ReadOnly, ReadWrite
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:3
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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 acceptables pour ce paramètre sont les suivantes :

  • 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.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:6
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-DefaultProfile

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

Propriétés du paramètre

Type:IAzureContextContainer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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é.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DiskSizeInGB

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

Propriétés du paramètre

Type:

Nullable<T>[Int32]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:4
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Lun

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

Propriétés du paramètre

Type:

Nullable<T>[Int32]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:5
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-ManagedDiskId

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

VmManagedDiskParameterSetName
Position:8
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Name

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:1
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-SourceImageUri

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:SourceImage

Jeux de paramètres

VmNormalDiskParameterSetName
Position:7
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-SourceResourceId

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-StorageAccountType

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

VmManagedDiskParameterSetName
Position:9
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

VmNormalDiskParameterSetName
Position:2
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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.

Propriétés du paramètre

Type:PSVirtualMachine
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:VMProfile

Jeux de paramètres

(All)
Position:0
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-WriteAccelerator

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

VmManagedDiskParameterSetName
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

PSVirtualMachine

String

CachingTypes

Nullable<T>

Sorties

PSVirtualMachine

PSVirtualMachineScaleSetVM