Table of contents
TLS
TOC
Collapse the table of content
Expand the table of content

Convert-IscsiVirtualDisk

Last Updated: 3/8/2017

SYNOPSIS

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

SYNTAX

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.

Type: String
Parameter Sets: (All)
Aliases: 

Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: 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.

Type: String
Parameter Sets: (All)
Aliases: DevicePath

Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

None

OUTPUTS

None

NOTES

Checkpoint-IscsiVirtualDisk

Get-IscsiVirtualDisk

Import-IscsiVirtualDisk

New-IscsiVirtualDisk

Remove-IscsiVirtualDisk

Restore-IscsiVirtualDisk

Set-IscsiVirtualDisk

© 2017 Microsoft