Add-AzureVhd

[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

Add-AzureVhd

Uploads a virtual hard disk (in .vhd file format) from an on-premises virtual machine to a blob in a cloud storage account in Windows Azure.

Parameter Set: Vhd
Add-AzureVhd [-Destination] <Uri> [-LocalFilePath] <FileInfo> [[-NumberOfUploaderThreads] <Int32> ] [[-BaseImageUriToPatch] <Uri> ] [[-OverWrite]] [ <CommonParameters>]

This topic describes the cmdlet in the .6.19 version of the Windows Azure PowerShell module. To find out the version of the module you're using, from the Windows Azure PowerShell console, type (get-module azure).version.

The Add-AzureVhd cmdlet allows you to upload on-premises virtual hard disks (in .vhd file format) to a blob storage account as fixed virtual hard disks. You can configure the number of uploader threads that will be used or overwrite an existing blob in the specified destination URI. 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 as well.

-BaseImageUriToPatch<Uri>

Specifies the URI to a base image blob in Windows Azure Blob Storage. A shared access signature (SAS) can be specified as the value for this parameter.

-Destination<Uri>

-LocalFilePath<FileInfo>

Specifies the path to the local .vhd file.

-NumberOfUploaderThreads<Int32>

Determines the number of uploader threads to be used when uploading the .vhd file.

-OverWrite

If enabled, overwrites an existing blob in the specified destination URI, if one exists.

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see  about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Example 1: Use a destination URI to upload to a specified blob

This example uses a destination URI to a specific blob to upload a .vhd file to the blob.

PS C:\> Add-AzureVhd -Destination https://mytestaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd -LocalFilePath C:\vhd\MyWin7Image.vhd

Example 2: Use a SAS signature for the destination

This example uses a SAS signature in the query string of the URI to specify the destination. The SAS signature should have Read, Write, and Delete permissions.

C:\PS>Add-AzureVhd  -Destination "https://mytestaccount.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%2FaP3HhKKJ6AY093SmveOSIV4%2FR7w%3D" -LocalFilePath C:\vhd\win7baseimage.vhd

Example 3: Overwrite an existing blob during upload

This example uploads a .vhd file and also overwrites any existing blob in the specified destination UIR.

C:\PS>Add-AzureVhd -Destination https://mytestaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd -LocalFilePath C:\vhd\MyWin7Image.vhd -Overwrite

Example 4: Specify the number of uploader threads

This example uploads a .vhd file and specifies the number of uploader threads.

C:\PS>Add-AzureVhd -Destination https://mytestaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd -LocalFilePath C:\vhd\MyWin7Image.vhd -NumberOfUploaderThreads 32

Related topics

Add-AzureDataDisk

Update-AzureVM

Update-AzureVMImage

Manage Disks and Images