NAME

Enable-DcsDataProtection

SYNOPSIS

Enables Continuous Data Protection (CDP) for a virtual disk. This operation can also be performed on a virtual disk group.

SYNTAX

Enable-DcsDataProtection   [ -Server <String> ]   -VirtualDisk <Object>   -Pool <String>   [ -HistorySize <DataSize> ]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

Enable-DcsDataProtection   [ -Server <String> ]   -VirtualDiskGroup <Object>   -Pool <String>   [ -Connection <String> ]   [ -PipelineVariable <String> ]

DESCRIPTION

Enables Continuous Data Protection (CDP) for a virtual disk. This operation can also be performed on a virtual disk group. When enabled, data changes are saved in a history log. If necessary, rollbacks can be created to recover data, see Add-DcsRollback.

NOTE: In order to enable this feature at the group level, all group Members must be eligible for Continuous Data Protection and not already be enabled; otherwise, Members must be enabled individually.

PARAMETERS

-Server<String>
Computer name or ID of the server that will own the history log. The computer name must be unique or the name must be fully qualified.

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

-VirtualDisk<Object>
VirtualDiskData object, name, or ID that identifies the virtual disk to protect.

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

-Pool<String>
Name or ID of the disk pool to use as the source of the history log. To resolve by name, the name must be unique to the server group or the server must be specified.

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

-HistorySize<DataSize>
The maximum size of the history log. Valid values consist of the number followed by the unit of measurement (MiB, GiB, TiB). Decimals may be used. For example, "10GiB", "20.5GiB", and "5000MiB" are valid sizes. The history log size can range from a minimum of 8GiB up to 1024TiB. If not specified, the history log size will be set to the default size which is 5% of the size of the CDP-enabled virtual disk or 8GiB, whichever is larger. Setting the value of this parameter to zero will also set the maximum history log size to the default size.

Required: false
Position: 4
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

-VirtualDiskGroup<Object>
VirtualDiskGroupData object, name or ID that identifies a virtual disk group. Use this parameter to enable Continuous Data Protection for all eligible virtual disks in the virtual disk group. The VirtualDiskGroupData object can be obtained with Get-DcsVirtualDiskGroup.

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

INPUTS

VirtualDiskData : Object that identifies and describes the virtual disk.

OUTPUTS

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

NOTES

Also see Add-DcsRollback, Disable-DcsDataProtection, Get-DcsVirtualDisk, Get-DcsVirtualDiskGroup.

EXAMPLES


-------------- Example 1 Enables Continuous Data Protection for all virtual disks by piping objects --------------
Get-DcsVirtualDisk | Enable-DcsDataProtection -Server SSV2 -Pool "Disk Pool 1" -HistorySize 15GiB
		

The cmdlet Get-DcsVirtualDisk is used to pipe all objects to Enable-DcsDataProtection, which results in all virtual disks being enabled for Continuous Data Protection. The history logs for each virtual disk are created on server SSV2 with a maximum size of 15 GiB.

VirtualDiskGroupId:
FirstHostId:A6EA4E77-BBFF-4F48-91CD-3987E81C1CB3
SecondHostId:781D998D-3920-46BB-9F26-88BC591772B6
BackupHostId:
StorageProfileId:100469DF-0BE1-40DA-874E-9F1DA5A259E3
Alias:Virtual disk 2
Description:
Size:10.00 GiB
Type:MultiPathMirrored
DiskStatus:Online
InquiryData:DataCore Virtual Disk DCS
ScsiDeviceId:{96, 3, 13, 144...}
RemovableMedia:False
WriteThrough:False
Offline:False
DiskLayout:DataCore.Executive.PhysicalDiskLayout
PersistentReserveEnabled:True
RecoveryPriority:Regular
IsServed:False
Id:f692ff225118499ca8c2aaed4c2a91d2
Caption:Virtual disk 2
ExtendedCaption:Virtual disk 2 from Ft. Lauderdale
Internal:False
   
VirtualDiskGroupId:
FirstHostId:A6EA4E77-BBFF-4F48-91CD-3987E81C1CB3
SecondHostId:781D998D-3920-46BB-9F26-88BC591772B6
BackupHostId:
StorageProfileId:100469DF-0BE1-40DA-874E-9F1DA5A259E3
Alias:Virtual disk 1
Description:
Size:10.00 GiB
Type:MultiPathMirrored
DiskStatus:Online
InquiryData:DataCore Virtual Disk DCS
ScsiDeviceId:{96, 3, 13, 144...}
RemovableMedia:False
WriteThrough:False
Offline:False
DiskLayout:DataCore.Executive.PhysicalDiskLayout
PersistentReserveEnabled:True
RecoveryPriority:Regular
IsServed:False
Id:06740ddcb6044087b413f4e34ed603b7
Caption:Virtual disk 1
ExtendedCaption:Virtual disk 1 from Ft. Lauderdale
Internal:False
   
VirtualDiskGroupId:
FirstHostId:A6EA4E77-BBFF-4F48-91CD-3987E81C1CB3
SecondHostId:781D998D-3920-46BB-9F26-88BC591772B6
BackupHostId:
StorageProfileId:100469DF-0BE1-40DA-874E-9F1DA5A259E3
Alias:Virtual disk 3
Description:
Size:10.00 GiB
Type:MultiPathMirrored
DiskStatus:Online
InquiryData:DataCore Virtual Disk DCS
ScsiDeviceId:{96, 3, 13, 144...}
RemovableMedia:False
WriteThrough:False
Offline:False
DiskLayout:DataCore.Executive.PhysicalDiskLayout
PersistentReserveEnabled:True
RecoveryPriority:Regular
IsServed:False
Id:d2cc2a26ff5c4b0b99736f10bdd863ec
Caption:Virtual disk 3
ExtendedCaption:Virtual disk 3 from Ft. Lauderdale
Internal:False
   
VirtualDiskGroupId:
FirstHostId:A6EA4E77-BBFF-4F48-91CD-3987E81C1CB3
SecondHostId:781D998D-3920-46BB-9F26-88BC591772B6
BackupHostId:
StorageProfileId:100469DF-0BE1-40DA-874E-9F1DA5A259E3
Alias:Virtual disk 4
Description:
Size:10.00 GiB
Type:MultiPathMirrored
DiskStatus:Online
InquiryData:DataCore Virtual Disk DCS
ScsiDeviceId:{96, 3, 13, 144...}
RemovableMedia:False
WriteThrough:False
Offline:False
DiskLayout:DataCore.Executive.PhysicalDiskLayout
PersistentReserveEnabled:True
RecoveryPriority:Regular
IsServed:False
Id:9fcd72658c2d4023a7b239195b082326
Caption:Virtual disk 4
ExtendedCaption:Virtual disk 4 from Ft. Lauderdale
Internal:False
   

-------------- Example 2 Enables Continuous Data Protection on a virtual disk specified by name (caption) --------------
Enable-DcsDataProtection -Server SSV1 -VirtualDisk "Virtual disk 1" -Pool "Disk pool 1" -HistorySize 10GiB
		

Continuous Data Protection is enabled for the virtual disk named "Virtual disk 1". The history log is created on the disk pool "Disk pool 1" on server "SSV1". The history log will be using the a maximum size of 10GiB.

VirtualDiskGroupId:
FirstHostId:8BFC6F8B-F0F3-48D9-AE9A-635BC66557C4
SecondHostId:C2CAEE8A-8D1E-4165-96D4-4EFB4FC067C4
BackupHostId:
StorageProfileId:100469DF-0BE1-40DA-874E-9F1DA5A259E3
SnapshotPoolId:
Alias:Virtual disk 1
Description:
Size:20 GiB
Type:MultiPathMirrored
DiskStatus:Online
InquiryData:DataCore Virtual Disk DCS c7995948602c4a67b6dd0126a2b9b856
ScsiDeviceId:{96, 3, 13, 144...}
ScsiDeviceIdString:60030D9079E2A103A08E76ABBCBE1BF3
RemovableMedia:False
WriteThrough:False
Offline:False
Disabled:False
ManualRecovery:False
DiskLayout:DataCore.Executive.PhysicalDiskLayout
PersistentReserveEnabled:True
RecoveryPriority:Regular
IsServed:True
Sequencenumber:16362
Id:c7995948602c4a67b6dd0126a2b9b856
Caption:Virtual disk 1
ExtendedCaption:Virtual disk 1 from ServerGroup1
Internal:False
   

-------------- Example 3 Enables Continuous Data Protection for a virtual disk group --------------
Enable-DcsDataProtection -VirtualDiskGroup VDGroup1 -Server SSVVM1 -Pool "Disk pool 1"
		

Enables Continuous Data Protection for the virtual group named "VDGroup1" and the history log will be created from the pool named "Disk pool 1" on the server SSVVM1.

Alias:VDGroup1
Description:
Id:{993a4a47-d76f-4ca4-83a1-8669d436e198}
Caption:VDGroup1
ExtendedCaption:VDGroup1
Internal:False