NAME

Revert-DcsSnapshot

SYNOPSIS

Reverts the source virtual disk to the state of the snapshot. This operation can also be performed on a snapshot group.

SYNTAX

Revert-DcsSnapshot   -Snapshot <Object>   [ -Yes]   [ -Connection <String> ]   [ -PipelineVariable <String> ]   [ -WhatIf]   [ -Confirm]

Revert-DcsSnapshot   -SnapshotGroup <Object>   [ -Yes]   [ -Connection <String> ]   [ -PipelineVariable <String> ]   [ -WhatIf]   [ -Confirm]

DESCRIPTION

Reverts the source virtual disk to the state of the snapshot. This operation can also be performed on a snapshot group. Reverting will overwrite all changes that have occurred on the source virtual disk after the point-in-time of the snapshot. Before invoking this cmdlet, I/O from the client host should be stopped and the source virtual disk should be unserved from the client host, see Unserve-DcsVirtualDisk.

PARAMETERS

-Snapshot<Object>
SnapshotData object, name, or ID that identifies the snapshot.

Required: true
Position: named
Default value:
Accept pipeline input: true (ByValue)
Accept wildcard characters: false

-Yes<SwitchParameter>
Reverting is an operation that requires confirmation. Specify this parameter to confirm your intention to revert and prevent user interaction during scripted scenarios. If this parameter is not specified, user interaction will be required.

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

-Connection<String>
Alias of the connection to the server group. If not specified, the default connection will be used.

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

-PipelineVariable<String>

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

-WhatIf<SwitchParameter>

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

-Confirm<SwitchParameter>

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

-SnapshotGroup<Object>
SnapshotGroupData object, name or ID that identifies a snapshot group to revert.

Required: true
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

INPUTS

SnapshotData : Object the identifies and describes the snapshot.

OUTPUTS

SnapshotData : Object the identifies and describes the snapshot.

NOTES

Also see Remove-DcsSnapshot, Get-DcsSnapshot, Split-DcsSnapshot.

EXAMPLES


-------------- Example 1 Reverts a snapshot specified by name --------------
Revert-DcsSnapshot -Snapshot "Virtual disk 1 @ 8/26/2011 3:52:23 PM on SSV1" -Yes
		

Reverts the snapshot named "Virtual disk 1 @ 8/26/2011 3:52:23 PM on SSV1" in the server group. The Yes parameter was included to eliminate the need to confirm the operation.

SourceLogicalDiskId:LD:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4_V.{91e63003-ca79-11e0-a962-00155d11e921}-00000001
DestinationLogicalDiskId:LD:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4_V.{91e63003-ca79-11e0-a962-00155d11e921}-0000000E
Type:Differential
TimeStamp:8/26/2011 3:52:34 PM
ActiveOperation:NoOperation
State:Healthy
Failure:NoFailure
Id:V.{91E63003-CA79-11E0-A962-00155D11E921}-00000001--V.{91E63003-CA79-11E0-A962-00155D11E921}-0000000E
Caption:Virtual disk 1 @ 8/26/2011 3:52:23 PM
ExtendedCaption:Virtual disk 1 @ 8/26/2011 3:52:23 PM on SSV1
Internal:False
   

-------------- Example 2 Reverts all snapshots by piping objects --------------
Get-DcsSnapshot | Revert-DcsSnapshot -Yes
		

The cmdlet Get-DcsSnapshot is invoked to obtain all SnapshotData objects for the server group. The objects are piped to Revert-DcsSnapshot resulting in the reverting of all snapshots in the server group. The Yes parameter is included to eliminate the need to confirm the operation.

SourceLogicalDiskId:LD:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4_V.{91e63003-ca79-11e0-a962-00155d11e921}-00000002
DestinationLogicalDiskId:LD:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4_V.{91e63003-ca79-11e0-a962-00155d11e921}-00000018
Type:Differential
TimeStamp:8/29/2011 11:22:20 AM
ActiveOperation:NoOperation
State:Healthy
Failure:NoFailure
Id:V.{91E63003-CA79-11E0-A962-00155D11E921}-00000002--V.{91E63003-CA79-11E0-A962-00155D11E921}-00000018
Caption:Virtual disk 2 @ 8/29/2011 11:22:15 AM
ExtendedCaption:Virtual disk 2 @ 8/29/2011 11:22:15 AM on SSV1
Internal:False
   
SourceLogicalDiskId:LD:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4_V.{91e63003-ca79-11e0-a962-00155d11e921}-00000015
DestinationLogicalDiskId:LD:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4_V.{91e63003-ca79-11e0-a962-00155d11e921}-00000016
Type:Differential
TimeStamp:8/29/2011 11:22:09 AM
ActiveOperation:NoOperation
State:Healthy
Failure:NoFailure
Id:V.{91E63003-CA79-11E0-A962-00155D11E921}-00000015--V.{91E63003-CA79-11E0-A962-00155D11E921}-00000016
Caption:Virtual disk 1 @ 8/29/2011 11:21:49 AM
ExtendedCaption:Virtual disk 1 @ 8/29/2011 11:21:49 AM on SSV1
Internal:False