Set-AzureOSDisk
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 |