Get-AIPFileStatus

  • Referência
Módulo:
AzureInformationProtection

Obtém a etiqueta Information Protection Azure e informações de proteção para um ficheiro ou ficheiros especificados.

Syntax

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

Description

O cmdlet Get-AIPFileStatus devolve o estado de Information Protection do Azure de um ficheiro especificado ou de todos os ficheiros num caminho especificado. Este estado inclui se o ficheiro tem uma etiqueta, e se o faz, o nome do rótulo, quem o aplicou, como foi aplicado, e quando.

Se os seus ficheiros forem armazenados no SharePoint Online, utilize o cmdlet Get-FileSensitivityLabelInfo do módulo SharePointOnlinePowerShell .

O estatuto devolvido no cmdlet Get-AIPFileStatus também inclui se o ficheiro está protegido pela Gestão de Direitos, e se for, qual o modelo de Gestão de Direitos usado para aplicar esta proteção. Se o ficheiro foi protegido com permissões personalizadas (uma política de direitos ad-hoc) em vez de um modelo, "Acesso Restrito" é exibido em vez do nome do modelo. Além disso, é apresentado o emitente de Gestão de Direitos e Gestão de Direitos e quando o ficheiro foi protegido.

Este cmdlet devolve apenas informações de etiqueta do seu próprio inquilino.

Note que os ficheiros protegidos por palavra-passe devolvem sempre o estado de proteção do Falso.

Pode executar este cmdlet não interativo. Para mais informações, consulte o guia de administração do cliente de rotulagem Unificada.

Exemplos

Exemplo 1: Obtenha o rótulo e o estado de proteção de um único ficheiro

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

Este comando fornece informações sobre um ficheiro que é rotulado como "Grupo Confidencial \ Finanças", que é um rótulo configurado para o seu inquilino. Este ficheiro foi rotulado manualmente por John e também está protegido através do modelo de Gestão de Direitos, "Contoso - Finanças Confidenciais".

Exemplo 2: Obtenha o rótulo e o estado de proteção de todos os ficheiros numa pasta e exporte os resultados para um ficheiro CSV

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

Este comando obtém a etiqueta e informação de proteção de todos os ficheiros do servidor Finance, na pasta Projetos e em qualquer uma das suas sub-dobradeiras. Os resultados são exportados para o ficheiro nomeado AIP-status.csv para que possam ser mais facilmente pesquisados e classificados. Se existir um relatório anterior em C:\Reports\Report.csv, será substituído.

Exemplo 3: Listar os ficheiros rotulados "Confidencial" e exportar os resultados para um ficheiro CSV

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

Este comando obtém a etiqueta e informações de proteção apenas para os ficheiros que são rotulados como "Confidencial" (independentemente do seu subliber) no servidor Finanças, na pasta Projetos e em qualquer uma das suas sub-dobradeiras. Os resultados são exportados para o ficheiro nomeado AIP-status.csv para que possam ser mais facilmente pesquisados e classificados. Se existir um relatório anterior em C:\Reports\Report.csv, será substituído.

Exemplo 4: Contagem de ficheiros com uma etiqueta "Confidencial"

PS C:\> (Get-AIPFileStatus -Path C:\Projects\ | Where-Object {$_.MainLabelName -eq 'Confidential'}).Count

5

Este comando fornece o número de ficheiros com a etiqueta "Confidencial" que se encontram na pasta C:\Projetos e em qualquer uma das suas sub-dobradeiras. Neste exemplo, são encontrados 5 ficheiros.

Parâmetros

-Path

Especifica um caminho local, caminho de rede ou URL do Servidor SharePoint para os ficheiros para os quais deseja obter as informações de etiqueta e proteção. Não são suportados carateres universais.

Para os caminhos sharePoint, os seguintes são suportados:

  • SharePoint Server 2019
  • SharePoint Server 2016
  • SharePoint Server 2013

Por exemplo:

Os caminhos podem incluir espaços quando se encerra o valor do caminho com aspas.

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

Entradas

System.String[]

Saídas

Microsoft.InformationProtection.Powershell.AIP.Results.GetAIPFileStatusResult