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 |