Add-AzVhd

  • Referencia
Módulo:
Az.Compute

Carga un disco duro virtual desde una máquina local en Azure (disco administrado o blob).

Syntax

Add-AzVhd
   [-ResourceGroupName] <String>
   [-Destination] <Uri>
   [-LocalFilePath] <FileInfo>
   [[-NumberOfUploaderThreads] <Int32>]
   [[-BaseImageUriToPatch] <Uri>]
   [-OverWrite]
   [-SkipResizing]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzVhd
   [-ResourceGroupName] <String>
   [-LocalFilePath] <FileInfo>
   -DiskName <String>
   [-Location] <String>
   [-DiskSku <String>]
   [-DiskZone <String[]>]
   [-DiskHyperVGeneration <String>]
   [-DiskOsType <OperatingSystemTypes>]
   [[-NumberOfUploaderThreads] <Int32>]
   [-DataAccessAuthMode <String>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

El cmdlet Add-AzVhd carga un disco duro virtual local en un disco administrado o una cuenta de almacenamiento de blobs.

El disco duro virtual que se carga debe ser un archivo .vhd y de tamaño N * Mib + 512 bytes. Con la funcionalidad de Hyper-V , Add-AzVhd convertirá cualquier archivo .vhdx en un archivo .vhd y cambiará el tamaño antes de cargarlo. Para permitir esta funcionalidad, deberá habilitar Hyper-V. Si usa una máquina Linux o decide no usar esta funcionalidad, deberá cambiar el tamaño del archivo VHD manualmente. Además, Add-AzVhd convertirá archivos VHD de tamaño dinámico a tamaño fijo durante la carga. Use -Verbose para seguir todo el proceso.

Para el conjunto de parámetros predeterminados (carga en blob), también se admite la capacidad de cargar una versión revisada de un archivo .vhd local. Cuando ya se ha cargado un disco duro virtual base, puede cargar discos de diferenciación que usan la imagen base como elemento primario. También se admite el URI de firma de acceso compartido (SAS).

Para el conjunto de parámetros de carga directa en disco administrado, los parámetros: ResourceGroupName, DiskName, Location, DiskSku y Zone se usarán para crear un nuevo disco y, a continuación, el disco duro virtual se cargará en él.

Más información sobre el uso de Add-AzVhd para cargar directamente en un disco administrado.

En el caso de los archivos VHD mayores de 50 GB, se recomienda usar AzCopy para una carga más rápida.

Ejemplos

Ejemplo 1: Agregar un archivo VHD a un blob

Add-AzVhd -Destination "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd"

Este comando agrega un archivo .vhd a una cuenta de almacenamiento.

Ejemplo 2: Agregar un archivo VHD a un blob y sobrescribir el destino

Add-AzVhd -Destination "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -Overwrite

Este comando agrega un archivo .vhd a una cuenta de almacenamiento. El comando sobrescribe un archivo existente.

Ejemplo 3: Agregar un archivo VHD a un blob con el número de subprocesos especificados

Add-AzVhd -Destination "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -NumberOfUploaderThreads 32

Este comando agrega un archivo .vhd a una cuenta de almacenamiento. El comando especifica el número de subprocesos que se van a usar para cargar el archivo.

Ejemplo 4: Agregar un archivo VHD a un blob y especificar el URI de SAS

Add-AzVhd -Destination "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd?st=2013-01 -09T22%3A15%3A49Z&se=2013-01-09T23%3A10%3A49Z&sr=b&sp=w&sig=13T9Ow%2FRJAMmhfO%2FaP3HhKKJ6AY093SmveO SIV4%2FR7w%3D" -LocalFilePath "C:\vhd\win7baseimage.vhd"

Este comando agrega un archivo .vhd a una cuenta de almacenamiento y especifica el URI de SAS.

Ejemplo 5: Agregar un archivo VHD directamente a un disco administrado.

Add-AzVhd -LocalFilePath C:\data.vhd -ResourceGroupName rgname -Location eastus -DiskName newDisk

Este comando crea un disco administrado con resourceGroupName, Location y DiskName especificados; y carga el archivo VHD en él.

Ejemplo 6: Agregar un archivo VHD directamente a un disco más configurado.

Add-AzVhd -LocalFilePath C:\Data.vhdx -ResourceGroupName rgname -Location eastus -DiskName newDisk -Zone 1 -DiskSku Premium_LRS

Este comando intentará convertir primero el archivo vhdx al archivo vhd mediante Hyper-V. Si no se encuentra Hyper-V, devolverá un error al pedir que use un archivo vhd. Después de la conversión correcta, creará un disco administrado con parámetros proporcionados y, a continuación, cargará el archivo vhd.

Parámetros

-AsJob

Ejecute el cmdlet en segundo plano y devuelva un trabajo para realizar un seguimiento del progreso.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BaseImageUriToPatch

Especifica el URI en un blob de imagen base en Azure Blob Storage. Se puede especificar una SAS como valor para este parámetro.

Type:Uri
Aliases:bs
Position:4
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DataAccessAuthMode

Requisitos de autenticación adicionales al exportar o cargar en un disco o instantánea. Las opciones posibles son: "AzureActiveDirectory" y "None".

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Destination

Especifica el URI de un blob en Blob Storage. El parámetro admite el URI de SAS, aunque el destino de escenarios de aplicación de revisiones no puede ser un URI de SAS.

Type:Uri
Aliases:dst
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DiskHyperVGeneration

Generación del hipervisor de la máquina virtual. Solo se aplica a los discos del sistema operativo. Los valores posibles son: "V1", "V2".

Type:String
Aliases:HyperVGeneration
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DiskName

Nombre del nuevo disco administrado

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DiskOsType

El tipo de sistema operativo del disco administrado. Los valores posibles son: "Windows", "Linux".

Type:OperatingSystemTypes
Aliases:OsType
Accepted values:Windows, Linux
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DiskSku

SKU para disco administrado. Opciones: Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DiskZone

Lista de zonas lógicas para Disco.

Type:String[]
Aliases:Zone
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-LocalFilePath

Especifica la ruta de acceso del archivo .vhd local.

Type:FileInfo
Aliases:lf
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Location

Ubicación del nuevo disco administrado

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

-NumberOfUploaderThreads

Especifica el número de subprocesos del cargador que se van a usar al cargar el archivo .vhd.

Type:Nullable<T>[Int32]
Aliases:th
Position:3
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OverWrite

Indica que este cmdlet sobrescribe un blob existente en el URI de destino especificado, si existe alguno.

Type:SwitchParameter
Aliases:o
Position:5
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Especifica el nombre del grupo de recursos de la máquina virtual.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SkipResizing

Omite el cambio de tamaño del archivo VHD. Los usuarios que desean cargar un archivo VHD con su tamaño mal alineado (no N * Mib + 512 bytes) en un blob pueden usar este parámetro de modificador.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

String

Uri

FileInfo

Nullable<T>[[System.Int32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

SwitchParameter

Salidas

VhdUploadContext