|
|
 Data ONTAP® PowerShell Toolkit
|
Cmdlet: Invoke-NaHostVolumeSpaceReclaim
NAME
Invoke-NaHostVolumeSpaceReclaim
SYNOPSIS
Reclaim free space on a Windows volume that is hosted on a Data ONTAP LUN.
SYNTAX
Invoke-NaHostVolumeSpaceReclaim [[-Path] <String>] [<CommonParameters>]
Invoke-NaHostVolumeSpaceReclaim [-VdsId] <Guid> [<CommonParameters>]
DESCRIPTION
Reclaim free space on a Windows volume that is hosted on a Data ONTAP LUN.
This cmdlet examines the NTFS file system on a Windows volume, locates all f
ree space, and deallocates the corresponding blocks on the Data ONTAP storag
e controller. No difference is apparent from Windows' perspective, but all
space not consumed by files on the volume is freed on the storage controller
.
Cluster-shared volumes (CSVs) are supported, but this cmdlet uses a differen
t reclamation algorithm due to CSV limitations. A CSV may appear to become
up to 98% full during the reclamation process, but this should not pose a pr
oblem even for LUNs that are not space-reserved. There is no requirement fo
r the CSV to be in redirected or maintenance mode to use this cmdlet.
This cmdlet may be run while the Windows volume is online and undergoing act
ive I/O. Administrator privileges are required to use this cmdlet.
PARAMETERS
-Path <String>
The mount point (i.e. G:, \\?\Volume{12345678-abcd-1234-abcd-1234567890a
b}\) or a path to any file on the volume to process
Required? false
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-VdsId <Guid>
The Guid object which uniquely identifies the volume in VDS. Note that
this is not the same as the volume guid path.
Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".
INPUTS
OUTPUTS
NOTES
Category: host
-------------- Example 1 --------------
C:\PS>Invoke-NaHostVolumeSpaceReclaim f:
Reclaim all free space on the LUN mounted as F:\ on the local host.
RELATED LINKS
| Copyright © 2013 NetApp. All rights reserved. Use is subject to license terms. |
|
Data ONTAP® PowerShell Toolkit
|