Get-FileStorageTier

發行項
11/17/2015

Get-FileStorageTier

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

語法

Parameter Set: ByVolumeDriveLetter
Get-FileStorageTier -VolumeDriveLetter <Char> [-AsJob] [-CimSession <CimSession[]> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: ByFilePath
Get-FileStorageTier -FilePath <String> [-AsJob] [-CimSession <CimSession[]> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: ByVolume
Get-FileStorageTier -Volume <CimInstance> [-AsJob] [-CimSession <CimSession[]> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: ByVolumePath
Get-FileStorageTier -VolumePath <String> [-AsJob] [-CimSession <CimSession[]> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

詳細描述

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

參數

-AsJob

別名	無
必要？	false
位置？	named
預設值	無
接受管線輸入？	false
接受萬用字元？	false

-CimSession<CimSession[]>

在遠端工作階段或遠端電腦上執行 Cmdlet。輸入電腦名稱或工作階段物件，例如 New-CimSession 或 Get-CimSession Cmdlet 的輸出。預設為本機電腦上的目前工作階段。

別名	Session
必要？	false
位置？	named
預設值	無
接受管線輸入？	false
接受萬用字元？	false

-FilePath<String>

Specifies the full path of a file. The cmdlet gets the pinned file that you specify and its status.

別名	無
必要？	true
位置？	named
預設值	無
接受管線輸入？	True (ByPropertyName)
接受萬用字元？	false

-ThrottleLimit<Int32>

指定為執行此 Cmdlet 可建立的最大同時作業數。如果省略這個參數或輸入 0 的值，則 Windows PowerShell® 會根據在電腦上執行的 CIM Cmdlet 數目，計算 Cmdlet 的最佳節流限制。節流限制僅適用於目前 Cmdlet，不適用於工作階段或電腦。

別名	無
必要？	false
位置？	named
預設值	無
接受管線輸入？	false
接受萬用字元？	false

-Volume<CimInstance>

Specifies a volume as a CimInstance object. The cmdlet gets the pinned files for the volume that you specify, and their status values. To obtain a volume, use the Get-Volume cmdlet.

別名	無
必要？	true
位置？	named
預設值	無
接受管線輸入？	True (ByValue)
接受萬用字元？	false

-VolumeDriveLetter<Char>

Specifies the drive letter of a volume. The cmdlet gets the pinned files for the volume that you specify, and their status values.

別名	無
必要？	true
位置？	named
預設值	無
接受管線輸入？	True (ByPropertyName)
接受萬用字元？	false

-VolumePath<String>

Specifies the path of a volume. The cmdlet gets the pinned files for the volume that you specify, and their status values.

別名	無
必要？	true
位置？	named
預設值	無
接受管線輸入？	True (ByPropertyName)
接受萬用字元？	false

<CommonParameters>

此 Cmdlet 支援一般參數：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 與 -OutVariable。如需詳細資訊，請參閱 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

輸入

輸入類型是您可以使用管線處理方式傳遞給 Cmdlet 的物件類型。

輸出

輸出類型是 Cmdlet 所發出的物件類型。

MSFT_FileStorageTier

This cmdlet generates a file storage tier object that contains the desired storage tier, file path, status, desired storage tier file size, and state. State includes values of Ok, Pending, and Processing.

範例

Example 1: Get status for a file

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

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

Example 2: Get pinned files for a volume

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

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

Get-FileStorageTier