Get-FileStatus

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

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 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 estiver, 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 do seu próprio locatário.

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

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

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 "Confidencial \ Grupo de finanças", que é um rótulo configurado para seu locatário. Esse arquivo foi rotulado manualmente por John e também é protegido usando o modelo Rights Management, "Contoso – Confidential Finance".

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 Finance, 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 existir um relatório anterior em C:\Reports\Report.csv, ele será substituído.

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 Finance, 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 existir um relatório anterior em C:\Reports\Report.csv, ele será substituído.

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:\Projetos e em qualquer uma de suas subpastas. Neste exemplo, 5 arquivos são encontrados.

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.