Skip to main content
SnapCenter 4.7 cmdlets

Set-SdSnapMirrorPolicyRule

Contributors

Sets the rules for managing Snapshot retention on the SnapVault secondary storage system.

Syntax

Set-SdSnapMirrorPolicyRule [-SourceStorageSystem]  <String>  [-SourceStorageSystemVolume]  <String>  [-DestinationStorageSystem]  <String>  [-DestinationStorageSystemVolume]  <String>  [-SnapMirrorLabel]  <String>  [-Retention]  <Int32>  [-Preserve]  <>  [-WarnThreshold]  <Int32>  [-Session]  <String>  [-Host]  <String>

Detailed Description

Sets the rules for managing Snapshot retention on the SnapVault secondary storage system. You can create new rules for customizing your virtual storage server level SnapMirror policy. Each SnapMirror policy can have up to 10 rules managing Snapshot copy retention. The default policy rules are daily or weekly Snapshot copy retention, or you can define your own retention rule. You cannot modify cluster-level SnapMirror or SnapVault policies with virtual storage server credentials.Related cmdlets: Remove-SdSnapMirrorPolicyRule, Get-SdSnapMirrorPolicyRule

Parameters

Name Description Required? Pipeline Input Default Value

SourceStorageSystem

Specifies the primary storage system name containing the source volumes of the SnapMirror relationship for which you want to create or modify the SnapMirror policy rules. IP addresses are not supported.

true

true (ByValue, ByPropertyName)

SourceStorageSystemVolume

Specifies the source volume of the SnapMirror relationship for which you want to create or modify the SnapMirror policy rules.

true

true (ByPropertyName)

DestinationStorageSystem

Specifies the secondary storage system name containing the destination volumes of the SnapMirror relationship for which you want to create or modify the SnapMirror policy rules. IP addresses are not supported.

true

true (ByValue, ByPropertyName)

DestinationStorageSystemVolume

Specifies the destination volume of the SnapMirror relationship for which you want to create or modify the SnapMirror policy rules.

true

true (ByPropertyName)

SnapMirrorLabel

Specifies the SnapMirror policy rule which you want to create or modify.

true

true (ByPropertyName)

Retention

Specifies the Snapshot copy retention count.

true

true (ByPropertyName)

Preserve

Specifies whether Snapshot copy preserve is enabled, which determines the behavior when the Snapshot copy retention count is reached on the SnapMirror Vault destination.

false

true (ByPropertyName)

WarnThreshold

Specifies the warning threshold count.

false

true (ByPropertyName)

Session

false

true (ByPropertyName)

Host

Specifies the name or IP address of the host on which you execute the operation. The default is your local machine.

false

true (ByPropertyName)

Examples

Example 1: Setting SnapMirror policy rule information on the policy for a SnapMirror relationship

 PS C:\> Set-SdSnapMirrorPolicyRule -SourceStorageSystem vs01 -SourceStorageSystemVolume src_vol01 -DestinationStorageSystem vs02 -DestinationStorageSystemVolume dest_vol01 -SnapMirrorLabel myWeekly -Retention 8 -Preserve -WarnThreshold 3 -verbose -Confirm:$false

Create or modify the SnapMirror policy rule "myWeekly" on the policy of the specified relationship.

PS C:\Users\administrator.NEXTGEN> Set-SdSnapMirrorPolicyRule -SourceStorageSystem vserver1 -SourceStorageSystemVolume snapvault_source -DestinationStorageSyst
em vserver1 -DestinationStorageSystemVolume snapvault_dest -SnapMirrorLabel test -Retention 8 -Preserve -WarnThreshold 3 -Verbose
Set-SdSnapMirrorPolicyRule
Set SnapMirror policy rule on vserver1 : snapvault_source ==> vserver1 : snapvault_dest.
Do you want to continue?
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"):
VERBOSE: Setting SnapMirror policy rules.
The setting SnapMirror policy rules operation is successful.
VERBOSE: Operation successful.