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 |