Compartilhar via

Remove-FileLabel

  • Referência
Módulo:
PurviewInformationProtection

Remove o rótulo de confidencialidade de um arquivo ou remove a proteção de acordo com a configuração do rótulo ou permissões personalizadas.

Sintaxe

Remove-FileLabel
      [-Path] <String[]>
      [-JustificationMessage <String>]
      [-RemoveLabel]
      [-PreserveFileDetails]
      [<CommonParameters>]
Remove-FileLabel
      [-Path] <String[]>
      [-JustificationMessage <String>]
      [-RemoveLabel]
      [-RemoveProtection]
      [-PreserveFileDetails]
      [<CommonParameters>]
Remove-FileLabel
      [-Path] <String[]>
      [-JustificationMessage <String>]
      [-RemoveProtection]
      [-PreserveFileDetails]
      [<CommonParameters>]

Description

Para o cliente Proteção de Informações do Microsoft Purview, o cmdlet Remove-FileLabel remove um rótulo de confidencialidade para um ou mais arquivos.

Exemplos

Exemplo 1: remover um rótulo de um arquivo

PS C:\> Remove-FileLabel C:\Projects\Analysis.docx -RemoveLabel -JustificationMessage 'The previous label no longer applies'

FileName                   Status Comment
--------                   ------ ------------
C:\Projects\Analysis.docx  Success

Esse comando remove o rótulo existente do arquivo chamado C:\Projects\Analysis.docxe especifica uma mensagem de justificativa obrigatória.

Esse método de justificativa é necessário porque a configuração de política de rótulo de confidencialidade relevante está habilitada para exigir justificativa para remover um rótulo.

Observação

Se o rótulo que você está removendo estava protegendo seu arquivo usando um modelo, esse comando remove o rótulo e a proteção.

Se o rótulo que você está removendo estava protegendo seu arquivo usando permissões personalizadas, esse comando removerá apenas o rótulo.

Exemplo 8: remover a proteção de um arquivo

PS C:\> Remove-FileLabel C:\Projects\Analysis.docx -RemoveProtection

FileName                   Status Comment
--------                   ------ ------------
C:\Projects\Analysis.docx  Success

Esse comando remove a proteção de um único arquivo chamado Analysis.docx.

Exemplo 9: remover a proteção e um rótulo de um arquivo

PS C:\> Set-AIPFileLabel C:\Projects\Analysis.docx -RemoveProtection -RemoveLabel -JustificationMessage 'The previous label no longer applies'

FileName                   Status Comment
--------                   ------ ------------
C:\Projects\Analysis.docx  Success

Esse comando remove o rótulo e a proteção personalizada de um único arquivo chamado Analysis.docx. Como a política está configurada para exigir justificativa para remover um rótulo, o motivo da justificativa também é fornecido para que o comando possa ser concluído sem solicitar o motivo ao usuário.

Parâmetros

-JustificationMessage

O motivo da justificativa para remover um rótulo ou remover a proteção se a política de rotulagem de confidencialidade exigir que os usuários forneçam essas informações. Se a remoção de um rótulo disparar a justificativa e esse motivo não for fornecido, o rótulo não será removido. Neste caso, o status retornado é "Ignorado" com o comentário "Justificativa necessária".

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Path

Especifica um caminho local, um caminho de rede ou uma URL do SharePoint Server para os arquivos para os quais você deseja remover as informações de rótulo e proteção.

Não há suporte para curingas e locais de WebDav.

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

  • SharePoint Server 2022
  • 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

-PreserveFileDetails

Especifique esse parâmetro para deixar a data modificada (Windows e SharePoint) e os valores modificados por (SharePoint) inalterados para documentos que você rotula:

  • Para arquivos locais ou de rede, o valor modificado Date permanece inalterado.

  • Para arquivos do SharePoint, a data modificada e os valores Modificados por permanecem inalterados.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RemoveLabel

Remove qualquer rótulo que tenha sido aplicado a um arquivo.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RemoveProtection

Remove a proteção de um arquivo. Se o arquivo for rotulado, o rótulo não será removido.

Você deve ter direitos de uso suficientes ou ser um superusuário para sua organização remover a proteção de arquivos. Para obter mais informações, consulte Configurando superusuários para o Azure Rights Management e serviços de descoberta ou recuperação de dados.

Use o cmdlet Remove-FileLabel do PowerShell para habilitar a remoção da proteção de arquivos de contêiner (zip, .rar, .7z e .pst).

Observação

  • Essa funcionalidade de remoção de proteção está desabilitada por padrão e deve ser habilitada primeiro usando o cmdlet Set-LabelPolicy .

  • Para arquivos .pst, 5 GB é o tamanho máximo de arquivo com suporte com esse cmdlet.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

System.String[]

Saídas

Microsoft.InformationProtection.Powershell.AIP.Results.SetAIPFileResult