Get-ForensicUnallocatedSpace

NAME Get-ForensicUnallocatedSpace



SYNOPSIS

Gets the unallocated space on the specified partition/volume.





SYNTAX

Get-ForensicUnallocatedSpace [[-VolumeName] <String>] [-Path <UInt64>] [<CommonParameters>]





DESCRIPTION

The Get-ForensicUnallocatedSpace cmdlet parses the $Bitmap file to find clusters that are marked as unallocated

(not in use by the file system). Then, the cmdlet returns the unallocated clusters as a byte array.



Except as noted, the cmdlets in the PowerForensics module require the permissions of a member of the

Administrators group on the computer. To run them, start Windows PowerShell with the 'Run as administrator' option.





PARAMETERS

-VolumeName [<String>]

Specifies the name of the volume or logical partition.



Enter the volume name in one of the following formats: \\\\.\\C:, C:, or C.



Required? false

Position? 0

Default value \\\\.\\C:

Accept pipeline input? false

Accept wildcard characters? false



-Path [<UInt64>]





Required? false

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

None







OUTPUTS

System.Byte[]













-------------------------- EXAMPLE 1 --------------------------



[ADMIN]: PS C:\\>Get-ForensicUnallocatedSpace -VolumeName \\\\.\\Z:



This command gets a byte array of unallocated clusters in the \\\\.\\Z: volume.



RELATED LINKS