Partilhar via

Remove-FileLabel

  • Referência
Módulo:
PurviewInformationProtection

Remove a etiqueta de confidencialidade de um ficheiro ou remove a proteção de acordo com a configuração da etiqueta 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 uma etiqueta de confidencialidade para um ou mais ficheiros.

Exemplos

Exemplo 1: Remover uma etiqueta de um ficheiro

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

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

Este comando remove a etiqueta existente do ficheiro com o nome C:\Projects\Analysis.docxe especifica uma mensagem de justificação obrigatória.

Este método de justificação é necessário porque a definição de política de etiqueta de confidencialidade relevante está ativada para exigir justificação para remover uma etiqueta.

Nota

Se a etiqueta que está a remover estiver a proteger o ficheiro com um modelo, este comando remove a etiqueta e a proteção.

Se a etiqueta que está a remover estiver a proteger o seu ficheiro com permissões personalizadas, este comando remove apenas a etiqueta.

Exemplo 8: Remover a proteção de um ficheiro

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

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

Este comando remove a proteção de um único ficheiro com o nome Analysis.docx.

Exemplo 9: remover a proteção e uma etiqueta de um ficheiro

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

Este comando remove a etiqueta e a proteção personalizada de um único ficheiro com o nomeAnalysis.docx. Uma vez que a política está configurada para exigir justificação para remover uma etiqueta, o motivo da justificação também é fornecido para que o comando possa ser concluído sem pedir ao utilizador o motivo.

Parâmetros

-JustificationMessage

A justificação para remover uma etiqueta ou remover a proteção se a política de etiquetagem de confidencialidade exigir que os utilizadores forneçam estas informações. Se a remoção de uma etiqueta acionar a justificação e este motivo não for fornecido, a etiqueta não será removida. Neste caso, o estado devolvido é "Ignorado" com o comentário "Justificação necessária".

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Path

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

Os carateres universais não são suportados e as localizações webDav não são suportadas.

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

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

-PreserveFileDetails

Especifique este parâmetro para deixar a data de modificação (Windows e SharePoint) e modificado pelos valores (SharePoint) inalterados para documentos que etiquetar:

  • Para ficheiros locais ou de rede, o valor Data de modificação permanece inalterado.

  • Para ficheiros do SharePoint, a data de Modificação e Modificado pelos valores permanecem inalterados.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RemoveLabel

Remove qualquer etiqueta que tenha sido aplicada a um ficheiro.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RemoveProtection

Remove a proteção de um ficheiro. Se o ficheiro estiver etiquetado, a etiqueta não será removida.

Tem de ter direitos de utilização suficientes ou ser um superutilizador para que a sua organização remova a proteção dos ficheiros. Para obter mais informações, veja Configurar superutilizadores para o Azure Rights Management e serviços de deteção ou recuperação de dados.

Utilize o cmdlet Remove-FileLabel PowerShell para ativar a remoção da proteção dos ficheiros de contentor (zip, .rar, .7z e .pst).

Nota

  • Esta capacidade de remoção de proteção está desativada por predefinição e tem de ser ativada primeiro com o cmdlet Set-LabelPolicy .

  • Para ficheiros .pst, 5 GB é o tamanho máximo de ficheiro suportado com este cmdlet.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

System.String[]

Saídas

Microsoft.InformationProtection.Powershell.AIP.Results.SetAIPFileResult