Clear-FileStorageTier

Clear-FileStorageTier

Removes a file from a storage tier.

語法

Parameter Set: Clear0
Clear-FileStorageTier -FilePath <String> [-AsJob] [-CimSession <CimSession[]> ] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細描述

The Clear-FileStorageTier cmdlet removes a file from a storage tier. Add a file to a storage tier by using the Set-FileStorageTier cmdlet. A file that you assign to a storage tier is called a pinned file.

參數

-AsJob

別名

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-CimSession<CimSession[]>

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

別名

Session

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-FilePath<String>

Specifies the full path of a file. The cmdlet unpins the file that you specify.

別名

必要?

true

位置?

named

預設值

接受管線輸入?

True (ByPropertyName)

接受萬用字元?

false

-ThrottleLimit<Int32>

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

別名

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-Confirm

執行 Cmdlet 之前先提示您確認。

必要?

false

位置?

named

預設值

false

接受管線輸入?

false

接受萬用字元?

false

-WhatIf

顯示執行 Cmdlet 後會發生的情況。未執行 Cmdlet。

必要?

false

位置?

named

預設值

false

接受管線輸入?

false

接受萬用字元?

false

<CommonParameters>

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

輸入

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

輸出

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

範例

Example 1: Unpin Remove a file from a storage tierRemove from a storage tier

This command remvoes the file D:\DataFile06.txt from a storage tier.

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

相關主題

Get-FileStorageTier

Set-FileStorageTier