Compartir a través de

Remove-FileLabel

  • Referencia
Módulo:
PurviewInformationProtection

Quita la etiqueta de confidencialidad de un archivo o quita la protección según la configuración de la etiqueta o los permisos personalizados.

Sintaxis

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 el cliente Microsoft Purview Information Protection, el cmdlet Remove-FileLabel quita una etiqueta de confidencialidad para uno o varios archivos.

Ejemplos

Ejemplo 1: Quitar una etiqueta de un archivo

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 quita la etiqueta existente del archivo denominado C:\Projects\Analysis.docxy especifica un mensaje de justificación obligatorio.

Este método de justificación es necesario porque la configuración de directiva de etiqueta de confidencialidad pertinente está habilitada para requerir justificación para quitar una etiqueta.

Nota

Si la etiqueta que va a quitar estaba protegiendo el archivo mediante una plantilla, este comando quita la etiqueta y la protección.

Si la etiqueta que va a quitar protegía el archivo con permisos personalizados, este comando solo quita la etiqueta.

Ejemplo 8: Eliminación de la protección de un archivo

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

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

Este comando quita la protección de un único archivo denominado Analysis.docx.

Ejemplo 9: Eliminación de la protección y una etiqueta de un archivo

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 quita la etiqueta y la protección personalizada de un único archivo denominado Analysis.docx. Dado que la directiva está configurada para requerir justificación para quitar una etiqueta, también se proporciona el motivo de justificación para que el comando pueda completarse sin preguntar al usuario por el motivo.

Parámetros

-JustificationMessage

Motivo de justificación para quitar una etiqueta o quitar la protección si la directiva de etiquetado de confidencialidad requiere que los usuarios proporcionen esta información. Si quitar una etiqueta desencadena la justificación y no se proporciona este motivo, la etiqueta no se quita. En este caso, el estado que se devuelve es "Omitido" con el comentario "Justificación necesaria".

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Path

Especifica una ruta de acceso local, una ruta de acceso de red o una dirección URL de SharePoint Server a los archivos para los que desea quitar la información de etiqueta y protección.

No se admiten los caracteres comodín ni las ubicaciones de WebDAV.

En el caso de las rutas de acceso de SharePoint, se admite lo siguiente:

  • SharePoint Server 2022
  • SharePoint Server 2019
  • SharePoint Server 2016
  • SharePoint Server 2013

Por ejemplo:

Las rutas de acceso pueden incluir espacios al incluir el valor de ruta de acceso entre comillas.

Tipo:String[]
Alias:FullName, FileName
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-PreserveFileDetails

Especifique este parámetro para dejar la fecha de modificación (Windows y SharePoint) y los valores modificados por (SharePoint) sin modificar para los documentos que etiquete:

  • En el caso de los archivos locales o de red, el valor fecha de modificación permanece sin cambios.

  • En el caso de los archivos de SharePoint, los valores Fecha de modificación y Modificado por permanecen sin cambios.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RemoveLabel

Quita cualquier etiqueta que se haya aplicado a un archivo.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RemoveProtection

Quita la protección de un archivo. Si el archivo está etiquetado, la etiqueta no se quita.

Debe tener suficientes derechos de uso o ser superusuario para que su organización quite la protección de los archivos. Para obtener más información, consulte Configuración de superusuarios para Azure Rights Management y servicios de detección o recuperación de datos.

Use el cmdlet Remove-FileLabel de PowerShell para habilitar la eliminación de la protección de archivos de contenedor (zip, .rar, .7z y .pst).

Nota

  • Esta funcionalidad de eliminación de protección está deshabilitada de forma predeterminada y primero debe habilitarse mediante el cmdlet Set-LabelPolicy .

  • Para los archivos .pst, 5 GB es el tamaño máximo de archivo admitido con este cmdlet.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

System.String[]

Salidas

Microsoft.InformationProtection.Powershell.AIP.Results.SetAIPFileResult