NAME

Disable-DcsDataProtection

SYNOPSIS

Disables Continuous Data Protection (CDP) on a virtual disk or virtual disk group.

SYNTAX

Disable-DcsDataProtection   -VirtualDisk <Object>   [ -Yes]   [ -Connection <String> ]   [ -PipelineVariable <String> ]   [ -WhatIf]   [ -Confirm]

Disable-DcsDataProtection   -VirtualDiskGroup <Object>   [ -Yes]   [ -Connection <String> ]   [ -PipelineVariable <String> ]   [ -WhatIf]   [ -Confirm]

DESCRIPTION

Disables Continuous Data Protection (CDP) on a virtual disk or virtual disk group. When disabled, the history log is deleted and the virtual disk will no longer have Continuous Data Protection. All rollbacks created from the CDP-enabled virtual disk will be deleted. NOTE: Disabling at the group level will disable all eligible healthy group Members on all servers.

PARAMETERS

-VirtualDisk<Object>
VirtualDiskData object, name, or ID that identifies the CDP-enabled virtual disk. The VirtualDiskData object can be obtained with Get-DcsVirtualDisk.

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

-Yes<SwitchParameter>
When Continuous Data Protection is disabled on a virtual disk, all rollbacks created from that virtual disk will be deleted. Disabling Continuous Data Protection when rollbacks exist will result in a confirmation message. Specify this parameter to confirm your intention to disable Continuous Data Protection when rollbacks exist in order to prevent user interaction during scripted scenarios.

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

-WhatIf<SwitchParameter>

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

-Confirm<SwitchParameter>

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 disable 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 Enable-DcsDataProtection, Romove-DcsRollback, Split-DcsRollback, Get-DcsVirtualDisk, Get-DcsVirtualDiskGroup.

EXAMPLES


-------------- Example 1 Disables Continuous Data Protection for a virtual disk specified by name (caption) --------------
Disable-DcsDataProtection -VirtualDisk VDisk3 -Yes
		

Disables the feature for the virtual disk named "VDisk3". The Yes parameter was included to eliminate the need to confirm the operation.

GroupId:
FirstHostId:4B24F2B0-9A98-4C9E-9996-4E7B89FD6BA9
SecondHostId:22885568-1C03-4F7D-B95B-5C9C3AA16125
BackupHostId:
Alias:VDisk1
VirtualDiskGroupId:
FirstHostId:74EDD1B3-6682-46A7-943C-2F0168CEC699
SecondHostId:
BackupHostId:
StorageProfileId:100469DF-0BE1-40DA-874E-9F1DA5A259E3
Alias:VDisk3
Description:
Size:10.00 GiB
Type:NonMirrored
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:bc1d2b2d679145698e2029415ea86724
Caption:VDisk3
ExtendedCaption:VDisk3 from LOCAL
Internal:False
   

-------------- Example 2 Disable Continuous Data Protection for a virtual disk group --------------
Disable-DcsDataProtection -VirtualDiskGroup VDDataProtectionGroup1 -Yes
		

Disables the feature for the virtual disk group named "VDDataProtectionGroup1". The Yes parameter was included to eliminate the need to confirm the operation.

Alias:VDDataProtectionGroup1
Description:
Id:{106c2602-5942-4419-af18-bb7412f2fd0b}
Caption:VDDataProtectionGroup1
ExtendedCaption:
Internal:False