Get-AIPFileStatus

  • Referência
Módulo:
AzureInformationProtection

Obtém o rótulo Proteção de Informações do Azure e as informações de proteção para um arquivo ou arquivos especificados.

Syntax

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

Description

O cmdlet Get-AIPFileStatus retorna o status Proteção de Informações do Azure de um arquivo especificado ou todos os arquivos em um caminho especificado. Esse status inclui se o arquivo tem um rótulo e, se ele tem, o nome do rótulo, quem o aplicou, como ele foi aplicado e quando.

Se os arquivos estiverem armazenados no SharePoint Online, use o cmdlet Get-FileSensitivityLabelInfo do módulo SharePointOnlinePowerShell .

O status retornado no cmdlet Get-AIPFileStatus também inclui se o arquivo está protegido pelo Rights Management e, se for, qual modelo do Rights Management foi usado para aplicar essa proteção. Se o arquivo foi protegido com permissões personalizadas (uma política de direitos ad hoc) em vez de um modelo, "Acesso Restrito" será exibido em vez do nome do modelo. Além disso, o proprietário do Rights Management e o emissor do Rights Management são exibidos e quando o arquivo foi protegido.

Esse cmdlet retorna informações de rótulo somente de seu próprio locatário.

Observe que os arquivos protegidos por senha sempre retornam o status de proteção de False.

Você pode executar esse cmdlet de forma não interativa. Para obter mais informações, consulte o guia de administrador do cliente de rotulagem unificada.

Exemplos

Exemplo 1: obter o status de rótulo e proteção de um único arquivo

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

Esse comando fornece informações sobre um arquivo rotulado como "Grupo Confidencial \ Finanças", que é um rótulo configurado para seu locatário. Esse arquivo foi rotulado manualmente por João e também é protegido usando o modelo de Gerenciamento de Direitos, "Contoso – Finanças Confidenciais".

Exemplo 2: obter o status de rótulo e proteção para todos os arquivos em uma pasta e exportar os resultados para um arquivo CSV

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

Esse comando obtém as informações de rótulo e proteção de todos os arquivos no servidor finanças, na pasta Projetos e em qualquer uma de suas subpastas. Os resultados são exportados para o arquivo chamado AIP-status.csv para que possam ser pesquisados e classificados com mais facilidade. Se existir um relatório anterior em C:\Reports\Report.csv, ele será substituído.

Exemplo 3: listar os arquivos rotulados como "Confidenciais" e exportar os resultados para um arquivo CSV

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

Esse comando obtém o rótulo e as informações de proteção apenas para os arquivos rotulados como "Confidenciais" (independentemente de seu sub-rótulo) no servidor de Finanças, na pasta Projetos e em qualquer uma de suas subpastas. Os resultados são exportados para o arquivo chamado AIP-status.csv para que possam ser pesquisados e classificados com mais facilidade. Se existir um relatório anterior em C:\Reports\Report.csv, ele será substituído.

Exemplo 4: contagem de arquivos com um rótulo "Confidencial"

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

5

Esse comando fornece o número de arquivos com o rótulo "Confidencial" que estão na pasta C:\Projects e qualquer uma de suas subpastas. Neste exemplo, cinco arquivos são encontrados.

Parâmetros

-Path

Especifica um caminho local, um caminho de rede ou a URL do SharePoint Server para os arquivos para os quais você deseja obter o rótulo e as informações de proteção. Não há suporte para caracteres curinga.

Para caminhos do SharePoint, há suporte para o seguinte:

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

Por exemplo:

Os caminhos podem incluir espaços quando você coloca entre aspas o valor do caminho.

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