Data ONTAP® PowerShell Toolkit

Switch to Data ONTAP Cluster-mode documentation.

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 <NaController>] [-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.

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.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Controller <NaController>
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

-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







 Data ONTAP® PowerShell Toolkit