PowerShell Logo Small

Get-FileStorageTier



This is the built-in help made by Microsoft for the command 'Get-FileStorageTier', in PowerShell version 5 - as retrieved from Windows version 'Microsoft Windows Server 2012 R2 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Gets the files assigned to a storage tier on a volume, and their status.

SYNTAX


Get-FileStorageTier [-AsJob] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] -VolumeDriveLetter <Char> [<CommonParameters>]
Get-FileStorageTier [-AsJob] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] -Volume <CimInstance> [<CommonParameters>]
Get-FileStorageTier [-AsJob] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] -FilePath <String> [<CommonParameters>]
Get-FileStorageTier [-AsJob] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] -VolumePath <String> [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Get-FileStorageTier cmdlet gets all the files assigned to a storage tier on a tiered volume stored on a tiered storage space, and the status of each file. A file that
you assign to a storage tier is called a pinned file. The possible status values are the following:

-- Not on tier
-- Completely on tier
-- Partially on tier



<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?LinkID=206760
Clear-FileStorageTier
Set-FileStorageTier
Get-Volume

REMARKS

<

Examples


Example 1: Get status for a file

PS C:\> Get-FileStorageTier -FilePath "D:\DataFile06.txt"



This command gets the pinned file that you specify, and its status.





Example 2: Get pinned files for a volume

PS C:\> Get-FileStorageTier -VolumePath "\\?\Volume{6d6e000d-6038-11e2-be6d-806e6f6e6963}\"



This command gets the pinned files for the specified volume, and their status values.