Data ONTAP® PowerShell Toolkit

Switch to Data ONTAP 7-mode documentation.

Cmdlet: Invoke-NcSnapmirrorLsUpdate


NAME
Invoke-NcSnapmirrorLsUpdate

SYNOPSIS
Updates destination volumes of a set of load-sharing mirrors.

SYNTAX
Invoke-NcSnapmirrorLsUpdate [-SourceCluster <String>] -SourceVserver <String
> -SourceVolume <String> [-Passthru] [-Controller <NcController[]>] [-WhatIf
] [-Confirm] [<CommonParameters>]

Invoke-NcSnapmirrorLsUpdate [-Source] <String> [-Passthru] [-Controller <NcC
ontroller[]>] [-WhatIf] [-Confirm] [<CommonParameters>]


DESCRIPTION
Updates destination volumes of a set of load-sharing mirrors. The cmdlet ma
kes destination volumes in the group of load-sharing mirrors up-to-date mirr
ors of the source volume. Separate SnapMirror transfers are performed from
the source volume to each of the up-to-date destination volumes in the set o
f load-sharing mirrors. Load-sharing mirrors that lag behind the up-to-date
destination volumes might not be updated by the cmdlet. Use Invoke-NcSnapm
irrorUpdate to update a lagging load-sharing mirror. A job will be spawned
to operate on the snapmirror and the job id will be returned. The progress o
f the job can be tracked using the job cmdlets.

You must specify the source endpoint when using Invoke-NcSnapmirrorLsInitial
ize.


PARAMETERS
-SourceCluster <String>
Specifies the source cluster of the SnapMirror relationship. The source
vserver and source volume must also be specified if using this paramete
r.

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-SourceVserver <String>
Specifies the source vserver of the SnapMirror relationship. The source
cluster and source volume must also be specified if using this paramete
r.

Required? true
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-SourceVolume <String>
Specifies the source volume of the SnapMirror relationship. The source
cluster and source vserver must also be specified if using this paramete
r.

Required? true
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-Passthru
Specify to output the SnapMirror object rather than the job ID.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Controller <NcController[]>
A clustered Data ONTAP controller to receive this cmdlet, as embodied by
an NcController object. This parameter is returned by the Connect-NcCo
ntroller cmdlet. If not specified, the value in the global variable Cur
rentNcController is used. In the latter case, if CurrentNcController co
ntains a collection of NcController objects, this cmdlet is invoked on e
ach controller in succession.

Required? false
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
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

-Source <String>
Specifies the source endpoint of the SnapMirror relationship in the form
at: [cluster:]//vserver/volume. This format may change in the future.
When specifying a source endpoint, you must use either the source locati
on, or the source cluster, source vserver, and source volume.

Required? true
Position? 1
Default value
Accept pipeline input? true (ByPropertyName)
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.C.PowerShell.SDK.Cmdlets.JobStartResult


NOTES


Category: snapmirror
API: snapmirror-update-ls-set
Family: cluster

-------------- Example 1 --------------

C:\PS>Invoke-NcSnapmirrorLsUpdate VxeRubble://costea01/vol1 | Get-NcJob


Update the set of load-sharing mirrors with source '//costea01/vol1' and dis
play the job.


JobId JobName JobPriority JobState JobVserver JobComplet
ion
----- ------- ----------- -------- ---------- ----------
---
1593 SnapMirror Loadshare update exclusive running VxeRubble



RELATED LINKS
Get-NcSnapmirror







 Data ONTAP® PowerShell Toolkit