共用方式為

Get-AIPFileStatus

  • 參考
模組:
AzureInformationProtection

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

語法

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

例如：

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

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

輸入

System.String[]

輸出

Microsoft.InformationProtection.Powershell.AIP.Results.GetAIPFileStatusResult