Remove-FileLabel

Удаляет метку конфиденциальности для файла или удаляет защиту в соответствии с конфигурацией меток или пользовательскими разрешениями.

Синтаксис

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]

Описание

Для клиента Microsoft Purview Information Protection командлет Remove-FileLabel удаляет метку конфиденциальности для одного или нескольких файлов.

Примеры

Пример 1. Удаление метки из файла

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

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

Эта команда удаляет существующую метку из файла с именемC:\Projects\Analysis.docxи указывает обязательное сообщение об оправдании.

Этот метод обоснования является обязательным, так как соответствующий параметр политики меток конфиденциальности включен, чтобы требовать обоснование удаления метки.

Замечание

Если метка, которую вы удалили, защищена файлом с помощью шаблона, эта команда удаляет как метку, так и защиту.

Если метка, которую вы удалили, защитила файл с помощью пользовательских разрешений, эта команда удаляет только метку.

Пример 8. Удаление защиты из файла

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

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

Эта команда удаляет защиту из одного файла с именемAnalysis.docx.

Пример 9. Удаление защиты и метки из файла

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

Эта команда удаляет метку и пользовательскую защиту из одного файла с именем Analysis.docx. Так как политика настроена для удаления метки, причина обоснования также предоставляется таким образом, чтобы команда была завершена без запроса пользователя по причине.

Параметры

-JustificationMessage

Причина для удаления метки или удаления защиты, если политика метки конфиденциальности требует от пользователей предоставить эти сведения. Если удаление метки активирует обоснование, и эта причина не указана, метка не удаляется. В этом случае возвращено состояние "Пропущено" с комментарием "Обязательное обоснование".

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Path

Указывает локальный путь, сетевой путь или URL-адрес SharePoint Server для файлов, для которых требуется удалить метку и сведения о защите.

Подстановочные знаки не поддерживаются, а расположения WebDav не поддерживаются.

Для путей SharePoint поддерживаются следующие:

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

Рассмотрим пример.

  • C:\Папка\
  • C:\Папка\Имя файла
  • \\Сервер\Папка
  • http://sharepoint.contoso.com/Shared%20Documents/Folder

Пути могут включать пробелы при закрытии значения пути с кавычками.

Свойства параметров

Тип:

String[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:Полное имя, Имя файла

Наборы параметров

(All)
Position:0
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-PreserveFileDetails

Укажите этот параметр, чтобы оставить измененную дату (Windows и SharePoint) и изменить значения (SharePoint) без изменений для документов, которые вы метки:

  • Для локальных или сетевых файлов значение даты изменения остается неизменным.

  • Для файлов SharePoint дата изменения и измененные значения остаются неизменными.

Свойства параметров

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RemoveLabel

Удаляет любую метку, примененную к файлу.

Свойства параметров

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

RemoveLabel
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
RemoveLabelProtection
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RemoveProtection

Удаляет защиту из файла. Если файл помечен, метка не удаляется.

Вы должны иметь достаточные права на использование или быть суперпользоваем для организации, чтобы удалить защиту из файлов. Дополнительные сведения см. в статье о настройке суперпользователей для служб Azure Rights Management и служб обнаружения или восстановления данных.

Используйте командлет Remove-FileLabel PowerShell , чтобы включить удаление защиты из файлов контейнеров (zip, .rar, .7z и PST).

Замечание

  • Эта возможность удаления отключена по умолчанию и должна быть включена с помощью командлета Set-LabelPolicy .

  • Для PST-файлов 5 ГБ — максимальный размер файла, поддерживаемый этим командлетом.

Свойства параметров

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

RemoveLabelProtection
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
RemoveProtection
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

Входные данные

System.String

Выходные данные

Microsoft.InformationProtection.Powershell.AIP.Results.SetAIPFileResult