Partilhar via

Get-FileStatus

  • Referência
Módulo:
PurviewInformationProtection

Obtém a etiqueta Proteção de Informações do Microsoft Purview e as informações de proteção de um ficheiro ou ficheiros especificados.

Sintaxe

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

Description

O cmdlet Get-FileStatus devolve o estado de um ficheiro especificado ou de todos os ficheiros num caminho especificado. Este estado inclui se o ficheiro tem uma etiqueta e, se tiver, o nome da etiqueta, quem o aplicou, como foi aplicado e quando.

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

O estado devolvido no cmdlet Get-FileStatus também inclui se o ficheiro está protegido pelo Rights Management e, se for, o modelo Rights Management que foi utilizado para aplicar esta proteção. Se o ficheiro tiver sido protegido com permissões personalizadas (uma política de direitos ad hoc) em vez de um modelo, será apresentado "Acesso Restrito" em vez do nome do modelo. Além disso, o proprietário do Rights Management e o emissor do Rights Management são apresentados e quando o ficheiro foi protegido.

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

Tenha em atenção que os ficheiros protegidos por palavra-passe devolvem sempre o estado de proteção de Falso.

Pode executar este cmdlet de forma não interativa.

Exemplos

Exemplo 1: Obter a etiqueta e o estado de proteção de um único ficheiro

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

Este comando fornece informações sobre um ficheiro que está etiquetado como "Confidencial \ Grupo Financeiro", que é uma etiqueta que está configurada para o seu inquilino. Este ficheiro foi etiquetado manualmente pelo João e também está protegido através do modelo Rights Management, "Contoso – Finanças Confidenciais".

Exemplo 2: obter a etiqueta e o estado de proteção de todos os ficheiros numa pasta e exportar os resultados para um ficheiro CSV

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

Este comando obtém a etiqueta e as informações de proteção de todos os ficheiros no servidor Finanças, na pasta Projetos e em qualquer uma das respetivas subpastas. Os resultados são exportados para o ficheiro com o nome Report.csv para que possam ser mais facilmente pesquisados e ordenados. Se existir um relatório anterior no C:\Reports\Report.csv, será substituído.

Exemplo 3: listar os ficheiros com a etiqueta "Confidencial" e exportar os resultados para um ficheiro CSV

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

Este comando obtém as informações de etiqueta e proteção apenas para os ficheiros com o nome "Confidencial" (independentemente da respetiva sub-etiqueta) no servidor Finanças, na pasta Projetos e em qualquer uma das respetivas subpastas. Os resultados são exportados para o ficheiro com o nome Report.csv para que possam ser mais facilmente pesquisados e ordenados. Se existir um relatório anterior no C:\Reports\Report.csv, será substituído.

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

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

5

Este comando fornece o número de ficheiros com a etiqueta "Confidencial" que se encontra na pasta C:\Projects e qualquer uma das respetivas subpastas. Neste exemplo, são encontrados 5 ficheiros.

Parâmetros

-Path

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

Para os caminhos do SharePoint, são suportados os seguintes:

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

Por exemplo:

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

Tipo:String[]
Aliases:FullName, FileName
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Entradas

System.String[]

Saídas

Microsoft.InformationProtection.Powershell.AIP.Results.GetAIPFileStatusResult