Partager via

Set-AzureRMVMDataDisk

  • Référence
Module:
AzureRM.Compute

Modifie les propriétés d’un disque de données de machine virtuelle.

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

Set-AzureRMVMDataDisk
   [-VM] <PSVirtualMachine>
   [-Name] <String>
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-StorageAccountType <String>]
   [-WriteAccelerator]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzureRMVMDataDisk
   [-VM] <PSVirtualMachine>
   [-Lun] <Int32>
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-StorageAccountType <String>]
   [-WriteAccelerator]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

L’applet de commande Set-AzureRmVMDataDisk modifie les propriétés d’un disque de données de machine virtuelle.

Exemples

Exemple 1 : Modifier le mode de mise en cache d’un disque de données

PS C:\> $VM = Get-AzureRMVM -ResourceGroupName "ResourceGroup11" -VMName "ContosoVM07"
PS C:\> Set-AzureRmVMDataDisk -VM $VM -Name "DataDisk01" -Caching ReadWrite | Update-AzureRmVM

La première commande obtient la machine virtuelle nommée ContosoVM07 à l’aide de Get-AzureRmVM. La commande la stocke dans la variable $VM. La deuxième commande modifie le mode de mise en cache du disque de données nommé DataDisk01 sur la machine virtuelle dans $VM. La commande transmet le résultat à l’applet de commande Update-AzureRmVM, qui implémente vos modifications. Une modification du mode d’encaissement entraîne le redémarrage de la machine virtuelle.

Paramètres

-Caching

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

  • Lecture seule
  • ReadWrite La 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:Nullable<T>[CachingTypes]
Valeurs acceptées:None, ReadOnly, ReadWrite
Position:2
Valeur par défaut:None
Obligatoire:False
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, pour le disque de données.

Type:Nullable<T>[Int32]
Position:3
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) du disque de données modifié par cette applet de commande.

Type:Nullable<T>[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

-Name

Spécifie le nom du disque de données que cette applet de commande modifie.

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

-StorageAccountType

Type de compte du disque managé de la machine virtuelle.

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

-VM

Spécifie la machine virtuelle pour laquelle cette applet de commande modifie un disque de données. Pour obtenir un objet de machine virtuelle, utilisez l’applet de commande Get-AzureRmVM.

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 le disque de données.

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

Nullable<T>[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Nullable<T>[[Microsoft.Azure.Management.Compute.Models.CachingTypes, Microsoft.Azure.Management.Compute, Version=21.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

Sorties

PSVirtualMachine