Get-FileStatus

模組:: PurviewInformationProtection Module

獲取一個或多個指定檔的 Microsoft Purview 資訊保護標籤和保護資訊。

語法

Default (預設值)

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 - Confidential Finance”進行保護。

範例 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 資料夾及其任何子資料夾中帶有 “Confidential” 標籤的文件數。在此範例中，找到 5 個檔。

參數

-Path

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

針對 SharePoint 路徑，支援下列專案：

SharePoint 伺服器 2019
SharePoint Server 2016
SharePoint 伺服器 2013

例如：

C：\Folder\
C：\Folder\Filename
\\伺服器\資料夾
http://sharepoint.contoso.com/Shared%20Documents/Folder

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

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	全名, 檔案名稱

參數集

(All)

Position:	0
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

CommonParameters

此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。如需詳細資訊，請參閱 about_CommonParameters。

共用方式為