NAME

Split-DcsSnapshot

SYNOPSIS

Terminates the relationship between the source virtual disk and a full snapshot. This operation can also be performed on a snapshot group.

SYNTAX

Split-DcsSnapshot   -Snapshot <Object>   [ -Connection <String> ]   [ -PipelineVariable <String> ]

Split-DcsSnapshot   -SnapshotGroup <Object>   [ -Connection <String> ]   [ -PipelineVariable <String> ]

DESCRIPTION

Terminates the relationship between the source virtual disk and a full snapshot. This operation can also be performed on a snapshot group. When split, the snapshot will be independent of the source and operation as any other virtual disk. (The snapshot must be a full snapshot in order to perform this operation, see ConvertTo-DcsFullSnapshot.)

PARAMETERS

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

Required: true
Position: 1
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 split. Use this parameter to split all eligible snapshots in the snapshot group.

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

INPUTS

SnapshotData : Object that identifies the snapshot.

OUTPUTS

VirtualDiskData or VirtualDiskGroupData : Object that identifies and describes the snapshot virtual disk or snapshot group.

NOTES

Also see Update-DcsSnapshot, ConvertTo-DcsFullSnapshot, Revert-DcsSnapshot, Remove-DcsSnapshot, Get-DcsSnapshot

EXAMPLES


-------------- Example 1 Splits a full snapshot specified by name --------------
Split-DcsSnapshot -Snapshot "Virtual disk 2 @ 3/28/2012 2:49:36 PM on SSV4"

The full snapshot named "Virtual disk 2 @ 3/28/2012 2:49:36 PM on SSV4" is split to become a fully functioning single virtual disk.

VirtualDiskGroupId:
FirstHostId:25C0A9F6-4F7D-44DD-95BA-1DEDCA9A4D9D
SecondHostId:
BackupHostId:
StorageProfileId:100469DF-0BE1-40DA-874E-9F1DA5A259E3
Alias:Virtual disk 2 @ 3/28/2012 2:49:36 PM
Description:
Size:100.00 GiB
Type:NonMirrored
DiskStatus:Online
InquiryData:DataCore Virtual Disk DCS
ScsiDeviceId:{96, 3, 13, 144...}
RemovableMedia:False
WriteThrough:False
Offline:False
Disabled:False
DiskLayout:DataCore.Executive.PhysicalDiskLayout
PersistentReserveEnabled:True
RecoveryPriority:Low
IsServed:False
Sequencenumber:12598
Id:3e09050b09af45a5adc73d9744c764c1
Caption:Virtual disk 2 @ 3/28/2012 2:49:36 PM
ExtendedCaption:Virtual disk 2 @ 3/28/2012 2:49:36 PM from Server Group FTL
Internal:False
   

-------------- Example 2 Splits all full snapshots by piping objects --------------
$fullsnaps = (Get-DcsSnapshot | ConvertTo-DcsFullSnapshot)
$fullsnaps | Split-DcsSnapshot

The cmdlet Get-DcsSnapshot is piped to ConvertTo-DcsFullSnapshot resulting in all differential snapshots being converted to full snapshots and the SnapshotData objects returned are stored in the variable $fullsnaps. After this process is complete, the variable $fullsnaps is piped to Split-DcsSnapshot and those snapshots are split.

VirtualDiskGroupId:
FirstHostId:3CA4C19A-D3A3-4CBE-9426-0F6A88AFB744
SecondHostId:
BackupHostId:
StorageProfileId:100469DF-0BE1-40DA-874E-9F1DA5A259E3
Alias:Virtual disk 5 @ 3/27/2012 5:35:28 PM
Description:
Size:20.00 GiB
Type:NonMirrored
DiskStatus:Online
InquiryData:DataCore Virtual Disk DCS
ScsiDeviceId:{96, 3, 13, 144...}
RemovableMedia:False
WriteThrough:False
Offline:False
Disabled:False
DiskLayout:DataCore.Executive.PhysicalDiskLayout
PersistentReserveEnabled:True
RecoveryPriority:Low
IsServed:False
Sequencenumber:13364
Id:cc6446229b12459da9b4506da1a7c604
Caption:Virtual disk 5 @ 3/27/2012 5:35:28 PM
ExtendedCaption:Virtual disk 5 @ 3/27/2012 5:35:28 PM from Server Group FTL
Internal:False
   
VirtualDiskGroupId:
FirstHostId:25C0A9F6-4F7D-44DD-95BA-1DEDCA9A4D9D
SecondHostId:
BackupHostId:
StorageProfileId:100469DF-0BE1-40DA-874E-9F1DA5A259E3
Alias:Virtual disk 2 @ 3/28/2012 3:40:58 PM
Description:
Size:100.00 GiB
Type:NonMirrored
DiskStatus:Online
InquiryData:DataCore Virtual Disk DCS
ScsiDeviceId:{96, 3, 13, 144...}
RemovableMedia:False
WriteThrough:False
Offline:False
Disabled:False
DiskLayout:DataCore.Executive.PhysicalDiskLayout
PersistentReserveEnabled:True
RecoveryPriority:Low
IsServed:False
Sequencenumber:13516
Id:2410495ca6274082af6cf8c8980f3dec
Caption:Virtual disk 2 @ 3/28/2012 3:40:58 PM
ExtendedCaption:Virtual disk 2 @ 3/28/2012 3:40:58 PM from Server Group FTL
Internal:False
   

-------------- Example 3 Splits a snapshot group --------------
$SSgrp = Split-DcsSnapshot -SnapshotGroup "VD group 1 @ 5/10/2012 4:22:52 PM"

The full snapshot group named "VD group 1 @ 5/10/2012 4:22:52 PM" is split to become a fully functioning virtual disk group.

Alias:VD group 1 @ 5/10/2012 4:22:52 PM
Description:
Sequencenumber:10925
Id:{6a7243e0-7c82-4492-9cf5-e2205ba6267d}
Caption:VD group 1 @ 5/10/2012 4:22:52 PM
ExtendedCaption:VD group 1 @ 5/10/2012 4:22:52 PM
Internal:False