Remove-FileLabel

  • Riferimento
Modulo:
PurviewInformationProtection

Rimuove l'etichetta di riservatezza per un file o rimuove la protezione in base alla configurazione dell'etichetta o alle autorizzazioni personalizzate.

Sintassi

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>]

Descrizione

Per il client Microsoft Purview Information Protection, il cmdlet Remove-FileLabel rimuove un'etichetta di riservatezza per uno o più file.

Esempio

Esempio 1: Rimuovere un'etichetta da un file

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

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

Questo comando rimuove l'etichetta esistente dal file denominato C:\Projects\Analysis.docxe specifica un messaggio di giustificazione obbligatorio.

Questo metodo di giustificazione è necessario perché l'impostazione dei criteri di etichetta di riservatezza pertinente è abilitata per richiedere la giustificazione per la rimozione di un'etichetta.

Nota

Se l'etichetta rimossa protegge il file usando un modello, questo comando rimuove sia l'etichetta che la protezione.

Se l'etichetta rimossa protegge il file usando autorizzazioni personalizzate, questo comando rimuove solo l'etichetta.

Esempio 8: Rimuovere la protezione da un file

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

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

Questo comando rimuove la protezione da un singolo file denominato Analysis.docx.

Esempio 9: Rimuovere la protezione e un'etichetta da un file

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

Questo comando rimuove l'etichetta e la protezione personalizzata da un singolo file denominato Analysis.docx. Poiché i criteri sono configurati per richiedere la giustificazione per rimuovere un'etichetta, viene fornito anche il motivo della giustificazione in modo che il comando possa completare senza richiedere all'utente il motivo.

Parametri

-JustificationMessage

La motivazione per rimuovere un'etichetta o rimuovere la protezione se i criteri di etichettatura di riservatezza richiedono agli utenti di fornire queste informazioni. Se la rimozione di un'etichetta attiva la giustificazione e questo motivo non viene fornito, l'etichetta non viene rimossa. In questo caso, lo stato restituito è "Ignorato" con il commento "La giustificazione è obbligatoria".

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Path

Specifica un percorso locale, un percorso di rete o un URL di SharePoint Server ai file per i quali si desidera rimuovere le informazioni sull'etichetta e sulla protezione.

I caratteri jolly e i percorsi WebDav non sono supportati.

Per i percorsi di SharePoint, sono supportati i seguenti:

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

Ad esempio:

I percorsi possono includere spazi quando si racchiude il valore del percorso con virgolette.

Tipo:String[]
Alias:FullName, FileName
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-PreserveFileDetails

Specificare questo parametro per lasciare invariata la data modificata (Windows e SharePoint) e modificata dai valori (SharePoint) per i documenti etichettati:

  • Per i file di rete o locali, il valore Data modificato rimane invariato .

  • Per i file di SharePoint, la data modificata e modificata per valori rimangono invariati.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RemoveLabel

Rimuove qualsiasi etichetta applicata a un file.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RemoveProtection

Rimuove la protezione da un file. Se il file viene etichettato, l'etichetta non viene rimossa.

È necessario disporre di diritti di utilizzo sufficienti o essere un utente super utente per l'organizzazione per rimuovere la protezione dai file. Per altre informazioni, vedere Configurazione di utenti avanzati per Azure Rights Management e servizi di individuazione o ripristino dei dati.

Usare il cmdlet Remove-FileLabel PowerShell per abilitare la rimozione della protezione dai file contenitore (zip, .rar, .7z e pst).

Nota

  • Questa funzionalità di protezione rimossa è disabilitata per impostazione predefinita e deve prima essere abilitata usando il cmdlet Set-LabelPolicy .

  • Per i file pst, 5 GB è la dimensione massima del file supportata con questo cmdlet.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

System.String[]

Output

Microsoft.InformationProtection.Powershell.AIP.Results.SetAIPFileResult