Set-AzureRmVMOSDisk
Establece las propiedades del disco del sistema operativo en una máquina virtual.
Advertencia
El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.
Aunque el módulo AzureRM puede seguir funcionando, ya no se mantiene ni se admite, colocando cualquier uso continuado a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.
Syntax
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
El cmdlet Set-AzureRmVMOSDisk establece las propiedades del disco del sistema operativo en una máquina virtual.
Ejemplos
Ejemplo 1: Establecimiento de propiedades en una máquina virtual desde la imagen de la plataforma
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"
El primer comando obtiene el conjunto de disponibilidad denominado AvailablitySet13 en el grupo de recursos denominado ResourceGroup11 y, a continuación, almacena ese objeto en la variable $AvailabilitySet. El segundo comando crea un objeto de máquina virtual y, a continuación, lo almacena en la variable $VirtualMachine. El comando asigna un nombre y un tamaño a la máquina virtual. La máquina virtual pertenece al conjunto de disponibilidad almacenado en $AvailabilitySet. El comando final establece las propiedades de la máquina virtual en $VirtualMachine.
Ejemplo 2: establece las propiedades de una máquina virtual de la imagen de usuario generalizada
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"
El primer comando obtiene el conjunto de disponibilidad denominado AvailablitySet13 en el grupo de recursos denominado ResourceGroup11 y almacena ese objeto en la variable $AvailabilitySet. El segundo comando crea un objeto de máquina virtual y lo almacena en la variable $VirtualMachine. El comando asigna un nombre y un tamaño a la máquina virtual. La máquina virtual pertenece al conjunto de disponibilidad almacenado en $AvailabilitySet. El comando final establece las propiedades de la máquina virtual en $VirtualMachine.
Ejemplo 3: Establece las propiedades de una máquina virtual a partir de una imagen de usuario especializada
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"
El primer comando obtiene el conjunto de disponibilidad denominado AvailablitySet13 en el grupo de recursos denominado ResourceGroup11 y almacena ese objeto en la variable $AvailabilitySet. El segundo comando crea un objeto de máquina virtual y lo almacena en la variable $VirtualMachine. El comando asigna un nombre y un tamaño a la máquina virtual. La máquina virtual pertenece al conjunto de disponibilidad almacenado en $AvailabilitySet. El comando final establece las propiedades de la máquina virtual en $VirtualMachine.
Ejemplo 4: Establecimiento de la configuración de cifrado de disco en un disco del sistema operativo de máquina virtual
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"
En este ejemplo se establece la configuración de cifrado de disco en un disco del sistema operativo de máquina virtual.
Parámetros
-Caching
Especifica el modo de almacenamiento en caché del disco del sistema operativo. Los valores válidos son:
- ReadOnly
- ReadWrite El valor predeterminado es ReadWrite. Cambiar el valor de almacenamiento en caché hace que la máquina virtual se reinicie. Esta configuración afecta al rendimiento del disco.
Tipo: | Nullable<T>[CachingTypes] |
valores aceptados: | None, ReadOnly, ReadWrite |
Position: | 3 |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CreateOption
Especifica si este cmdlet crea un disco en la máquina virtual a partir de una imagen de usuario o plataforma, o conecta un disco existente. Los valores válidos son:
- Adjuntar. Especifique esta opción para crear una máquina virtual a partir de un disco especializado. Al especificar esta opción, no especifique el parámetro SourceImageUri . En su lugar, use el cmdlet Set-AzureRmVMSourceImage. También debe usar los parámetros de Windows o Linux para indicar a la plataforma azure el tipo del sistema operativo en el disco duro virtual. El parámetro VhdUri es suficiente para indicar a la plataforma azure la ubicación del disco que se va a conectar.
- FromImage. Especifique esta opción para crear una máquina virtual a partir de una imagen de plataforma o una imagen de usuario generalizada. En el caso de una imagen de usuario generalizada, también debe especificar el parámetro SourceImageUri y los parámetros de Windows o Linux para indicar a la plataforma Azure la ubicación y el tipo del VHD del disco del sistema operativo en lugar de usar el cmdlet Set-AzureRmVMSourceImage . En el caso de una imagen de plataforma, el parámetro VhdUri es suficiente.
- Vacía.
Tipo: | String |
Position: | 5 |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.
Tipo: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DiffDiskSetting
Especifica la configuración de disco de diferenciación para el disco del sistema operativo.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DiskEncryptionKeyUrl
Especifica la ubicación de la clave de cifrado de disco.
Tipo: | String |
Position: | 7 |
valor predeterminado: | None |
Requerido: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DiskEncryptionKeyVaultId
Especifica el identificador de recurso de Key Vault que contiene la clave de cifrado de disco.
Tipo: | String |
Position: | 8 |
valor predeterminado: | None |
Requerido: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DiskSizeInGB
Especifica el tamaño, en GB, del disco del sistema operativo.
Tipo: | Nullable<T>[Int32] |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-KeyEncryptionKeyUrl
Especifica la ubicación de la clave de cifrado de claves.
Tipo: | String |
Position: | 9 |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-KeyEncryptionKeyVaultId
Especifica el identificador de recurso del almacén de claves que contiene la clave de cifrado de claves.
Tipo: | String |
Position: | 10 |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Linux
Indica que el sistema operativo de la imagen de usuario es Linux. Especifique este parámetro para la implementación de máquinas virtuales basadas en imágenes de usuario.
Tipo: | SwitchParameter |
Position: | 6 |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ManagedDiskId
Especifica el identificador de un disco administrado.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Especifica el nombre del disco del sistema operativo.
Tipo: | String |
Aliases: | OSDiskName, DiskName |
Position: | 1 |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SourceImageUri
Especifica el URI del disco duro virtual para escenarios de imagen de usuario.
Tipo: | String |
Aliases: | SourceImage |
Position: | 4 |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StorageAccountType
Especifica el tipo de cuenta de almacenamiento del disco administrado.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VhdUri
Especifica el identificador uniforme de recursos (URI) de un disco duro virtual (VHD). Para una máquina virtual basada en imágenes, este parámetro especifica el archivo VHD que se va a crear cuando se especifica una imagen de plataforma o una imagen de usuario. Esta es la ubicación desde la que se copia el objeto binario binario de imagen (BLOB) para iniciar la máquina virtual. Para un escenario de arranque de máquina virtual basado en disco, este parámetro especifica el archivo VHD que la máquina virtual usa directamente para iniciarse.
Tipo: | String |
Aliases: | OSDiskVhdUri, DiskVhdUri |
Position: | 2 |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VM
Especifica el objeto de máquina virtual local en el que se van a establecer las propiedades del disco del sistema operativo. Para obtener un objeto de máquina virtual, use el cmdlet Get-AzureRmVM.
Tipo: | PSVirtualMachine |
Aliases: | VMProfile |
Position: | 0 |
valor predeterminado: | None |
Requerido: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Windows
Indica que el sistema operativo de la imagen de usuario es Windows.
Tipo: | SwitchParameter |
Position: | 6 |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WriteAccelerator
Especifica si WriteAccelerator debe estar habilitado o deshabilitado en el disco del sistema operativo.
Tipo: | SwitchParameter |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Parámetros: VM (ByValue)