NAME
Set-DcsSnapshotProperties
SYNOPSIS
Sets the properties of a snapshot.
SYNTAX
Set-DcsSnapshotProperties -Snapshot <Object> [ -Alias <String> ] [ -Description <String> ] [ -StorageProfile <String> ] [-Compressed <Boolean>] [ -Connection <String> ] [ -PipelineVariable <String> ] [<CommonParameters>]
Set-DcsSnapshotProperties -VirtualDisk <Object> [ -Alias <String> ] [ -Description <String> ] [ -StorageProfile <String> ] [-Compressed <Boolean>] [ -Connection <String> ] [ -PipelineVariable <String> ] [<CommonParameters>]
DESCRIPTION
Sets the properties of a snapshot. Specify the parameters to set or change. The snapshot can be identified by using either the Snapshot or VirtualDisk parameter.
PARAMETERS
- -Snapshot<Object>
- SnapshotData object, name (alias), or ID that identifies the snapshot.
-
- Required: true
- Position: 1
- Default value:
- Accept pipeline input: true (ByValue)
- Accept wildcard characters: false
-
- -Alias<String>
- Use this parameter to change the alias (name) of the snapshot.
-
- 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 snapshot. 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
-
- -Compression <Boolean>
- A boolean that will indicate if the Inline Compression Feature will be enabled or disabled on the corresponding Snapshot. $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 snapshot. 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
SnapshotData : Object that identifies the snapshot.
OUTPUTS
VirtualDiskData : Object that identifies the snapshot virtual disk.
NOTES
Also see related cmdlets: Set-DcsSnapshotMapStore, Set-DcsSnapshotPool.
EXAMPLES
Set-DcsSnapshotProperties -Snapshot "VD1 S1" -Alias "Virtual disk 1 Snap 053116 -Compressed $True"
The cmdlet is invoked to change the alias of the snapshot from "VD1 S1" to "Virtual disk 1 Snap 053116".
VirtualDiskGroupId | : | |
FirstHostId | : | 76418969-E2A7-4CE5-B32C-3886A0E794AF |
SecondHostId | : | |
BackupHostId | : | |
StorageProfileId | : | 100469DF-0BE1-40DA-874E-9F1DA5A259E3 |
WitnessId | : | |
SnapshotPoolId | : | |
Alias | : | Virtual disk 1 Snap 053116 |
Description | : | |
Size | : | 100 GiB |
SectorSize | : | 512 B |
Type | : | NonMirrored |
DiskStatus | : | Online |
InquiryData | : | DataCore Virtual Disk DCS 442698722e9f42cabca359a1bfe54433 |
ScsiDeviceId | : | {96, 3, 13, 144...} |
ScsiDeviceIdString | : | 60030D90B9AA2A075E397C02AD704DD9 |
RemovableMedia | : | False |
WriteThrough | : | False |
NVMe | : | False |
Offline | : | False |
Disabled | : | False |
ManualRecovery | : | False |
DiskLayout | : | DataCore.Executive.PhysicalDiskLayout |
PersistentReserveEnabled | : | True |
RecoveryPriority | : | Regular |
TPThresholdsEnabled | : | False |
IsServed | : | False |
SubType | : | Standard |
MirrorTrunkMappingEnabled | : | False |
WitnessOption | : | Default |
PreferredServer | : | 26686168-532C-4811-A890-6FA5B9A70127 |
ResiliencyEnabled | : | False |
EncryptionEnabled | : | False |
CompressionEnabled | : | True |
DeduplicationEnabled | : | False |
Sequencenumber | : | 11217 |
Id | : | 442698722e9f42cabca359a1bfe54433 |
Caption | : | Virtual disk 1 Snap 053116 |
ExtendedCaption | : | Virtual disk 1 Snap 053116 from Group1 |
Internal | : | False |
$Snaps = Get-DcsVirtualDisk -Kind Snapshot ForEach ($s in $Snaps) {Set-DcsSnapshotProperties -VirtualDisk $s.Id -StorageProfile "High"}
The cmdlet Get-DcsVirtualDisk is invoked to return VirtualDiskData objects for all snapshots in the group. The objects are saved to the variable $Snaps, which is used with a ForEach loop to identify each snapshot by ID for the parameter VirtualDisk. The cmdlet Set-DcsSnapshotProperties sets the storage profile for each snapshot to "High".
VirtualDiskGroupId | : | |
FirstHostId | : | 9C459815-28B7-45E1-9228-1C9B3EABF124 |
SecondHostId | : | |
BackupHostId | : | |
StorageProfileId | : | A122B0E3-7D32-4783-BDE4-619049C936C9 |
SnapshotPoolId | : | |
Alias | : | Virtual disk 2 snapshot |
Description | : | |
Size | : | 20 GiB |
SectorSize | : | 512 B |
Type | : | NonMirrored |
DiskStatus | : | Online |
InquiryData | : | DataCore Virtual Disk DCS a8d0fc6ca9264d52ac50d594ea3575cc |
ScsiDeviceId | : | {96, 3, 13, 144...} |
ScsiDeviceIdString | : | 60030D904E0529073D615AD778912A97 |
RemovableMedia | : | False |
WriteThrough | : | False |
Offline | : | False |
Disabled | : | False |
ManualRecovery | : | False |
DiskLayout | : | DataCore.Executive.PhysicalDiskLayout |
PersistentReserveEnabled | : | True |
RecoveryPriority | : | High |
IsServed | : | False |
SubType | : | Standard |
MirrorTrunkMappingEnabled | : | False |
WitnessOption | : | Default |
PreferredServer | : | 26686168-532C-4811-A890-6FA5B9A70127 |
ResiliencyEnabled | : | False |
EncryptionEnabled | : | False |
CompressionEnabled | : | False |
DeduplicationEnabled | : | False |
Sequencenumber | : | 12174 |
Id | : | a8d0fc6ca9264d52ac50d594ea3575cc |
Caption | : | Virtual disk 2 snapshot |
ExtendedCaption | : | Virtual disk 2 snapshot from Group1 |
Internal | : | False |
VirtualDiskGroupId | : | |
FirstHostId | : | 76418969-E2A7-4CE5-B32C-3886A0E794AF |
SecondHostId | : | |
BackupHostId | : | |
StorageProfileId | : | A122B0E3-7D32-4783-BDE4-619049C936C9 |
SnapshotPoolId | : | |
Alias | : | Virtual disk 1 Snap 053116 |
Description | : | |
Size | : | 100 GiB |
SectorSize | : | 512 B |
Type | : | NonMirrored |
DiskStatus | : | Online |
InquiryData | : | DataCore Virtual Disk DCS 442698722e9f42cabca359a1bfe54433 |
ScsiDeviceId | : | {96, 3, 13, 144...} |
ScsiDeviceIdString | : | 60030D90B9AA2A075E397C02AD704DD9 |
RemovableMedia | : | False |
WriteThrough | : | False |
Offline | : | False |
Disabled | : | False |
ManualRecovery | : | False |
DiskLayout | : | DataCore.Executive.PhysicalDiskLayout |
PersistentReserveEnabled | : | True |
RecoveryPriority | : | High |
IsServed | : | False |
SubType | : | Standard |
MirrorTrunkMappingEnabled | : | False |
WitnessOption | : | Default |
PreferredServer | : | 26686168-532C-4811-A890-6FA5B9A70127 |
ResiliencyEnabled | : | False |
EncryptionEnabled | : | False |
CompressionEnabled | : | False |
DeduplicationEnabled | : | False |
Sequencenumber | : | 13131 |
Id | : | 442698722e9f42cabca359a1bfe54433 |
Caption | : | Virtual disk 1 Snap 053116 |
ExtendedCaption | : | Virtual disk 1 Snap 053116 from Group1 |
Internal | : | False |