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

Get-FileStatus

获取一个或多个指定文件的Microsoft Purview 信息保护标签和保护信息。

语法

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

说明

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 手动标记,并且还通过使用权限管理模板“Contoso - 机密财务”对其进行保护。

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

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

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

此命令仅获取标记为“机密”的文件的标签和保护信息, (而不考虑其子标签) 财务服务器上的项目文件夹及其任何子文件夹中。 结果将导出到名为 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