Add-AzVMDataDisk
Ajoute un disque de données à une machine virtuelle.
Syntax
Add-AzVMDataDisk
[-VM] <PSVirtualMachine>
[[-Name] <String>]
[[-VhdUri] <String>]
[[-Caching] <CachingTypes>]
[[-DiskSizeInGB] <Int32>]
[-Lun] <Int32>
[-CreateOption] <String>
[[-SourceImageUri] <String>]
[-DiskEncryptionSetId <String>]
[-DeleteOption <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>]
[-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 EmptyLa 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 $VirtualMachineLa 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 FromImageLa 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 AttachLa 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 |
| Accepted values: | None, ReadOnly, ReadWrite |
| Position: | 3 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | 6 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DiskSizeInGB
Spécifie la taille, en gigaoctets, d’un disque vide à attacher à une machine virtuelle.
| Type: | Nullable<T>[Int32] |
| Position: | 4 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Lun
Spécifie le numéro d’unité logique (LUN) d’un disque de données.
| Type: | Nullable<T>[Int32] |
| Position: | 5 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ManagedDiskId
Spécifie l’ID d’un disque managé.
| Type: | String |
| Position: | 8 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Spécifie le nom du disque de données à ajouter.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SourceImageUri
Spécifie l’URI source du disque attaché à cette applet de commande.
| Type: | String |
| Aliases: | SourceImage |
| Position: | 7 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-StorageAccountType
Spécifie le type de compte de stockage du disque managé.
| Type: | String |
| Position: | 9 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 |
| Aliases: | VMProfile |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WriteAccelerator
Spécifie si WriteAccelerator doit être activé ou désactivé sur un disque de données managé.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entrées
Nullable<T>[[System.Int32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]
Sorties
Liens associés
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour