你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Get-AIPFileStatus

获取指定文件或文件的 Azure 信息保护标签和保护信息。

语法

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

说明

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

此命令提供有关标记为“机密 \ Finance 组”的文件的信息,该文件是为租户配置的标签。 此文件由 John 手动标记,并且还使用 Rights Management 模板“Contoso - 机密财务”进行保护。

示例 2:获取文件夹中所有文件的标签和保护状态,并将结果导出到 CSV 文件

PS C:\> Get-AIPFileStatus -Path \\Finance\Projects\ | Export-Csv C:\Reports\AIP-status.csv

此命令获取 Finance 服务器上的所有文件的标签和保护信息,以及 Projects 文件夹中及其任何子文件夹。 结果将导出到名为 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