Get-FileStorageTier
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[]>
Запуск командлета в удаленном сеансе или на удаленном компьютере. Введите имя компьютера или объекта сеанса, например результат выполнения командлета New-CimSession или Get-CimSession. Сеанс по умолчанию — текущий сеанс на локальном компьютере.
Псевдонимы |
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>
Определяет максимальное число одновременных операций, которое можно установить для запуска командлета. Если этот параметр опущен или имеет значение 0
, Windows PowerShell® вычисляет оптимальный предел регулирования для командлета на основе числа командлетов CIM, запущенных на компьютере. Предел регулирования применяется только к текущему командлету, а не к сеансу или компьютеру.
Псевдонимы |
отсутствуют |
Требуется? |
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>
Этот командлет поддерживает следующие параметры: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, и -OutVariable. Для получения дополнительных сведений см. about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Входные данные
Тип входных данных — это тип объектов, которые можно передать в командлет через конвейер.
Выходные данные
Тип выходных данных — это тип объектов, которые выдает командлет.
-
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}\"