|
|
 Data ONTAP® PowerShell Toolkit
|
Cmdlet: Invoke-NaSnapmirrorUpdate
NAME
Invoke-NaSnapmirrorUpdate
SYNOPSIS
Starts a transfer over the network for a specific destination.
SYNTAX
Invoke-NaSnapmirrorUpdate [-Destination] <String> [[-Source] <String>] [-Max
TransferRate <Int64>] [-SourceSnapshot <String>] [-DestinationSnapshot <Stri
ng>] [-Controller <NaController>] [<CommonParameters>]
DESCRIPTION
Starts a transfer over the network for a specific destination. The update is
asynchronously handled, and there is no guarantee that it succeeds. The sn
apmirror-get-status API can be used to check the status of the update. The
API must be issued on the destination filer.
PARAMETERS
-Destination <String>
The destination location of the update transfer. The destination locati
on is of the volume form: <filer>:<volume> or the qtree form: <filer>:/v
ol/<volume>/<qtree>. The <filer> must match the destination filer. If th
e destination-location is in the volume form, the volume must be in the
restricted state. If the destination-location is the qtree form, the qt
ree must not already exist.
Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-Source <String>
The source location of the update transfer. The source location is of t
he volume form: <filer>:<volume> or the qtree form: <filer>:/vol/<volume
>/<qtree>. If the source-location is not specified, then the source in /
etc/snapmirror.conf for the destination path is used.
Required? false
Position? 2
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-MaxTransferRate <Int64>
Maximum transfer rate in bytes per second. The default is as fast as th
e filer can transfer.
Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-SourceSnapshot <String>
Designates which source snapshot to use for a qtree update. The default
creates new snapshot on the source for the transfer.
Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-DestinationSnapshot <String>
Creates the specified snapshot (in addition to the regular SnapMirror sn
apshot) on the destination after the qtree SnapMirror transfer is over.
Required? false
Position? named
Default value
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
<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.Snapmirror.SnapmirrorStatusInfo
NOTES
Category: snapmirror
API: snapmirror-update
-------------- Example 1 --------------
C:\PS>Get-NaSnapmirror | Invoke-NaSnapmirrorUpdate
Update all Snapmirrors.
BaseSnapshot : benson(0118045471)_dunn_vol2_mirror.1
Contents : Replica
CurrentTransferError :
CurrentTransferType : update
DestinationLocation : benson:dunn_vol2_mirror
LagTime : 1531
LagTimeTS : 00:25:31
LastTransferDuration : 1361
LastTransferDurationTS : 00:22:41
LastTransferFrom : dunn:vol2
LastTransferSize : 88574156800
LastTransferType : initialize
MirrorTimestamp : 1280785625
MirrorTimestampDT : 8/2/2010 9:47:05 PM
SourceLocation : dunn:vol2
State : snapmirrored
Status : transferring
TransferProgress : 0
RELATED LINKS
Invoke-NaSnapmirrorInitialize
| Copyright © 2013 NetApp. All rights reserved. Use is subject to license terms. |
|
Data ONTAP® PowerShell Toolkit
|