Export (0) Print
Expand All

Convert-IscsiVirtualDisk

Windows Server 2012 R2 and Windows 8.1

Updated: October 17, 2013

Applies To: Windows 8.1, Windows PowerShell 4.0, Windows Server 2012 R2

Convert-IscsiVirtualDisk

Converts an iSCSI virtual disk to a 4K sector aligned advanced virtual disk 1.0 format.

Syntax

Parameter Set: Default
Convert-IscsiVirtualDisk [-Path] <String> [-DestinationPath] <String> [ <CommonParameters>]




Detailed 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, 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 R2 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.

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.vhdx from \\zamfirsvr\VHDs\ to \\win8svr\VHDs. The VHD named test.vhdx can be loaded after the conversion.


PS C:\> Convert-IscsiVirtualDisk -Path \\zamfirsvr\VHDs\test.vhdx -DestinationPath \\win8svr\VHDs\test.vhdx

Related topics

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft