Compartilhar via

Get-FileStatus

  • Referência
Módulo:
PurviewInformationProtection

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

Sintaxe

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

Description

O cmdlet Get-FileStatus retorna o status de um arquivo especificado ou todos os arquivos em um caminho especificado. Esse status inclui se o arquivo tem um rótulo e, se tiver, 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-FileStatus 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 tiver sido 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 a status de proteção de False.

Você pode executar esse cmdlet de forma não interativa.

Exemplos

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

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

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 do Rights Management, "Contoso – Finanças Confidenciais".

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

PS C:\> Get-FileStatus -Path \\Finance\Projects\ | Export-Csv C:\Reports\Report.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 Report.csv para que possam ser pesquisados e classificados com mais facilidade. Se um relatório anterior existir no 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-FileStatus -Path \\Finance\Projects\ | Where-Object {$_.MainLabelName -eq 'Confidential'} | Export-Csv C:\Reports\Report.csv

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

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

PS C:\> (Get-FileStatus -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 uma URL do SharePoint Server para os arquivos para os quais você deseja obter as informações de rótulo e 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 o valor do caminho entre aspas.

Tipo:String[]
Aliases:FullName, FileName
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

System.String[]

Saídas

Microsoft.InformationProtection.Powershell.AIP.Results.GetAIPFileStatusResult