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

Get-AIPFileStatus

参考

模块:: AzureInformationProtection

获取指定文件或文件的 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

例如：

C：\Folder\
C：\Folder\Filename
\\Server\Folder
http://sharepoint.contoso.com/Shared%20Documents/Folder

将路径值用引号括起来时，路径可以包含空格。

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