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
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 |
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 |
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 |