NAME

ConvertTo-DcsFullSnapshot

SYNOPSIS

Converts (promotes) a differential snapshot to a full snapshot. This operation can also be performed on a snapshot group.

SYNTAX

ConvertTo-DcsFullSnapshot   -Snapshot <Object>   [ -Connection <String> ]   [ -PipelineVariable <String> ]

ConvertTo-DcsFullSnapshot   -SnapshotGroup <Object>   [ -Connection <String> ]   [ -PipelineVariable <String> ]

DESCRIPTION

Converts (promotes) a differential snapshot to a full snapshot. This operation can also be performed on a snapshot group. The differential (logical copy) will become a clone of the source virtual disk and can exist and operate independently from the source. This operation can be take a considerable amount of time depending on the amount of data that will need to be copied. After the snapshot is converted, it can be split from the source, see Split-DcsSnapshot.

PARAMETERS

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

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

-SnapshotGroup<Object>
SnapshotGroupData object, name or ID that identifies a snapshot group to convert to full snapshots. Use this parameter to convert all snapshots in the snapshot group to full snapshots. The SnapshotGroupData object can be obtained with Get-DcsVirtualDiskGroup.

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

INPUTS

SnapshotData : Object that identifies and describes the snapshot.

OUTPUTS

SnapshotData or SnapshotGroupData : Object that identifies and describes the snapshot or snapshot group that was converted.

NOTES

Also see Get-DcsSnapshot, Get-DcsVirtualDiskGroup, Split-DcsSnapshot, Revert-DcsSnapshot, Stop-DcsSnapshotOperation.

EXAMPLES


-------------- Example 1 Promotes a differential snapshot to full image by specifying the name (caption) --------------
ConvertTo-DcsFullSnapshot -Snapshot "VD2 @ 7/28/2011 4:18:14 PM"
		

Converts the differential snapshot named "VD2 @ 7/28/2011 4:18:14 PM" to a full (clone) snapshot.

SourceLogicalDiskId:LD:74EDD1B3-6682-46A7-943C-2F0168CEC699_V.{267e5c50-abd6-11e0-9515-00155d11e921}-00000014
DestinationLogicalDiskId:LD:74EDD1B3-6682-46A7-943C-2F0168CEC699_V.{b96878da-b7af-11e0-9ba8-00155d11e921}-0000000B
Type:Full
TimeStamp:7/28/2011 4:18:43 PM
ActiveOperation:NoOperation
State:Healthy
Failure:NoFailure
Id:V.{267E5C50-ABD6-11E0-9515-00155D11E921}-00000014--V.{B96878DA-B7AF-11E0-9BA8-00155D11E921}-0000000B
Caption:VD2 @ 7/28/2011 4:18:14 PM
ExtendedCaption:VD2 @ 7/28/2011 4:18:14 PM on SSV1
Internal:False
   

-------------- Example 2 Promotes differential snapshots in a snapshot group to full snapshots. --------------
ConvertTo-DcsFullSnapshot -SnapshotGroup "VDSnapshotGroup1 @ 11/9/2011 3:30:15 PM"
		

Converts the differential snapshots in the snapshot group named "VDSnapshotGroup1 @ 11/9/2011 3:30:15 PM" to full (clone) snapshots.

ParentGroupId:{f3e129dd-56bf-40c6-9ebb-e25432138fc6}
Alias:VDSnapshotGroup1 @ 11/9/2011 3:30:15 PM
Description:
Id:{0478ae77-13a2-4153-91cf-9afcbffb867f}
Caption:VDSnapshotGroup1 @ 11/9/2011 3:30:15 PM
ExtendedCaption:
Internal:False
   

-------------- Example 3 Promotes all differential snapshots to full --------------
Get-DcsSnapshot | ConvertTo-DcsFullSnapshot
		

The cmdlet Get-DcsSnapshot is piped to ConvertTo-DcsFullSnapshot resulting in all differential snapshots being converted (promoted) to full snapshots and the SnapshotData objects returned.

SourceLogicalDiskId:dba9bb6f-4dd7-4017-bf27-6d7166659989
DestinationLogicalDiskId:61c2100a-4991-4a33-ac4a-a72da684e992
Type:Full
TimeStamp:3/28/2012 4:02:43 PM
ActiveOperation:NoOperation
State:Healthy
Failure:NoFailure
Sequencenumber:14951
Id:V.{FCB8BED3-7423-11E1-9F2A-00155D11E92B}-0000001C--V.{FCB8BED3-7423-11E1-9F2A-00155D11E92B}-00000027
Caption:Virtual disk 6 @ 3/28/2012 4:02:35 PM
ExtendedCaption:Virtual disk 6 @ 3/28/2012 4:02:35 PM on SSV3
Internal:False
   
SourceLogicalDiskId:7693b656-8462-4a08-b9bd-2c181979ed72
DestinationLogicalDiskId:c8dbabdc-727e-4787-b5ee-fa6a7851b910
Type:Full
TimeStamp:3/28/2012 4:02:24 PM
ActiveOperation:NoOperation
State:Healthy
Failure:NoFailure
Sequencenumber:14955
Id:V.{FCB8BED3-7423-11E1-9F2A-00155D11E92B}-0000001B--V.{FCB8BED3-7423-11E1-9F2A-00155D11E92B}-00000025
Caption:Virtual disk 5 @ 3/28/2012 4:02:15 PM
ExtendedCaption:Virtual disk 5 @ 3/28/2012 4:02:15 PM on SSV3
Internal:False