Add-AzureRmVmssVMDataDisk

Référence

Module:: AzureRM.Compute

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

Avertissement

Le module AzureRM PowerShell a été officiellement déconseillé depuis 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.

Bien que le module AzureRM puisse toujours fonctionner, il n’est plus conservé ou pris en charge, plaçant toute utilisation continue à la discrétion et au risque de l’utilisateur. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.

Syntax

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 $VmssVM

La 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
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:	2
valeur par défaut:	None
Obligatoire:	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:	AzureRmContext, AzureCredential
Position:	Named
valeur par défaut:	None
Obligatoire:	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:	Int32
Position:	Named
valeur par défaut:	None
Obligatoire:	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:	Int32
Position:	1
valeur par défaut:	None
Obligatoire:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ManagedDiskId

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

Type:	String
Position:	3
valeur par défaut:	None
Obligatoire:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-StorageAccountType

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

Type:	String
Position:	Named
valeur par défaut:	None
Obligatoire:	False
Accept pipeline input:	True
Accept wildcard characters:	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.