Convert-IscsiVirtualDisk
Converts an iSCSI virtual disk to a 4K sector aligned advanced virtual disk 1.0 format.
Syntax
Default (Default)
Convert-IscsiVirtualDisk
[-Path] <String>
[-DestinationPath] <String>
[<CommonParameters>]
Description
Note: This cmdlet is deprecated and might be removed in a future release. We recommend that you do not use this cmdlet.
The Convert-IscsiVirtualDisk cmdlet converts an iSCSI virtual disk to a 4K sector aligned advanced virtual disk 1.0 format. If an attempt is made to load a VHD created by the iSCSI Target 3.3, 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 R2 differencing virtual disks.
Examples
Example 1: Convert a VHD
PS C:\> Convert-IscsiVirtualDisk -Path "\\zamfirsvr\VHDs\test.vhdx" -DestinationPath "\\win8svr\VHDs\test.vhdx"
This example copies and converts the VHD named test.vhdx from \\zamfirsvr\VHDs\ to \\win8svr\VHDs. The VHD named test.vhdx can be loaded after the conversion.
Parameters
-DestinationPath
Specifies the destination path of the iSCSI virtual disk path of which to be copied and converted.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 1 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Path
Specifies the path of the virtual hard disk (VHD) file that is associated with the iSCSI virtual disk. Filter the iSCSI Virtual Disk object by using this parameter.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | DevicePath |
Parameter sets
(All)
| Position: | 0 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
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.