Compartir a través de

Remove-FileLabel

Módulo:
PurviewInformationProtection Module

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

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 el cliente de 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 tanto la etiqueta como la protección.

Si la etiqueta que va a quitar estaba protegiendo el archivo mediante permisos personalizados, este comando quita solo 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:\> 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 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, no se quita la etiqueta. En este caso, el estado devuelto es "Omitido" con el comentario "Justificación requerida".

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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 protección y etiqueta.

No se admiten caracteres comodín y no se admiten ubicaciones webDav.

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

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

Por ejemplo:

  • C:\Carpeta\
  • C:\Carpeta\Nombre de archivo
  • \\Servidor\Carpeta
  • http://sharepoint.contoso.com/Shared%20Documents/Folder

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

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Nombre completo, NombreDeArchivo

Conjuntos de parámetros

(All)
Posición:0
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-PreserveFileDetails

Especifique este parámetro para dejar la fecha de modificación (Windows y SharePoint) y los valores modificados por (SharePoint) sin cambios 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.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RemoveLabel

Quita cualquier etiqueta que se haya aplicado a un archivo.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

RemoveLabel
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
RemoveLabelProtection
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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 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.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

RemoveLabelProtection
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
RemoveProtection
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

Entradas

System.String

Salidas

Microsoft.InformationProtection.Powershell.AIP.Results.SetAIPFileResult