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