|
|
 Data ONTAP® PowerShell Toolkit
|
Cmdlet: Repair-NaVirtualDiskAlignment
NAME
Repair-NaVirtualDiskAlignment
SYNOPSIS
Perform an alignment operation on a misaligned virtual hard disk file. If t
he virtual hard disk file contains only aligned partitions the cmdlet will d
o nothing.
SYNTAX
Repair-NaVirtualDiskAlignment [-VirtualDisk] <String> [-ForceHostCopy] [-Con
troller <AbstractController>] [<CommonParameters>]
DESCRIPTION
Perform an alignment operation on a misaligned virtual hard disk file. If t
he virtual hard disk file contains only aligned partitions the cmdlet will d
o nothing. This cmdlet can align VHD and VHDX format virtual disks.
The virtual disk must be an MBR disk residing on a Data ONTAP LUN or Data ON
TAP CIFS share. Virtual disks inside a Data ONTAP volume not visible to the
host are supported (accessed using a /vol/<volname>/<path> path).
When possible, the cmdlet will use Data ONTAP to offload the alignment opera
tion. The cmdlet will prompt for confirmation when a host-based copy is goi
ng to be used. The switch, ForceHostCopy, can be used to force the cmdlet t
o use a host-based copy. A host-based copy will use SCSI XCOPY when availab
le, otherwise data will be copied from the source to the host, then from the
host to the destination.
If the virtual hard disk file contains partitions that are already aligned,
a cloning operation will be used to move the partition into the aligned virt
ual disk. The ForceHostCopy switch disables this behavior.
The cmdlet backs up the virtual hard disk file with the original name plus t
he extension ".bkup"
PARAMETERS
-VirtualDisk <String>
Path to the virtual hard disk. This can be a fully-qualified Windows pa
th or a path to a file inside a Data ONTAP volume (/vol/<volname>/<path>
). If the path is to a file inside a Data ONTAP volume an NaController
must be specified using the Controller parameter or must be present in $
global:CurrentNaController.
Required? true
Position? 1
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-ForceHostCopy
If specified, the cmdlet will use a host based copy operation to perform
the alignment. A host-based copy will use SCSI XCOPY when available, o
therwise data will be copied from the source to the host, then from the
host to the destination.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Controller <AbstractController>
The Data ONTAP controller object, embodied by an NaController object. T
his parameter is returned by the Connect-NaController cmdlet. If not sp
ecified, the value in the global variable CurrentNaController is used.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".
INPUTS
OUTPUTS
System.IO.FileInfo
NOTES
Category: host
-------------- Example 1 --------------
C:\PS>Repair-NaVirtualDiskAlignment E:\misaligned.vhd
Align the partitions for the virtual hard disk file.
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a--- 1/5/2012 12:21 PM 10737418752 misaligned.vhd
-------------- Example 2 --------------
C:\PS>Repair-NaVirtualDiskAlignment C:\ClusterStorage\Volume2\VirtualDisks\W
in2k3_VM1\win2k3-boot.vhdx
Align the given VHDX format virtual disk.
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a--- 1/5/2012 12:21 PM 21487419392 win2k3-boot.vhdx
RELATED LINKS
Get-NaVirtualDiskAlignment
| Copyright © 2013 NetApp. All rights reserved. Use is subject to license terms. |
|
Data ONTAP® PowerShell Toolkit
|