Get-AIPFileStatus

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

Syntax

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

Description

Get-AIPFileStatus Cmdlet 會傳回指定檔案或指定路徑中所有檔案的 Azure 資訊保護狀態。 此狀態包括檔案是否有標籤,如果有標籤,則為標籤名稱、套用者、套用方式和時機。

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

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

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

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

您可以非互動方式執行此 Cmdlet。 如需詳細資訊,請參閱 統一標籤用戶端系統管理員指南

範例

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

PS C:\> Get-AIPFileStatus -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-AIPFileStatus -Path \\Finance\Projects\ | Export-Csv C:\Reports\AIP-status.csv

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

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

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

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

範例 4:具有「機密」標籤的檔案計數

PS C:\> (Get-AIPFileStatus -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

例如:

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

Type:String[]
Aliases:FullName, FileName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

輸入

System.String[]

輸出

Microsoft.InformationProtection.Powershell.AIP.Results.GetAIPFileStatusResult