Set-FileStorageTier
Set-FileStorageTier
Assigns a file to a storage tier.
Синтаксис
Parameter Set: ByDesiredStorageTierFriendlyName
Set-FileStorageTier -DesiredStorageTierFriendlyName <String> -FilePath <String> [-AsJob] [-CimSession <CimSession[]> ] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: ByDesiredStorageTier
Set-FileStorageTier -DesiredStorageTier <CimInstance> -FilePath <String> [-AsJob] [-CimSession <CimSession[]> ] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: ByDesiredStorageTierUniqueId
Set-FileStorageTier -DesiredStorageTierUniqueId <String> -FilePath <String> [-AsJob] [-CimSession <CimSession[]> ] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Подробное описание
The Set-FileStorageTier cmdlet assigns a file to a specified storage tier. Assigning a file to a tier is also called pinning the file to a tier. To pin a file to a storage tier, the file must be on a volume that is hosted by the same tiered storage space. If you pin a file that is already assigned to a different tier, the file changes assignment the next time tier optimization takes place.
Параметры
-AsJob
Псевдонимы |
отсутствуют |
Требуется? |
false |
Указать положение? |
named |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
false |
Принимать подстановочные знаки? |
false |
-CimSession<CimSession[]>
Запуск командлета в удаленном сеансе или на удаленном компьютере. Введите имя компьютера или объекта сеанса, например результат выполнения командлета New-CimSession или Get-CimSession. Сеанс по умолчанию — текущий сеанс на локальном компьютере.
Псевдонимы |
Session |
Требуется? |
false |
Указать положение? |
named |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
false |
Принимать подстановочные знаки? |
false |
-DesiredStorageTier<CimInstance>
Specifies the storage tier, as a CimInstance object, to pin a file to. To obtain a storage tier object, use the Get-StorageTier cmdlet.
Псевдонимы |
отсутствуют |
Требуется? |
true |
Указать положение? |
named |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
True (ByPropertyName) |
Принимать подстановочные знаки? |
false |
-DesiredStorageTierFriendlyName<String>
Specifies the friendly name of a storage tier to pin a file to.
Псевдонимы |
отсутствуют |
Требуется? |
true |
Указать положение? |
named |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
True (ByPropertyName) |
Принимать подстановочные знаки? |
false |
-DesiredStorageTierUniqueId<String>
Specifies the unique ID, as a string, of a storage tier to pin a file to.
Псевдонимы |
отсутствуют |
Требуется? |
true |
Указать положение? |
named |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
True (ByPropertyName) |
Принимать подстановочные знаки? |
false |
-FilePath<String>
Specifies the full path of a file. The cmdlet pins the file that you specify to a storage tier.
Псевдонимы |
отсутствуют |
Требуется? |
true |
Указать положение? |
named |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
True (ByPropertyName) |
Принимать подстановочные знаки? |
false |
-ThrottleLimit<Int32>
Определяет максимальное число одновременных операций, которое можно установить для запуска командлета. Если этот параметр опущен или имеет значение 0
, Windows PowerShell® вычисляет оптимальный предел регулирования для командлета на основе числа командлетов CIM, запущенных на компьютере. Предел регулирования применяется только к текущему командлету, а не к сеансу или компьютеру.
Псевдонимы |
отсутствуют |
Требуется? |
false |
Указать положение? |
named |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
false |
Принимать подстановочные знаки? |
false |
-Confirm
Запрос на подтверждение перед выполнением командлета.
Требуется? |
false |
Указать положение? |
named |
Значение по умолчанию |
false |
Принимать входные данные конвейера? |
false |
Принимать подстановочные знаки? |
false |
-WhatIf
Показывает, что произойдет при запуске командлета. Командлет не запущен.
Требуется? |
false |
Указать положение? |
named |
Значение по умолчанию |
false |
Принимать входные данные конвейера? |
false |
Принимать подстановочные знаки? |
false |
<CommonParameters>
Этот командлет поддерживает следующие параметры: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, и -OutVariable. Для получения дополнительных сведений см. about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Входные данные
Тип входных данных — это тип объектов, которые можно передать в командлет через конвейер.
Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_StorageTier
You can use the pipeline operator to pass an MSFT_StorageTier object to the DesiredStorageTier parameter.
Выходные данные
Тип выходных данных — это тип объектов, которые выдает командлет.
- This cmdlet does not generate any output.
Примечания
- Объект
Microsoft.Management.Infrastructure.CimInstance
является классом-оболочкой, который отображает объекты инструментария управления Windows (WMI). После символа решетки (#
) задается пространство имен и имя класса базового объекта инструментария управления Windows.
Примеры
Example 1: Pin a file to a storage tier
The first command uses the Get-StorageTier cmdlet to get a storage tier named Tier07, and then stores the tier in the $StorageTier variable.
The second command pins the specified file to a storage tier. The command specifies the storage tier by using the object stored in the $StorageTier variable.
PS C:\> $StorageTier = Get-StorageTier -FriendlyName "Tier07"
PS C:\> Set-FileStorageTier -DesiredStorageTier $StorageTier -FilePath "D:\DataFile06.txt"
Example 2: Pin a file to a storage tier by using an ID
The first command uses the Get-StorageTier cmdlet to get a storage tier named Tier07, and then stores the tier in the $StorageTier variable.
The second command pins the specified file to a storage tier. The command specifies the ID of the storage tier by using the UniqueID property of the storage tier object stored in the $StorageTier variable.
PS C:\> $StorageTier = Get- StorageTier -FriendlyName "Tier07"
PS C:\> Set-FileStorageTier -DesiredStorageTierUniqueId $StorageTier.UniqueId -FilePath "D:\DataFile06.txt"