共用方式為

Get-FileStatus

  • 參考
模組:
PurviewInformationProtection

取得指定檔案或檔案的 Microsoft Purview 資訊保護 標籤和保護資訊。

語法

Get-FileStatus
   [-Path] <String[]>
   [<CommonParameters>]

Description

Get-FileStatus Cmdlet 會傳回指定檔案的狀態或指定路徑中的所有檔案。 此狀態包括檔案是否有標籤，如果是，則為標籤名稱、套用者、套用方式，以及何時。

如果您的檔案儲存在 SharePoint Online 中，請改用 SharePointOnlinePowerShell 模組中的 Get-FileSensitivityLabelInfo Cmdlet。

Get-FileStatus Cmdlet 中傳回的狀態也包含檔案是否受到 Rights Management 保護，如果是，則會使用何種 Rights Management 範本來套用此保護。 如果檔案受到自定義許可權保護， (臨機操作許可權原則) 而不是範本，則會顯示「限制存取」，而不是範本名稱。 此外，也會顯示 Rights Management 擁有者和 Rights Management 簽發者 ，以及當檔案受到保護時。

此 Cmdlet 只會從您自己的租用戶傳回標籤資訊。

請注意，受密碼保護的檔案一律會傳回 False 的保護狀態。

您可以非互動方式執行此 Cmdlet。

範例

範例 1：取得單一檔案的標籤和保護狀態

PS C:\> Get-FileStatus -Path \\Finance\Projects\Project.docx

FileName        : \\Finance\Projects\Project.docx
IsLabeled       : True
MainLabelId     : 074e257c-1234-1234-1234-34a182080e71
MainLabelName   : Confidential
SubLabelId      : d9f23ae3-1234-1234-1234-f515f824c57b
SubLabelName    : Finance group
LabelingMethod  : Privileged
LabelDate       : 12/12/2016 12:24:36 PM
IsRMSProtected  : True
RMSTemplateId   : e6ee2481-1234-1234-1234-f744eacd53b0
RMSTemplateName : Contoso - Confidential Finance
RMSOwner        : John@Contoso.com
RMSIssuer       : John@Contoso.com
ContentId       : 4ca757d2-83bf-4ec3-b93b-c7fe9433bf33

此命令提供標示為「機密\財務群組」的檔案相關信息，這是為租用戶設定的標籤。 此檔案是由 John 手動加上標籤，並且也受到 Rights Management 範本 “Contoso - 機密財務” 的保護。

範例 2：取得資料夾中所有檔案的標籤和保護狀態，並將結果匯出至 CSV 檔案

PS C:\> Get-FileStatus -Path \\Finance\Projects\ | Export-Csv C:\Reports\Report.csv

此命令會取得 Finance 伺服器上所有檔案的標籤和保護資訊，位於 Projects 資料夾及其任何子資料夾中。 結果會匯出至名為 Report.csv 的檔案，以便更輕鬆地搜尋和排序結果。 如果先前的報表存在於 C:\Reports\Report.csv中，則會覆寫它。

範例 3：列出標示為「機密」的檔案，並將結果匯出至 CSV 檔案

PS C:\> Get-FileStatus -Path \\Finance\Projects\ | Where-Object {$_.MainLabelName -eq 'Confidential'} | Export-Csv C:\Reports\Report.csv

此命令只會取得標示為「機密」 (的檔案的卷標和保護資訊，不論其子捲標在 Finance 伺服器上的子捲標) ，在 Projects 資料夾及其任何子資料夾中。 結果會匯出至名為 Report.csv 的檔案，以便更輕鬆地搜尋和排序結果。 如果先前的報表存在於 C:\Reports\Report.csv中，則會覆寫它。

範例 4：具有「機密」卷標的檔案計數

PS C:\> (Get-FileStatus -Path C:\Projects\ | Where-Object {$_.MainLabelName -eq 'Confidential'}).Count

5

此命令會提供 C：\Projects 資料夾中及其任何子資料夾中具有「機密」卷標的檔案數目。 在此範例中，找到5個檔案。

參數

-Path

指定您要取得標籤和保護資訊的檔案的本機路徑、網路路徑或 SharePoint Server URL。 不支援萬用字元。

針對 SharePoint 路徑，支援下列各項：

  • SharePoint Server 2019
  • SharePoint Server 2016
  • SharePoint Server 2013

例如：

當您以引弧括住路徑值時，路徑可以包含空格。

類型:String[]
別名:FullName, FileName
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

輸入

System.String[]

輸出

Microsoft.InformationProtection.Powershell.AIP.Results.GetAIPFileStatusResult