Get-FileStatus

Módulo:: PurviewInformationProtection

Obtém o rótulo do Microsoft Purview Information Protection e informações de 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 de todos os arquivos em um caminho especificado. Esse status inclui se o arquivo tem um rótulo e, em caso afirmativo, o nome do rótulo, quem o aplicou, como foi aplicado e quando.

Se seus 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, em caso afirmativo, 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" é 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.

Este cmdlet retorna informações de rótulo somente do 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.

Exemplos

Exemplo 1: Obter o rótulo e o status de proteção 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

Este comando fornece informações sobre um ficheiro rotulado como "Grupo Confidencial \ Finanças", que é uma etiqueta configurada para o seu inquilino. Esse arquivo foi rotulado manualmente por John e também é protegido usando o modelo Rights Management, "Contoso - Confidential Finance".

Exemplo 2: Obter o rótulo e o status de proteção 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

Este comando obtém o rótulo e as informações de 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 mais facilmente pesquisados e classificados. Se existir um relatório anterior no C:\Reports\Report.csv, ele será substituído.

Exemplo 3: Liste os arquivos rotulados como "Confidenciais" e exporte os resultados para um arquivo CSV

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

Este comando obtém o rótulo e as informações de proteção apenas para os arquivos rotulados como "Confidenciais" (independentemente de seu subró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 mais facilmente pesquisados e classificados. Se existir um relatório anterior no C:\Reports\Report.csv, ele 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 arquivos com o rótulo "Confidencial" que estão na pasta C:\Projects e qualquer uma de suas subpastas. Neste exemplo, 5 arquivos são encontrados.

Parâmetros

-Path

Especifica um caminho local, caminho de rede ou 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 curingas.

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

SharePoint Server 2019
SharePoint Server 2016
SharePoint Server 2013

Por exemplo:

C:\Pasta\
C:\Pasta\Nome do arquivo
\\Servidor\Pasta
http://sharepoint.contoso.com/Shared%20Documents/Folder

Os caminhos podem incluir espaços quando você 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

Partilhar via