Add-AzureRmVmssVMDataDisk
Ajoute un disque de données à une machine virtuelle Vmss.
Avertissement
Le module AzureRM PowerShell a été officiellement déprécié le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.
Il est possible que le module AzureRM fonctionne encore, mais il ne fait plus l’objet de maintenance ni de support. L’utilisateur peut continuer à s’en servir s’il le souhaite, à ses propres risques. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.
Syntaxe
Add-AzureRmVmssVMDataDisk
[-VirtualMachineScaleSetVM] <PSVirtualMachineScaleSetVM>
[-Lun] <Int32>
[-CreateOption] <String>
[-ManagedDiskId] <String>
[-StorageAccountType <String>]
[-Caching <CachingTypes>]
[-DiskSizeInGB <Int32>]
[-WriteAccelerator]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Description
L’applet de commande Add-AzureRmVmssVMDataDisk ajoute un disque de données à une machine virtuelle Vmss.
Exemples
Exemple 1 : Ajouter un disque de données managé à une machine virtuelle Vmss.
PS C:\> $disk = Get-AzureRmDisk -ResourceGroupName $rgname -DiskName $diskname0
PS C:\> $VmssVM = Get-AzureRmVmssVM -ResourceGroupName "myrg" -VMScaleSetName "myvmss" -InstanceId 0
PS C:\> $VmssVM = Add-AzureRmVmssVMDataDisk -VirtualMachineScaleSetVM $VmssVM -Lun 0 -DiskSizeInGB 10 -CreateOption Attach -StorageAccountType Standard_LRS -ManagedDiskId $disk.Id
PS C:\> Update-AzureRmVmssVM -VirtualMachineScaleSetVM $VmssVMLa première commande obtient un disque managé existant. La commande suivante obtient une machine virtuelle Vmss existante donnée par le nom du groupe de ressources, le nom des machines virtuelles et l’ID d’instance. La commande suivante ajoute le disque managé à la machine virtuelle Vmss stockée localement dans $VmssVM. La commande finale met à jour la machine virtuelle Vmss avec un disque de données ajouté.
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: | Named |
| 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.
| Type: | String |
| Position: | 2 |
| 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: | 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 |
-DiskSizeInGB
Spécifie la taille, en gigaoctets, d’un disque vide à attacher à une machine virtuelle.
| Type: | Int32 |
| Position: | Named |
| 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: | Int32 |
| Position: | 1 |
| 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: | 3 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| 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: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-VirtualMachineScaleSetVM
Spécifie l’objet de machine virtuelle de groupe de machines virtuelles identiques local auquel ajouter un disque de données. Vous pouvez utiliser l’applet de commande Get-AzureRmVmssVM pour obtenir un objet de machine virtuelle de groupe de machines virtuelles identiques.
| Type: | PSVirtualMachineScaleSetVM |
| 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 |