Convert VHD to New VHD File
Converts a virtual hard disk file by copying the data from a source virtual hard disk file to a new virtual hard disk file of a specified format and version type. The format is determined by the file extension of the specified files, either .vhdx or .vhd. Conversion is an offline operation; the virtual hard disk must not be attached when the operation is started.
Input Parameters
| VHD File Path |
String |
Yes |
Specifies the path to the virtual hard disk file to be converted. If a file name or relative path is specified, the path of the converted hard disk path is calculated relative to the current working directory |
| Parent VHD File Path |
String |
No |
Specifies the parent path for the destination-differencing virtual hard disk file. |
| New VHD File Path |
String |
Yes |
Specifies the path to the converted virtual hard disk file. |
| Convert to VHDX |
Boolean |
No |
Optionally, you can convert a VHD file to VHDX. |
| Delete Source |
Boolean |
No |
Optionally, you can delete a source VHD file. |
| File Block Size |
String |
No |
Specifies the block size, in bytes, of the virtual hard disk after conversion. |
Output Parameters
| Result |
Number |
Returns a success value of zero or any value other than zero to indicate failure. |
Example Input Parameters
| VHD File Path |
String |
Yes |
c:\test\childvhdx.vhdx |
| Parent VHD File Path |
String |
No |
c:\test\parentvhd.vhd |
| New VHD File Path |
String |
Yes |
c:\test\child1vhd.vhd |
| Convert to VHDX |
Boolean |
No |
Optionally, you can convert a VHD file to VHDX. |
| Delete Source |
Boolean |
No |
Optionally, you can delete a source VHD file. |
| File Block Size |
String |
No |
33554432 |
