Compartilhar via

Remove-FileLabel

Módulo:
PurviewInformationProtection Module

Remove o rótulo de confidencialidade de um arquivo ou remove a proteção de acordo com a configuração de 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]

Description

Para o cliente da 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 estiver protegendo o arquivo usando um modelo, esse comando removerá o rótulo e a proteção.

Se o rótulo que você está removendo estiver 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:\> Remove-FileLabel 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 avisar o usuário pelo motivo.

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. Nesse caso, o status retornado é "Ignorado" com o comentário "Justificativa necessária".

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

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

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 do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:Nome Completo, Nome do Arquivo

Conjuntos de parâmetros

(All)
Cargo:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-PreserveFileDetails

Especifique este 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 de data permanece inalterado.

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RemoveLabel

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

RemoveLabel
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
RemoveLabelProtection
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 dos arquivos. Para obter mais informações, consulte Configurar 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

  • Essa funcionalidade de remoção de proteção é 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 compatível com esse cmdlet.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

RemoveLabelProtection
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
RemoveProtection
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

Entradas

System.String

Saídas

Microsoft.InformationProtection.Powershell.AIP.Results.SetAIPFileResult