|
|
 Data ONTAP® PowerShell Toolkit
|
Cmdlet: Invoke-NaNdmpCopy
NAME
Invoke-NaNdmpCopy
SYNOPSIS
Copy content between controllers using NDMP.
SYNTAX
Invoke-NaNdmpCopy [-SrcController] <IPAddress> [-SrcPath] <String> [[-DstCon
troller] <IPAddress>] [-DstPath] <String> [-SrcCredential <PSCredential>] [-
DstCredential <PSCredential>] [-SrcAuthType <NdmpMessageAuthType>] [-DstAuth
Type <NdmpMessageAuthType>] [-SrcPort <Int32>] [-DstPort <Int32>] [-Version
<Int16>] [-Exclude <String>] [-Level <Int32>] [-UseIpv6] [<CommonParameters>
]
Invoke-NaNdmpCopy [-SrcController] <IPAddress> [-SrcPath] <String> [[-DstCon
troller] <IPAddress>] [-DstPath] <String> [-SrcCredential <PSCredential>] [-
DstCredential <PSCredential>] [-SrcAuthType <NdmpMessageAuthType>] [-DstAuth
Type <NdmpMessageAuthType>] [-SrcPort <Int32>] [-DstPort <Int32>] [-Version
<Int16>] [-Exclude <String>] -IncrementalForever [-UseIpv6] [<CommonParamete
rs>]
DESCRIPTION
Copy content between controllers using NDMP. The operation runs synchronous
ly; the cmdlet will return when the operation is finished. To start an asyn
chronous NDMP copy operation, use Start-NaNdmpCopy.
PARAMETERS
-SrcController <IPAddress>
IP address of the source controller. For controllers operating in Clust
er-Mode, this must be an IP of the node hosting the volume containing th
e content to be copied.
Required? true
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false
-SrcPath <String>
Absolute path of the source directory to transfer. For a controller ope
rating in 7-mode, must start with /vol/<volname>. For a controller oper
ating in Cluster-Mode, must start with /<vserver>/<volname>.
Required? true
Position? 2
Default value
Accept pipeline input? false
Accept wildcard characters? false
-DstController <IPAddress>
IP address of the destination controller. For controllers operating in
Cluster-Mode, this must be an IP of the node hosting the destination vol
ume.
If not specified, the SrcController is used as the destination.
Required? false
Position? 3
Default value
Accept pipeline input? false
Accept wildcard characters? false
-DstPath <String>
Absolute path of the destination directory. If it does not exist, it wi
ll be created. For a controller operating in 7-mode, must start with /v
ol/<volname>. For a controller operating in Cluster-Mode, must start wi
th /<vserver>/<volname>.
Required? true
Position? 4
Default value
Accept pipeline input? false
Accept wildcard characters? false
-SrcCredential <PSCredential>
Credential to use to authenticate connection to source controller. For
controllers operating in Cluster-Mode, credentials are configured using
the CLI command "system services ndmp password". If not supplied and th
e SrcAuthType is not None, the credentials cache will be consulted. If
no credentials are found, the cmdlet will fail.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-DstCredential <PSCredential>
Credential to use to authenticate connection to destination controller.
For controllers operating in Cluster-Mode, credentials are configured u
sing the CLI command "system services ndmp password". If not supplied a
nd the DstAuthType is not None, the credentials cache will be consulted.
If no credentials are found, the cmdlet will fail.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-SrcAuthType <NdmpMessageAuthType>
Authentication type to use when authenticating connection to source cont
roller. Possible values: text, md5, none. Default is none.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-DstAuthType <NdmpMessageAuthType>
Authentication type to use when authenticating connection to destination
controller. Possible values: text, md5, none. Default is none.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-SrcPort <Int32>
Port to connect to NDMP service on the source controller. Default is 10
000.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-DstPort <Int32>
Port to connect to NDMP service on the destination controller. Default
is 10000.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Version <Int16>
NDMP version to use when communicating with source and destination contr
ollers. Must be at least 3, Default is 4.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Exclude <String>
Exclude string.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Level <Int32>
The incremental level to be used for the transfer. The default level use
d is 0, the range is 0-9.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-UseIpv6
If specified, the cmdlet will attempt to connect the source and destinat
ion controllers using IPv6. If either the source or destination does no
t support IPv6, IPv4 will be used.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-IncrementalForever
If specified, use the "incremental forever" level.
Required? true
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: ndmp
-------------- Example 1 --------------
C:\PS>Invoke-NaNdmpCopy 10.61.167.61 /vol/vol4/t5/ 10.61.169.28 /vol/vol1/t5
/ -SrcAuthType md5 -DstAuthType md5 -Exclude "lun1,lun2"
Copy the contents of /vol/vol4/t5 on controller 10.61.167.61 to /vol/vol1/t5
/ on the controller 10.61.169.28. Credentials stored in the credentials cac
he will be used with MD5 to authenticate the connection to the source and de
stination controllers. Files with the name "lun1" or "lun2" will not be cop
ied.
RELATED LINKS
Start-NaNdmpCopy
Get-NaNdmpCopy
| Copyright © 2013 NetApp. All rights reserved. Use is subject to license terms. |
|
Data ONTAP® PowerShell Toolkit
|