Udostępnij przez


Remove-FileLabel

Usuwa etykietę poufności dla pliku lub usuwa ochronę zgodnie z konfiguracją etykiety lub uprawnieniami niestandardowymi.

Składnia

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]

Opis

W przypadku klienta usługi Microsoft Purview Information Protection polecenie cmdlet Remove-FileLabel usuwa etykietę poufności dla co najmniej jednego pliku.

Przykłady

Przykład 1. Usuwanie etykiety z pliku

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

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

To polecenie usuwa istniejącą etykietę z pliku o nazwie C:\Projects\Analysis.docxi określa obowiązkowy komunikat uzasadnienia.

Ta metoda uzasadnienia jest wymagana, ponieważ odpowiednie ustawienie zasad etykiety poufności jest włączone, aby wymagać uzasadnienia usunięcia etykiety.

Uwaga / Notatka

Jeśli usuwana etykieta chroniła plik przy użyciu szablonu, to polecenie usuwa zarówno etykietę, jak i ochronę.

Jeśli usuwana etykieta chroniła plik przy użyciu uprawnień niestandardowych, to polecenie usuwa tylko etykietę.

Przykład 8. Usuwanie ochrony z pliku

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

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

To polecenie usuwa ochronę z jednego pliku o nazwie Analysis.docx.

Przykład 9. Usuwanie ochrony i etykiety z pliku

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

To polecenie usuwa etykietę i ochronę niestandardową z jednego pliku o nazwie Analysis.docx. Ponieważ zasady są skonfigurowane tak, aby wymagać uzasadnienia usunięcia etykiety, podano również przyczynę uzasadnienia, aby polecenie można było ukończyć bez monitowania użytkownika z tego powodu.

Parametry

-JustificationMessage

Uzasadnienie usunięcia etykiety lub usunięcia ochrony, jeśli zasady etykietowania poufności wymagają od użytkowników podania tych informacji. Jeśli usunięcie etykiety wyzwoli uzasadnienie i nie zostanie podany ten powód, etykieta nie zostanie usunięta. W takim przypadku zwrócony stan to "Pominięto" z komentarzem "Wymagane uzasadnienie".

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Path

Określa ścieżkę lokalną, ścieżkę sieciową lub adres URL programu SharePoint Server do plików, dla których chcesz usunąć etykietę i informacje o ochronie.

Symbole wieloznaczne nie są obsługiwane, a lokalizacje WebDav nie są obsługiwane.

W przypadku ścieżek programu SharePoint obsługiwane są następujące elementy:

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

Przykład:

  • C:\Folder\
  • C:\Folder\Nazwa pliku
  • \\Serwer\Folder
  • http://sharepoint.contoso.com/Shared%20Documents/Folder

Ścieżki mogą zawierać spacje po ujęciu wartości ścieżki cudzysłowami.

Właściwości parametrów

Typ:

String[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:Pełne imię, NazwaPliku

Zbiory parametrów

(All)
Pozycja:0
Obowiązkowy:True
Wartość z pipeline:True
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-PreserveFileDetails

Określ ten parametr, aby pozostawić datę modyfikacji (Windows i SharePoint) i zmodyfikować wartości przez (SharePoint) bez zmian dla dokumentów, które są oznaczone etykietą:

  • W przypadku plików lokalnych lub sieciowych wartość data modyfikacji pozostaje niezmieniona.

  • W przypadku plików programu SharePoint data modyfikacji i modyfikacja wartości pozostają niezmienione.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-RemoveLabel

Usuwa wszystkie etykiety, które zostały zastosowane do pliku.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

RemoveLabel
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
RemoveLabelProtection
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-RemoveProtection

Usuwa ochronę z pliku. Jeśli plik jest oznaczony etykietą, etykieta nie zostanie usunięta.

Aby usunąć ochronę plików, musisz mieć wystarczające prawa użytkowania lub być administratorem organizacji. Aby uzyskać więcej informacji, zobacz Konfigurowanie superu użytkowników usługi Azure Rights Management i usług odnajdywania lub odzyskiwania danych.

Użyj polecenia cmdlet Remove-FileLabel programu PowerShell, aby umożliwić usunięcie ochrony z plików kontenera (zip, .rar, .7z i pst).

Uwaga / Notatka

  • Ta funkcja usuwania ochrony jest domyślnie wyłączona i musi być włączona przy użyciu polecenia cmdlet Set-LabelPolicy .

  • W przypadku plików pst 5 GB jest maksymalnym rozmiarem pliku obsługiwanym za pomocą tego polecenia cmdlet.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

RemoveLabelProtection
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
RemoveProtection
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

Wejścia

System.String

Wyjść

Microsoft.InformationProtection.Powershell.AIP.Results.SetAIPFileResult