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

-CimSession<CimSession[]>

Запуск командлета в удаленном сеансе или на удаленном компьютере. Введите имя компьютера или объекта сеанса, например результат выполнения командлета New-CimSession или Get-CimSession. Сеанс по умолчанию — текущий сеанс на локальном компьютере.

-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.

-DesiredStorageTierFriendlyName<String>

Specifies the friendly name of a storage tier to pin a file to.

-DesiredStorageTierUniqueId<String>

Specifies the unique ID, as a string, of a storage tier to pin a file to.

-FilePath<String>

Specifies the full path of a file. The cmdlet pins the file that you specify to a storage tier.

-ThrottleLimit<Int32>

Определяет максимальное число одновременных операций, которое можно установить для запуска командлета. Если этот параметр опущен или имеет значение 0, Windows PowerShell® вычисляет оптимальный предел регулирования для командлета на основе числа командлетов CIM, запущенных на компьютере. Предел регулирования применяется только к текущему командлету, а не к сеансу или компьютеру.

-Confirm

Запрос на подтверждение перед выполнением командлета.

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не запущен.

<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"

Связанные темы

Clear-FileStorageTier

Get-FileStorageTier

Get-StorageTier