Convert-IscsiVirtualDisk
Convert-IscsiVirtualDisk
Converts an iSCSI virtual disk to a Generation one Advanced Format-aligned (4K sector technology) virtual disk.
Syntax
Parameter Set: __AllParameterSets
Convert-IscsiVirtualDisk [-Path] <String> [-DestinationPath] <String> [ <CommonParameters>]
Detailed Description
The Convert-IscsiVirtualDisk cmdlet converts an iSCSI virtual disk to a Generation one Advanced Format-aligned (4K sector technology) virtual disk. If an attempt is made to load a VHD created by the previous version of the iSCSI Target in Windows Server® 2012, then the VHD must be converted by running this cmdlet. This cmdlet performs copy and conversion at the same time. A remote file share or local path for both source and destination path can be specified.
Note: Use this cmdlet if iSCSI Target 3.3 differencing virtual disks are migrated to Windows Server 2012 differencing virtual disks.
Parameters
-DestinationPath<String>
Specifies the destination path of the iSCSI virtual disk path to which to be copied and converted.
Aliases |
none |
Required? |
true |
Position? |
2 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Path<String>
Specifies the path of the virtual hard disk (VHD) file that is associated with the iSCSI virtual disk.
Filter the iSCSI Virtual Disk object using this parameter.
Aliases |
DevicePath |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
<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.
- None
Outputs
The output type is the type of the objects that the cmdlet emits.
- None
Examples
EXAMPLE 1
This example copies and converts the VHD namedtest.vhd from \\zamfirsvr\VHDs\ to \\win8svr\VHDs. The VHD named test.vhd can be loaded after the conversion.
PS C:\> Convert-IscsiVirtualDisk -Path \\zamfirsvr\VHDs\test.vhd -DestinationPath \\win8svr\VHDs\test.vhd