NAME

Set-DcsRollbackProperties

SYNOPSIS

Sets the properties of a rollback.

SYNTAX

Set-DcsRollbackProperties   -Rollback <Object>   [ -WriteThrough <Boolean> ]   [ -Alias <String> ]   [ -Description <String> ]   [ -StorageProfile <String> ] [-Compressed<Boolean>] [ -Connection <String> ]   [ -PipelineVariable <String> ] [<CommonParameters>]

Set-DcsRollbackProperties   [ -WriteThrough <Boolean> ]   -VirtualDisk <Object>   [ -Alias <String> ]   [ -Description <String> ]   [ -StorageProfile <String> ] [-Compressed<Boolean>]  [ -Connection <String> ]   [ -PipelineVariable <String> ] [<CommonParameters>]

DESCRIPTION

Sets the properties of a rollback. Specify the parameters to set or change. The rollback can be identified by using either the Rollback or VirtualDisk parameter.

PARAMETERS

-Rollback<Object>
RollbackData object, name (alias), or ID that identifies the rollback.

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

-WriteThrough<Boolean>
Use this parameter to specify whether to enable or disable cache write-through for the virtual disk. Specify $true to enable cache write-through or $false to disable cache write-through. When enabled, all write operations to the virtual disk are written directly to the back-end storage and then acknowledged. This setting is disabled by default.

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

-Alias<String>
Use this parameter to change the name of the rollback.

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

-Description<String>
Use this parameter to set a description of the rollback. To remove the description, use an empty string as the value; for example "".

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

-StorageProfile<String>
Use this parameter to set the storage profile. Valid values in order from highest priority to lowest priority are: "Critical", "High", "Normal", "Low", and "Archive". A custom storage profile can also be set.

Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false
 
-Compressed<Boolean>
A boolean that will indicate if the Inline Compression Feature will be enabled or disabled on the corresponding Rollback. $True will enable the feature while $False will disable the feature.


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

-VirtualDisk<Object>
VirtualDiskData object, name (alias), or ID that identifies the rollback. The VirtualDiskData object can be obtained from the cmdlet Get-DcsVirtualDisk.

Required: true
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false
 
-<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).

INPUTS

RollbackData : Object that identifies the rollback.

OUTPUTS

VirtualDiskData : Object that identifies and describes the rollback virtual disk.

NOTES

EXAMPLES


-------------- Example 1 Changes rollback properties using the alias to identify the rollback. --------------
Set-DcsRollbackProperties -Rollback "VD1 RB1" -WriteThrough $true -Alias "Virtual disk 1 RB 050516" -StorageProfile "High"
-Compressed $True		

The cmdlet uses the alias of the rollback "VD1 RB1" as the value for the parameter Rollback. Write-through is enabled, the alias is changed to "Virtual disk 1 RB 050515" and the storage profile is set to "High". Compression is enabled on the rollback.

VirtualDiskGroupId:
FirstHostId:9C459815-28B7-45E1-9228-1C9B3EABF124
SecondHostId:
BackupHostId:
StorageProfileId:A122B0E3-7D32-4783-BDE4-619049C936C9
WitnessId: 
SnapshotPoolId:
Alias:Virtual disk 1 RB 050516
Description:
Size:100 GiB
SectorSize:512 B
Type:NonMirrored
DiskStatus:Online
InquiryData:DataCore Virtual Disk DCS 0514fca72801485e800916a72970ec0c
ScsiDeviceId:{96, 3, 13, 144...}
ScsiDeviceIdString:60030D9019AA2B07F90286529EABA0A2
RemovableMedia:False
WriteThrough:True
NVMe:False
Offline:False
Disabled:False
ManualRecovery:False
DiskLayout:DataCore.Executive.PhysicalDiskLayout
PersistentReserveEnabled:True
RecoveryPriority:High
TPThresholdsEnabled:False
IsServed:False
SubType:Standard
MirrorTrunkMappingEnabled:False
WitnessOption:Default
PreferredServer:1E1A38AF-672D-44C9-8444-EFF163133DB4
ResiliencyEnabled:False
EncryptionEnabled:False
CompressionEnabled:True
DeduplicationEnabled:False
StaleDataEnabled:False
StaleDataWeight:64
Sequencenumber:3098640
Id:1b24725dfc404599b629ba068167fdb2
Caption:Virtual disk 1 RB 050516
ExtendedCaption:Virtual disk 1 RB 050516 from Server Group
Internal:False
   

-------------- Example 2 Changes the storage profile and writethrough settings on all rollbacks in the group using the VirtualDiskData objects to identify the rollbacks. --------------
$RBs = Get-DcsVirtualDisk -Kind Rollback
ForEach ($RB in $RBs) {Set-DcsRollbackProperties -VirtualDisk $RB.Id -WriteThrough $true -StorageProfile "High"}
		

The cmdlet Get-DcsVirtualDisk is invoked to return VirtualDiskData objects for all rollbacks in the group. The objects are saved to the variable $RBs, which is used with a ForEach loop to identify each rollback by ID for the parameter VirtualDisk. The cmdlet Set-DcsRollbackProperties enables Write-through and sets the storage profile to "High" for each rollback.

VirtualDiskGroupId:
FirstHostId:9C459815-28B7-45E1-9228-1C9B3EABF124
SecondHostId:
BackupHostId:
StorageProfileId:A122B0E3-7D32-4783-BDE4-619049C936C9
SnapshotPoolId:
Alias:Virtual disk 1 @ 5/31/2016 12:52:33 PM
Description:
Size:100 GiB
SectorSize:512 B
Type:NonMirrored
DiskStatus:Online
InquiryData:DataCore Virtual Disk DCS db24560e43324c58b300559f4cb67085
ScsiDeviceId:{96, 3, 13, 144...}
ScsiDeviceIdString:60030D909FF27607398D40D83219B9DB
RemovableMedia:False
WriteThrough:True
Offline:False
Disabled:False
ManualRecovery:False
DiskLayout:DataCore.Executive.PhysicalDiskLayout
PersistentReserveEnabled:True
RecoveryPriority:High
IsServed:False
SubType:Standard
MirrorTrunkMappingEnabled:False
Sequencenumber:9291
Id:db24560e43324c58b300559f4cb67085
Caption:Virtual disk 1 @ 5/31/2016 12:52:33 PM
ExtendedCaption:Virtual disk 1 @ 5/31/2016 12:52:33 PM from Group1
Internal:False
   
VirtualDiskGroupId:
FirstHostId:9C459815-28B7-45E1-9228-1C9B3EABF124
SecondHostId:
BackupHostId:
StorageProfileId:A122B0E3-7D32-4783-BDE4-619049C936C9
SnapshotPoolId:
Alias:Virtual disk 1 @ 6/1/2016 3:51:22 PM
Description:
Size:100 GiB
SectorSize:512 B
Type:NonMirrored
DiskStatus:Online
InquiryData:DataCore Virtual Disk DCS 544a69d7023b4bed8894a6f92ddda7e9
ScsiDeviceId:{96, 3, 13, 144...}
ScsiDeviceIdString:60030D90E3F61702B9BAAFF26FE03F06
RemovableMedia:False
WriteThrough:True
Offline:False
Disabled:False
ManualRecovery:False
DiskLayout:DataCore.Executive.PhysicalDiskLayout
PersistentReserveEnabled:True
RecoveryPriority:High
IsServed:False
SubType:Standard
MirrorTrunkMappingEnabled:False
Sequencenumber:10248
Id:544a69d7023b4bed8894a6f92ddda7e9
Caption:Virtual disk 1 @ 6/1/2016 3:51:22 PM
ExtendedCaption:Virtual disk 1 @ 6/1/2016 3:51:22 PM from Group1
Internal:False