Partager via


Set-AzVMDataDisk

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

Syntaxe

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

Description

L’applet de commande Set-AzVMDataDisk 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

$VM = Get-AzVM -ResourceGroupName "ResourceGroup11" -VMName "ContosoVM07"
Set-AzVMDataDisk -VM $VM -Name "DataDisk01" -Caching ReadWrite | Update-AzVM

La première commande obtient la machine virtuelle nommée ContosoVM07 à l’aide de Get-AzVM. 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-AzVM, qui implémente vos modifications. Une modification du mode d’encaissement entraîne le redémarrage de la machine virtuelle.

Exemple 2

Modifie les propriétés d’un disque de données de machine virtuelle. (généré automatiquement)

Set-AzVMDataDisk -Caching None -Lun 1 -VM <PSVirtualMachine>

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:AzContext, 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

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

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, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

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

Sorties

PSVirtualMachine