NAME

Start-DcsVirtualDiskReclamation

SYNOPSIS

Starts the reclamation process for a virtual disk.

SYNTAX

Start-DcsVirtualDiskReclamation   -VirtualDisk <Object>   [ -Connection <String> ]   [ -PipelineVariable <String> ]

DESCRIPTION

Starts the reclamation process for a virtual disk. The reclamation process de-allocates any storage allocation units (SAUs) that are completely filled with zeros in the virtual disk. Those SAUs are added back to the available free space in the pool. The reclamation process could have an impact on the performance of the host. The process can be aborted without damage to the virtual disk integrity and restarted at a later time if performance is impacted, see Stop-DcsVirtualDiskReclamation.

PARAMETERS

-VirtualDisk<Object>
VirtualDiskData object, name, or ID that identifies the virtual disk.

Required: true
Position: named
Default value:
Accept pipeline input: true (ByValue)
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

INPUTS

VirtualDiskData : Object that identifies and describes the virtual disk.

OUTPUTS

LogicalDiskData : Object that identifies and describes a logical disk.

NOTES

Also see Stop-DcsVirtualDiskReclamation, Get-DcsVirtualDisk.

EXAMPLES


-------------- Example 1 Starts reclamation on a virtual disk specified by name --------------
Start-DcsVirtualDiskReclamation -VirtualDisk "Virtual disk 1"
		

Starts the reclamation process on the virtual disk named "Virtual disk 1".

StreamDiskId:
RetentionTime:0
StreamSize:0.00 B
StreamState:NotPresent
PoolId:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4:{91e63003-ca79-11e0-a962-00155d11e921}
VolumeIndex:62
MinQuota:0.00 B
MaxQuota:0.00 B
TierAffinity:{1, 2, 3}
StorageName:
InReclamation:False
DataStatus:UpToDate
PresenceStatus:Present
Size:1.00 PiB
Description:
DiskStatus:Online
Virtualized:True
ClientAccessRights:ReadWrite
Failure:Healthy
VirtualDiskId:a7869c8ba5304c7d8ebfca176680a407
DiskRole:First
ServerHostId:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4
IsMapped:True
Protected:True
Id:LD:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4_V.{91e63003-ca79-11e0-a962-00155d11e921}-0000003E
Caption:Virtual disk 1 on SSV1
ExtendedCaption:Virtual disk 1 on SSV1
Internal:False
   
StreamDiskId:
RetentionTime:0
StreamSize:0.00 B
StreamState:NotPresent
PoolId:C553D471-3527-47EC-9326-D53E04204F2B:{9437d954-ca79-11e0-857f-00155d11e923}
VolumeIndex:43
MinQuota:0.00 B
MaxQuota:0.00 B
TierAffinity:{1, 2, 3}
StorageName:
InReclamation:False
DataStatus:NotUpToDate
PresenceStatus:Present
Size:1.00 PiB
Description:
DiskStatus:Online
Virtualized:True
ClientAccessRights:ReadWrite
Failure:Healthy
VirtualDiskId:a7869c8ba5304c7d8ebfca176680a407
DiskRole:Second
ServerHostId:C553D471-3527-47EC-9326-D53E04204F2B
IsMapped:True
Protected:True
Id:LD:C553D471-3527-47EC-9326-D53E04204F2B_V.{9437d954-ca79-11e0-857f-00155d11e923}-0000002B
Caption:Virtual disk 1 on SSV2
ExtendedCaption:Virtual disk 1 on SSV2
Internal:False
   

-------------- Example 2 Starts reclamation for virtual disks by piping objects --------------
Get-DcsVirtualDisk -ServerGroup "Local Group" -Kind Standard | Start-DcsVirtualDiskReclamation
		

The cmdlet Get-DcsVirtualDisk is invoked to obtain the VirtualDiskData objects for all standard type virtual disks in the server group named "Local Group". The objects are piped to Start-DcsVirtualDiskReclamation to start reclamation on those virtual disks.

StreamDiskId:
RetentionTime:0
StreamSize:0.00 B
StreamState:NotPresent
PoolId:C553D471-3527-47EC-9326-D53E04204F2B:{9437d954-ca79-11e0-857f-00155d11e923}
VolumeIndex:41
MinQuota:0.00 B
MaxQuota:0.00 B
TierAffinity:{1, 2, 3}
StorageName:
InReclamation:True
DataStatus:UpToDate
PresenceStatus:Present
Size:1.00 PiB
Description:
DiskStatus:Online
Virtualized:True
ClientAccessRights:ReadWrite
Failure:Healthy
VirtualDiskId:2164986282d34c3282e73a2002801368
DiskRole:Second
ServerHostId:C553D471-3527-47EC-9326-D53E04204F2B
IsMapped:True
Protected:True
Id:LD:C553D471-3527-47EC-9326-D53E04204F2B_V.{9437d954-ca79-11e0-857f-00155d11e923}-00000029
Caption:Virtual disk 2 on SSV2
ExtendedCaption:Virtual disk 2 on SSV2
Internal:False
   
StreamDiskId:
RetentionTime:0
StreamSize:0.00 B
StreamState:NotPresent
PoolId:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4:{91e63003-ca79-11e0-a962-00155d11e921}
VolumeIndex:63
MinQuota:0.00 B
MaxQuota:0.00 B
TierAffinity:{1, 2, 3}
StorageName:
InReclamation:True
DataStatus:UpToDate
PresenceStatus:Present
Size:1.00 PiB
Description:
DiskStatus:Online
Virtualized:True
ClientAccessRights:ReadWrite
Failure:Healthy
VirtualDiskId:2164986282d34c3282e73a2002801368
DiskRole:First
ServerHostId:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4
IsMapped:True
Protected:True
Id:LD:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4_V.{91e63003-ca79-11e0-a962-00155d11e921}-0000003F
Caption:Virtual disk 2 on SSV1
ExtendedCaption:Virtual disk 2 on SSV1
Internal:False
   
StreamDiskId:
RetentionTime:0
StreamSize:0.00 B
StreamState:NotPresent
PoolId:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4:{91e63003-ca79-11e0-a962-00155d11e921}
VolumeIndex:62
MinQuota:0.00 B
MaxQuota:0.00 B
TierAffinity:{1, 2, 3}
StorageName:
InReclamation:True
DataStatus:UpToDate
PresenceStatus:Present
Size:1.00 PiB
Description:
DiskStatus:Online
Virtualized:True
ClientAccessRights:ReadWrite
Failure:Healthy
VirtualDiskId:a7869c8ba5304c7d8ebfca176680a407
DiskRole:First
ServerHostId:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4
IsMapped:True
Protected:True
Id:LD:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4_V.{91e63003-ca79-11e0-a962-00155d11e921}-0000003E
Caption:Virtual disk 1 on SSV1
ExtendedCaption:Virtual disk 1 on SSV1
Internal:False
   
StreamDiskId:
RetentionTime:0
StreamSize:0.00 B
StreamState:NotPresent
PoolId:C553D471-3527-47EC-9326-D53E04204F2B:{9437d954-ca79-11e0-857f-00155d11e923}
VolumeIndex:43
MinQuota:0.00 B
MaxQuota:0.00 B
TierAffinity:{1, 2, 3}
StorageName:
InReclamation:True
DataStatus:UpToDate
PresenceStatus:Present
Size:1.00 PiB
Description:
DiskStatus:Online
Virtualized:True
ClientAccessRights:ReadWrite
Failure:Healthy
VirtualDiskId:a7869c8ba5304c7d8ebfca176680a407
DiskRole:Second
ServerHostId:C553D471-3527-47EC-9326-D53E04204F2B
IsMapped:True
Protected:True
Id:LD:C553D471-3527-47EC-9326-D53E04204F2B_V.{9437d954-ca79-11e0-857f-00155d11e923}-0000002B
Caption:Virtual disk 1 on SSV2
ExtendedCaption:Virtual disk 1 on SSV2
Internal:False