Set-AzureOSDisk

Référence

Module:: Azure

Modifie le mode de cache hôte d’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-AzureOSDisk
   [-HostCaching] <String>
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

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

Description

L’applet de commande Set-AzureOSDisk modifie le mode de cache hôte du disque du système d’exploitation d’une machine virtuelle Azure. Les modes de cache hôte pris en charge sont ReadOnly et ReadWrite. Si vous exécutez cette applet de commande sur une machine virtuelle en cours d’exécution, cette machine virtuelle redémarre.

Exemples

Exemple 1 : Définir le mode de cache de l’hôte sur ReadOnly à l’aide du pipeline

PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirtualMachine02" | Set-AzureOSDisk -HostCaching "ReadOnly"

Cette commande obtient la machine virtuelle nommée VirtualMachine02 dans le service nommé ContosoService à l’aide de l’applet de commande Get-AzureVM . La commande transmet la machine virtuelle à l’applet de commande actuelle à l’aide de l’opérateur de pipeline. L’applet de commande actuelle définit le mode de cache hôte du disque du système d’exploitation de cette machine virtuelle sur ReadOnly.

Exemple 2 : Définir le mode de cache de l’hôte sur ReadWrite

PS C:\> $VM = Get-AzureVM -ServiceName "ContosoService" -Name "VirtualMachine02"
PS C:\> Set-AzureOSDisk "ReadWrite" -VM $myVM2

La première commande obtient la machine virtuelle nommée VirtualMachine02 dans le service nommé ContosoService, puis la stocke dans la variable.

La deuxième commande définit le mode de cache hôte du disque du système d’exploitation de cette machine virtuelle sur ReadWrite.

Paramètres

-HostCaching

Spécifie l’attribut du cache hôte pour le disque du système d’exploitation. Les valeurs autorisées sont :

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

-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 une nouvelle taille, en gigaoctets, pour le disque du système d’exploitation. La taille doit être supérieure à la taille actuelle.

Type:	Int32
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-VM

Spécifie la machine virtuelle pour laquelle cette applet de commande modifie le disque du système d’exploitation. 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