Convert-IscsiVirtualDisk

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

Convert-IscsiVirtualDisk

Converts an iSCSI virtual disk to a Generation one Advanced Format-aligned (4K sector technology) virtual disk.

Syntax

Parameter Set: Default
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® “8” Beta, 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 “8” Beta 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

none

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

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