|
|
 Data ONTAP® PowerShell Toolkit
|
Cmdlet: Start-NaVolMove
NAME
Start-NaVolMove
SYNOPSIS
Start-NaVolMove will move a single 7-mode flexvol between two aggregates on
the same controller.
SYNTAX
Start-NaVolMove [-Volume] <String> [-DestAggr] <String> [[-CutoverWindow] <I
nt32>] [[-CutoverAttempts] <Int32>] [-ManualCutover] [-KeepSource] [-Validat
eOnly] [-OverrideWarnings] [-Controller <NaController>] [<CommonParameters>]
DESCRIPTION
Start-NaVolMove will move a single 7-mode flexvol between two aggregates on
the same controller. It will run a series of checks to determine if the vol
ume can be moved. If any of the checks results in an error or warning, the A
PI will return with an error. The user has to take the necessary corrective
action before restarting the move. If all the checks pass, the API will retu
rn a success. If the ValidateOnly flag is not set, the destination volume wi
ll be created and the move will start. By default the move will cutover auto
matically. The status of the move can be obtained using Get-NaVolMove. If th
e ValidateOnly switch is set, all the errors and warnings encountered from t
he checks will be returned. The move will not be initiated. If the OverrideW
arnings switch is set and the checks return no errors but one or more warnin
gs, the move will start. If the move fails an EMS message will be generated
. The reason for the failure can be obtained from Get-NaVolMove. After a suc
cessful move, the source volume will be destroyed unless the user has set th
e KeepSource switch. If Cutover cannot be completed in the default or user s
pecified number of attempts, an EMS message will be printed and the move wil
l pause. The reason for the pause will be available in Get-NaVolMove. The us
er can either resume or abort the move.
PARAMETERS
-Volume <String>
Name of the volume that must be moved.
Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-DestAggr <String>
Name of the destination aggregate.
Required? true
Position? 2
Default value
Accept pipeline input? false
Accept wildcard characters? false
-CutoverWindow <Int32>
Time interval to complete cutover in seconds. Default value is 60 secon
ds.
Required? false
Position? 3
Default value 60
Accept pipeline input? false
Accept wildcard characters? false
-CutoverAttempts <Int32>
Number of cutover attempts. Default value is 3.
Required? false
Position? 4
Default value 3
Accept pipeline input? false
Accept wildcard characters? false
-ManualCutover
If specified, user has to initiate cutover.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-KeepSource
If specified, the source volume will not be destroyed after the move is
complete.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-ValidateOnly
Run pre-checks for the move, return all the errors and warning messages
encountered during the checks in the errors-warnings element and exit.
The move will not be triggered.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-OverrideWarnings
If warnings are encountered during the move, the default behavior is to
stop. If this is set, the move will continue and return these warnings
in the ErrorWarnings field.
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
<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
DataONTAP.Types.Volume.VolMoveStatus
NOTES
Category: volume
API: volume-move-start
-------------- Example 1 --------------
C:\PS>Start-NaVolMove vol1 aggr0_rre2 -ValidateOnly
Check if vol1 can be successfully moved to aggr0_rre2, but do not start the
move process.
SourceVolumeName : vol1
IsStarted : False
ErrorWarningCount : 0
ErrorWarnings : {}
MoveState :
-------------- Example 2 --------------
C:\PS>Start-NaVolMove vol1 aggr0_rre2
Move vol1 to aggr0_rre2.
SourceVolumeName : vol1
IsStarted : True
ErrorWarningCount : 0
ErrorWarnings : {}
MoveState : setup
RELATED LINKS
Stop-NaVolMove
Suspend-NaVolMove
| Copyright © 2013 NetApp. All rights reserved. Use is subject to license terms. |
|
Data ONTAP® PowerShell Toolkit
|