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