|
|
 Data ONTAP® PowerShell Toolkit
|
Cmdlet: Set-NaSnapvault
NAME
Set-NaSnapvault
SYNOPSIS
Modify a snapvault relationship.
SYNTAX
Set-NaSnapvault [-SecondaryPath] <String> [-PrimarySystem] <String> [-Primar
yPath] <String> [-MaxTries <Int32>] [-MaxTransferRate <Int64>] [-AllowOpenFi
leBackup [<Boolean>]] [-IgnoreAccessTimeChange [<Boolean>]] [-UseCompression
<String>] [-Controller <NaController>] [-WhatIf] [-Confirm] [<CommonParamet
ers>]
DESCRIPTION
Request change in one or more configuration parameters of an existing snapva
ult relationship identified by the secondary path provided. Only the parame
ters that are specified as input will be changed for this configuration.
PARAMETERS
-SecondaryPath <String>
The secondary path that will be used as destination for this relationshi
p as well as baseline transfer.
Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-PrimarySystem <String>
The primary system for this relationship as well as for the baseline tra
nsfer.
Required? true
Position? 2
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-PrimaryPath <String>
The primary path that will be used as the source for this relationship a
s well as for baseline transfer.
Required? true
Position? 3
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-MaxTries <Int32>
The maximum number of times a transfer will be tried. Transfers that ar
e retried using this mechanism may be capable of restarting from where t
he previous attempt failed. If a transfer does not succeed even after t
hose many attempts, then the secondary will give up. All the data that
was transferred during previous tries for this transfer will be discarde
d. The default value for this parameter is 2. When set to 0, the relat
ionship will become dormant. In other words no transfers will be allowe
d to this secondary path. The maximum value accepted for this input is 1
20. Range:[0..120]
Required? false
Position? named
Default value 2
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-MaxTransferRate <Int64>
The maximum transfer rate in bytes per second that will be used for this
relationship as well as baseline transfer. The default value for this
parameter will allow transfers 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
-AllowOpenFileBackup [<Boolean>]
Sets the back_up_open_files option in the snapvault configuration entry.
This option is used to allow or disallow the inclusion of open files o
n the primary system at the time of the transfer. This option is curren
tly applicable only for OSSV relationships. When set to 'false' the OSS
V primary agents will exclude files that are open from the transfer. Th
e default value for this parameter is 'true'.
Required? false
Position? named
Default value true
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-IgnoreAccessTimeChange [<Boolean>]
Sets the ignore_atime option in snapvault configuration entry. When set
to 'true', snapvault primary does not send files with only access time
changes during incremental transfers. The default value is 'false'
Required? false
Position? named
Default value false
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-UseCompression <String>
Specifies whether to compress the network data stream. Possible values
are 'on', 'off', and 'default'. When the value is set to 'on', stream c
ompression will be enabled. When the value is set to 'off', stream comp
ression will be disabled. When the value is set to 'default' then the d
efault value will be used. When this option is not specified, the last
configured value for this relationship will be used. The default value
for this option is the value of global compression option.
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
-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
NetApp.Ontapi.Filer.Snapvault73.SnapvaultConfigurationInfo
NOTES
Category: snapvault
API: snapvault-secondary-modify-configuration
-------------- Example 1 --------------
C:\PS>Set-NaSnapvault /vol/vol0/svsec dunn /vol/vol0/svpri -MaxTries 5
Set the retry count on the specified SnapVault relationship to 5.
PrimarySystem : dunn
PrimaryPath : /vol/vol0/svpri
SecondaryPath : /vol/vol0/svsec
MaxTransferRate : 1048576
TriesCount : 5
UseCompression :
IsAccessTimeChangeIgnored : False
IsOpenFileBackupAllowed : True
IsPrimaryPathUtf8Encoded :
-------------- Example 2 --------------
C:\PS>Get-NaSnapvault | Set-NaSnapvault -MaxTries 10 -MaxTransferRate 1mb
Modify all SnapVault relationships on this secondary.
PrimarySystem : dunn
PrimaryPath : /vol/vol0/svpri
SecondaryPath : /vol/vol0/svsec
MaxTransferRate : 1048576
TriesCount : 10
UseCompression :
IsAccessTimeChangeIgnored : False
IsOpenFileBackupAllowed : True
IsPrimaryPathUtf8Encoded :
RELATED LINKS
Get-NaSnapvault
| Copyright © 2012 NetApp. All rights reserved. Use is subject to license terms. |
|
Data ONTAP® PowerShell Toolkit
|