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.

Notes

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Gestion des services. Pour ce qui est des cmdlets permettant de gérer des ressources Azure Resource Manager, consultez le Module Az PowerShell.

Syntax

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
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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 autorisées sont :

None
Lecture seule
Lecture/écriture

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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
Renseignez-vous
SilentlyContinue
Arrêter
Suspendre

Type:	ActionPreference
Aliases:	infa
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationVariable

Spécifie une variable d’informations.

Type:	String
Aliases:	iv
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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
Aliases:	InputObject
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False