Partager via

Set-AzureDataDisk

  • Référence
Module:
Azure

Modifie la mise en cache de l’hôte d’un disque de données existant sur une machine virtuelle Azure.

Remarque

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Azure Service Manager (ASM). Ce module PowerShell hérité n’est pas recommandé lors de la création de ressources, car ASM est planifié pour la mise hors service. Pour plus d’informations, consultez la mise hors service d’Azure Service Manager.

Le module Az PowerShell est le module PowerShell recommandé pour la gestion des ressources Azure Resource Manager (ARM) avec PowerShell.

Syntaxe

Set-AzureDataDisk
   [-HostCaching] <String>
   [-LUN] <Int32>
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureDataDisk
   [-DiskName] <String>
   [-ResizedSizeInGB] <Int32>
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

L’applet de commande Set-AzureDataDisk modifie les attributs de cache d’un disque de données existant sur une machine virtuelle Azure. Spécifiez le disque de données à mettre à jour par son numéro d’unité logique (LUN).

Exemples

Exemple 1 : Modifier la mise en cache de l’hôte pour un disque de données

PS C:\> Get-AzureVM "ContosoService" | Set-AzureDataDisk -VM "VirtualMachine07" -LUN 2 -HostCaching ReadOnly | Update-AzureVM

Cette commande obtient les machines virtuelles qui s’exécutent sur le service nommé ContosoService à l’aide de l’applet de commande Get-AzureVM . La commande les transmet à l’applet de commande actuelle à l’aide de l’opérateur de pipeline. Cette applet de commande définit le disque de données au numéro d’unité logique 2 de la machine virtuelle nommée VirtualMachine07 pour utiliser la mise en cache de l’hôte ReadOnly. La commande met à jour la machine virtuelle pour refléter vos modifications à l’aide de l’applet de commande Update-AzureVM .

Exemple 2 : Modifier la mise en cache de l’hôte pour tous les disques de données sur une machine virtuelle

PS C:\> Get-AzureVM "ContosoService" -Name "VirtualMachine07" | Get-AzureDataDisk | Set-AzureDataDisk -HostCaching ReadWrite | Update-AzureVM

Cette commande obtient un objet pour la machine virtuelle nommée VirtualMachine07 sur le service cloud ContosoService. La commande la transmet à l’applet de commande Get-AzureDataDisk , qui obtient les disques de données de cette machine virtuelle. L’applet de commande actuelle définit ensuite le mode de mise en cache de l’hôte de chaque disque de données sur ReadWrite. La commande met à jour la machine virtuelle pour refléter vos modifications.

Paramètres

-DiskName

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

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

-HostCaching

Avertissement

La mise en cache du disque n’est pas prise en charge pour les disques 4 Tio et supérieurs. Si plusieurs disques sont attachés à votre machine virtuelle, chaque disque d’une taille inférieure à 4 Tio prend en charge la mise en cache.

La modification du paramètre de cache d’un disque Azure détache et rattache le disque cible. S’il s’agit du disque du système d’exploitation, la machine virtuelle redémarre. Arrêtez toutes les applications et services qui risquent d’être affectés par cette indisponibilité avant de modifier le paramètre de cache du disque. Le non-respect de ces recommandations peut entraîner une altération des données.

Spécifie les paramètres de mise en cache au niveau de l’hôte du disque. Les valeurs valides sont :

  • Aucune
  • ReadOnly
  • Lecture/écriture
Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InformationAction

Spécifie la façon dont cette applet de commande répond à un événement d’information.

Les valeurs valides pour ce paramètre sont :

  • Continuer
  • Ignorer
  • Demander
  • SilentlyContinue
  • Stop
  • Suspendre
Type:ActionPreference
Alias:infa
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InformationVariable

Spécifie une variable d’informations.

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

-LUN

Spécifie le numéro d’unité logique du lecteur de données dans la machine virtuelle. Les valeurs valides sont : 0 à 15.

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

-Profile

Spécifie le profil Azure à partir duquel cette applet de commande lit. Si vous ne spécifiez pas de profil, cette applet de commande lit le profil par défaut local.

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

-ResizedSizeInGB

Spécifie la nouvelle taille, en gigaoctets, pour le disque de données. La nouvelle taille doit être supérieure à la taille actuelle.

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

-VM

Spécifie l’objet de machine virtuelle attaché au disque de données. Pour obtenir un objet de machine virtuelle, utilisez l’applet de commande Get-AzureVM .

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