|
|
 Data ONTAP® PowerShell Toolkit
|
Cmdlet: Start-NaSnapvaultSecTransfer
NAME
Start-NaSnapvaultSecTransfer
SYNOPSIS
Request the snapvault secondary system to begin an incremental transfer to t
he given secondary path.
SYNTAX
Start-NaSnapvaultSecTransfer [-SecondaryPath] <String> [-MaxTransferRate <In
t64>] [-PrimarySnapshot <String>] [-NoLunCloneExpansion [<Boolean>]] [-Contr
oller <NaController>] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Request the snapvault secondary system to begin an incremental transfer to t
he given secondary path. This API is equivalent to the 'snapvault update' D
ata ONTAP command. It is required that this secondary path has already been
configured as part of a snapvault relationship. The primary system and pat
h configured in that relationship will be used as the source for this transf
er. The request will only start the transfer and return. The actual transf
er will proceed asynchronously and there is no guarantee that it will succee
d. The Get-NaSnapvaultSecStatus cmdlet should be used to check the status o
f the update.
PARAMETERS
-SecondaryPath <String>
The secondary path that will be used as the destination for this update
transfer. It is required that this secondary path is already a part of
some configured snapvault relationship.
Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-MaxTransferRate <Int64>
The maximum transfer rate in bytes per second to be applied only for thi
s update transfer. If this option is not provided the default behavior
will be to allow the transfer to proceed as fast as possible. Range:[1..
2^31-2]
Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-PrimarySnapshot <String>
Name of the primary snapshot to be used for this update transfer. This
option is supported for only primary systems. If this option is not pro
vided, the primary system will create a new source snapshot for this tra
nsfer.
Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-NoLunCloneExpansion [<Boolean>]
This option dictates how a LUN clone would be transferred from source to
destination. If this option is "false", a LUN clone would be transferr
ed as a LUN and if it is "true", it will be transferred as a clone. By
default the value of the option is "false".
Required? false
Position? named
Default value false
Accept pipeline input? true (ByPropertyName)
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
NOTES
Category: snapvault
API: snapvault-secondary-initiate-incremental-transfer
-------------- Example 1 --------------
C:\PS>Start-NaSnapvaultSecTransfer /vol/vol0/svsec
Start an incremental transfer to secondary path '/vol/vol0/svsec' on the cur
rent controller.
RELATED LINKS
Stop-NaSnapvaultSecTransfer
Get-NaSnapvaultSecStatus
| Copyright © 2012 NetApp. All rights reserved. Use is subject to license terms. |
|
Data ONTAP® PowerShell Toolkit
|