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


-------------- Example 1 Changes the alias and compression property of a snapshot using the name to identify the snapshot. --------------
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
   

-------------- Example 2 Changes the storage profile for all snapshots in the group using the VirtualDiskData objects to identify the snapshots. --------------
$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