|
|
 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> [-Controller <Abstract
Controller>] [-ForceHostCopy] [-WhatIf] [-Confirm] [<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.
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.
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
-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
-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
-WhatIf
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Confirm
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
RELATED LINKS
Get-NaVirtualDiskAlignment
| Copyright © 2012 NetApp. All rights reserved. Use is subject to license terms. |
|
Data ONTAP® PowerShell Toolkit
|