Partilhar via

Remove-FileLabel

Módulo:
PurviewInformationProtection Module

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

Sintaxe

RemoveLabel 

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

RemoveLabelProtection 

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

RemoveProtection 

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

Descrição

Para o cliente Microsoft Purview Information Protection, 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

Este comando remove o rótulo existente do arquivo chamado C:\Projects\Analysis.docxe especifica uma mensagem de justificação obrigatória.

Esse método de justificação é necessário porque a configuração da política de rótulo de sensibilidade relevante está habilitada para exigir uma 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 a etiqueta que está a remover estiver a proteger o ficheiro através de permissões personalizadas, este comando remove apenas a etiqueta.

Exemplo 8: Remover proteção de um arquivo

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 arquivo chamado Analysis.docx.

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

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

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

Este 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 justificação para remover um rótulo, o motivo da justificação também é fornecido para que o comando possa ser concluído sem avisar o usuário sobre o motivo.

Parâmetros

-JustificationMessage

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

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-Path

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

Não há suporte para curingas e locais WebDav não são suportados.

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

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

Propriedades dos parâmetros

Tipo:

String[]

Valor padrão:None
Suporta curingas:False
DontShow:False
Pseudónimos:Nome Completo, Nome do arquivo

Conjuntos de parâmetros

(All)
Posição:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes:False

-PreserveFileDetails

Especifique este parâmetro para deixar os valores de data modificada (Windows e SharePoint) e modificados por (SharePoint) inalterados para documentos rotulados:

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

  • Para arquivos do SharePoint, os valores Data de modificação e Modificado por permanecem inalterados.

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-RemoveLabel

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

RemoveLabel
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
RemoveLabelProtection
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-RemoveProtection

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

Você deve ter direitos de uso suficientes ou ser um superusuário para que sua organização remova a proteção dos 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 PowerShell para habilitar a remoção da proteção de arquivos de contêiner (zip, .rar, .7z e .pst).

Observação

  • Esse recurso de proteção de remoção é desabilitado por padrão e deve primeiro ser habilitado usando o cmdlet Set-LabelPolicy .

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

RemoveLabelProtection
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
RemoveProtection
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

Entradas

System.String

Saídas

Microsoft.InformationProtection.Powershell.AIP.Results.SetAIPFileResult