Partager via

Set-AzureRmVMOSDisk

  • Référence
Module:
AzureRM.Compute

Définit les propriétés du disque du système d’exploitation sur une machine virtuelle.

Avertissement

Le module AzureRM PowerShell a été officiellement déprécié le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.

Il est possible que le module AzureRM fonctionne encore, mais il ne fait plus l’objet de maintenance ni de support. L’utilisateur peut continuer à s’en servir s’il le souhaite, à ses propres risques. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.

Syntaxe

Set-AzureRmVMOSDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-VhdUri] <String>]
   [[-Caching] <CachingTypes>]
   [[-SourceImageUri] <String>]
   [[-CreateOption] <String>]
   [-DiskSizeInGB <Int32>]
   [-ManagedDiskId <String>]
   [-StorageAccountType <String>]
   [-WriteAccelerator]
   [-DiffDiskSetting <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzureRmVMOSDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-VhdUri] <String>]
   [[-Caching] <CachingTypes>]
   [[-SourceImageUri] <String>]
   [[-CreateOption] <String>]
   [-Windows]
   [-DiskSizeInGB <Int32>]
   [-ManagedDiskId <String>]
   [-StorageAccountType <String>]
   [-WriteAccelerator]
   [-DiffDiskSetting <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzureRmVMOSDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-VhdUri] <String>]
   [[-Caching] <CachingTypes>]
   [[-SourceImageUri] <String>]
   [[-CreateOption] <String>]
   [-Windows]
   [-DiskEncryptionKeyUrl] <String>
   [-DiskEncryptionKeyVaultId] <String>
   [[-KeyEncryptionKeyUrl] <String>]
   [[-KeyEncryptionKeyVaultId] <String>]
   [-DiskSizeInGB <Int32>]
   [-ManagedDiskId <String>]
   [-StorageAccountType <String>]
   [-WriteAccelerator]
   [-DiffDiskSetting <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzureRmVMOSDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-VhdUri] <String>]
   [[-Caching] <CachingTypes>]
   [[-SourceImageUri] <String>]
   [[-CreateOption] <String>]
   [-Linux]
   [-DiskSizeInGB <Int32>]
   [-ManagedDiskId <String>]
   [-StorageAccountType <String>]
   [-WriteAccelerator]
   [-DiffDiskSetting <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzureRmVMOSDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-VhdUri] <String>]
   [[-Caching] <CachingTypes>]
   [[-SourceImageUri] <String>]
   [[-CreateOption] <String>]
   [-Linux]
   [-DiskEncryptionKeyUrl] <String>
   [-DiskEncryptionKeyVaultId] <String>
   [[-KeyEncryptionKeyUrl] <String>]
   [[-KeyEncryptionKeyVaultId] <String>]
   [-DiskSizeInGB <Int32>]
   [-ManagedDiskId <String>]
   [-StorageAccountType <String>]
   [-WriteAccelerator]
   [-DiffDiskSetting <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

L’applet de commande Set-AzureRmVMOSDisk définit les propriétés du disque du système d’exploitation sur une machine virtuelle.

Exemples

Exemple 1 : Définir des propriétés sur une machine virtuelle à partir d’une image de plateforme

PS C:\> $AvailabilitySet = Get-AzureRmAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet13" 
PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine17" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id 
PS C:\> Set-AzureRmVMOSDisk -VM $VirtualMachine -Name "OsDisk12" -VhdUri "os.vhd" -Caching ReadWrite
PS C:\> $VirtualMachine = Set-AzureRmVMOperatingSystem -VM $VirtualMachine -Linux -ComputerName "MainComputer" -Credential (Get-Credential) 
PS C:\> $VirtualMachine = Set-AzureRmVMSourceImage -VM $VirtualMachine -PublisherName "Canonical" -Offer "UbuntuServer" -Skus "15.10" -Version "latest" -Caching ReadWrite
PS C:\> $VirtualMachine = Set-AzureRmVMOSDisk -VM $VirtualMachine -Name "osDisk.vhd" -VhdUri "https://mystorageaccount.blob.core.windows.net/disks/" -CreateOption FromImage
PS C:> New-AzureRmVM -VM $VirtualMachine -ResouceGroupName "ResourceGroup11"

La première commande obtient le groupe à haute disponibilité nommé AvailablitySet13 dans le groupe de ressources nommé ResourceGroup11, puis stocke cet objet dans la variable $AvailabilitySet. La deuxième commande crée un objet de machine virtuelle, puis la stocke dans la variable $VirtualMachine. La commande attribue un nom et une taille à la machine virtuelle. La machine virtuelle appartient au groupe à haute disponibilité stocké dans $AvailabilitySet. La commande finale définit les propriétés sur la machine virtuelle dans $VirtualMachine.

Exemple 2 : Définit des propriétés sur une machine virtuelle à partir d’une image utilisateur généralisée

PS C:\> $AvailabilitySet = Get-AzureRmAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet13" 
PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine17" -VMSize "Standard_A1"
PS C:\> $VirtualMachine = Set-AzureRmVMOperatingSystem -VM $VirtualMachine -Linux -ComputerName "MainComputer" -Credential (Get-Credential)
PS C:\> $VirtualMachine = Set-AzureRmVMOSDisk -VM $VirtualMachine -Name "osDisk.vhd" -SourceImageUri "https://mystorageaccount.blob.core.windows.net/vhds/myOSImage.vhd" -VhdUri "https://mystorageaccount.blob.core.windows.net/disks/" -CreateOption fromImage -Linux
PS C:> New-AzureRmVM -VM $VirtualMachine -ResouceGroupName "ResourceGroup11"

La première commande obtient le groupe à haute disponibilité nommé AvailablitySet13 dans le groupe de ressources nommé ResourceGroup11 et stocke cet objet dans la variable $AvailabilitySet. La deuxième commande crée un objet de machine virtuelle et le stocke dans la variable $VirtualMachine. La commande attribue un nom et une taille à la machine virtuelle. La machine virtuelle appartient au groupe à haute disponibilité stocké dans $AvailabilitySet. La commande finale définit les propriétés sur la machine virtuelle dans $VirtualMachine.

Exemple 3 : Définit des propriétés sur une machine virtuelle à partir d’une image utilisateur spécialisée

PS C:\> $AvailabilitySet = Get-AzureRmAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet13" 
PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine17" -VMSize "Standard_A1"
PS C:\> $VirtualMachine = Set-AzureRmVMOSDisk -VM $VirtualMachine -Name "osDisk.vhd" -VhdUri "https://mystorageaccount.blob.core.windows.net/disks/" -CreateOption Attach -Linux
PS C:> New-AzureRmVM -VM $VirtualMachine -ResouceGroupName "ResourceGroup11"

La première commande obtient le groupe à haute disponibilité nommé AvailablitySet13 dans le groupe de ressources nommé ResourceGroup11 et stocke cet objet dans la variable $AvailabilitySet. La deuxième commande crée un objet de machine virtuelle et le stocke dans la variable $VirtualMachine. La commande attribue un nom et une taille à la machine virtuelle. La machine virtuelle appartient au groupe à haute disponibilité stocké dans $AvailabilitySet. La commande finale définit les propriétés sur la machine virtuelle dans $VirtualMachine.

Exemple 4 : Définir les paramètres de chiffrement de disque sur un disque de système d’exploitation de machine virtuelle

PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine17" -VMSize "Standard_A1"
PS C:> $VirtualMachine = Set-AzureRmVMOSDisk -VM $VirtualMachine -Name "OsDisk12" -VhdUri "os.vhd" -Caching ReadWrite -Windows -CreateOption "Attach" -DiskEncryptionKeyUrl "https://mytestvault.vault.azure.net/secrets/Test1/514ceb769c984379a7e0230bddaaaaaa" -DiskEncryptionKeyVaultId "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myresourcegroup/providers/Microsoft.KeyVault/vaults/mytestvault"
PS C:> New-AzureRmVM -VM $VirtualMachine -ResouceGroupName " ResourceGroup11"

Cet exemple montre comment définir les paramètres de chiffrement de disque sur un disque de système d’exploitation de machine virtuelle.

Paramètres

-Caching

Spécifie le mode de mise en cache du disque du système d’exploitation. Les valeurs autorisées sont :

  • Lecture seule
  • ReadWrite La valeur par défaut est ReadWrite. La modification de la valeur de mise en cache entraîne le redémarrage de la machine virtuelle. Ce paramètre affecte les performances du disque.
Type:Nullable<T>[CachingTypes]
Valeurs acceptées:None, ReadOnly, ReadWrite
Position:3
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-CreateOption

Spécifie si cette applet de commande crée un disque dans la machine virtuelle à partir d’une plateforme ou d’une image utilisateur, ou attache un disque existant. Les valeurs autorisées sont :

  • Joindre. Spécifiez cette option pour créer une machine virtuelle à partir d’un disque spécialisé. Lorsque vous spécifiez cette option, ne spécifiez pas le paramètre SourceImageUri . Utilisez plutôt l’applet de commande Set-AzureRmVMSourceImage. Vous devez également utiliser les paramètres Windows ou Linux pour indiquer à la plateforme Azure le type du système d’exploitation sur le disque dur virtuel. Le paramètre VhdUri est suffisant pour indiquer à la plateforme Azure l’emplacement du disque à attacher.
  • FromImage. Spécifiez cette option pour créer une machine virtuelle à partir d’une image de plateforme ou d’une image utilisateur généralisée. Dans le cas d’une image utilisateur généralisée, vous devez également spécifier le paramètre SourceImageUri et les paramètres Windows ou Linux pour indiquer à la plateforme Azure l’emplacement et le type du disque dur virtuel du système d’exploitation au lieu d’utiliser l’applet de commande Set-AzureRmVMSourceImage . Dans le cas d’une image de plateforme, le paramètre VhdUri est suffisant.
  • Vide.
Type:String
Position:5
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
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: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

-DiffDiskSetting

Spécifie les paramètres de disque de différenciation pour le disque du système d’exploitation.

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

-DiskEncryptionKeyUrl

Spécifie l’emplacement de la clé de chiffrement de disque.

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

-DiskEncryptionKeyVaultId

Spécifie l’ID de ressource du coffre de clés contenant la clé de chiffrement de disque.

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

-DiskSizeInGB

Spécifie la taille, en Go, du disque du système d’exploitation.

Type:Nullable<T>[Int32]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-KeyEncryptionKeyUrl

Spécifie l’emplacement de la clé de chiffrement de clé.

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

-KeyEncryptionKeyVaultId

Spécifie l’ID de ressource du coffre de clés contenant la clé de chiffrement de clé.

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

-Linux

Indique que le système d’exploitation sur l’image utilisateur est Linux. Spécifiez ce paramètre pour le déploiement de machines virtuelles basées sur des images utilisateur.

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

-ManagedDiskId

Spécifie l’ID d’un 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

-Name

Spécifie le nom du disque du système d’exploitation.

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

-SourceImageUri

Spécifie l’URI du disque dur virtuel pour les scénarios d’image utilisateur.

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

-StorageAccountType

Spécifie le type de compte de stockage du 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

-VhdUri

Spécifie l’URI (Uniform Resource Identifier) d’un disque dur virtuel (VHD). Pour une machine virtuelle basée sur une image, ce paramètre spécifie le fichier de disque dur virtuel à créer lorsqu’une image de plateforme ou une image utilisateur est spécifiée. Il s’agit de l’emplacement à partir duquel l’objet blob (Image Binary Large Object) est copié pour démarrer la machine virtuelle. Pour un scénario de démarrage de machine virtuelle sur disque, ce paramètre spécifie le fichier de disque dur virtuel que la machine virtuelle utilise directement pour démarrer.

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

-VM

Spécifie l’objet de machine virtuelle locale sur lequel définir les propriétés du disque du système d’exploitation. Pour obtenir un objet de machine virtuelle, utilisez l’applet de commande Get-AzureRmVM.

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

-Windows

Indique que le système d’exploitation sur l’image utilisateur est Windows.

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

-WriteAccelerator

Spécifie si WriteAccelerator doit être activé ou désactivé sur le disque du système d’exploitation.

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

Paramètres : machine virtuelle (ByValue)

Sorties

PSVirtualMachine