SnapCenter PowerShell Commands
Set-SdSnapMirrorPolicyRule
Suggest changes
PDFs
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.