Add-AzVhd

Add-AzVhd
    [-ResourceGroupName] <String>
    [-Destination] <Uri>
    [-LocalFilePath] <FileInfo>
    [[-NumberOfUploaderThreads] <Int32>]
    [[-BaseImageUriToPatch] <Uri>]
    [-OverWrite]
    [-SkipResizing]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

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

The Add-AzVhd cmdlet uploads an on-premise virtual hard disk to a managed disk or a blob storage account.

The virtual hard disk being uploaded needs to be a .vhd file and in size N * Mib + 512 bytes. Using Hyper-V functionality, Add-AzVhd will convert any .vhdx file to a .vhd file and resize before uploading. To allow this functionality, you will need to enable Hyper-V. If you are using a Linux machine or choose to not use this functionality, you will need to resize the VHD file manually. Additionally, Add-AzVhd will convert dynamically sized VHD files to fixed size during upload. Use -Verbose to follow all the process.

For Default Parameter set (upload to blob), also supported is the ability to upload a patched version of an on-premises .vhd file. When a base virtual hard disk has already been uploaded, you can upload differencing disks that use the base image as the parent. Shared access signature (SAS) URI is supported also.

For Direct Upload to Managed Disk Parameter set, parameters: ResourceGroupName, DiskName, Location, DiskSku, and Zone will be used to create a new disk, then the virtual hard disk will be uploaded to it.

More information on using Add-AzVhd to directly upload to a managed disk.

For VHD files greater than 50 GB, we recommend using AzCopy for faster upload.

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

This command adds a .vhd file to a storage account.

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

This command adds a .vhd file to a storage account. The command overwrites an existing file.

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

This command adds a .vhd file to a storage account. The command specifies the number of threads to use to upload the file.

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"

This command adds a .vhd file to a storage account and specifies the SAS URI.

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

This command create a managed disk with given ResourceGroupName, Location, and DiskName; and uploads the VHD file to it.

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

This command will tried to convert vhdx file to vhd file first using Hyper-V. If Hyper-V is not found, it will return an error asking to use a vhd file. After successful conversion, it will create a managed disk with provided parameters, then upload the vhd file.

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.