Remove-FileLabel

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

Синтаксис

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

Описание

Для клиента Защита информации Microsoft Purview командлет 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:\> Set-AIPFileLabel C:\Projects\Analysis.docx -RemoveProtection -RemoveLabel -JustificationMessage 'The previous label no longer applies'

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

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

Параметры

-JustificationMessage

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

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

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

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

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

Пример:

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

Type:String[]
Aliases:FullName, FileName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PreserveFileDetails

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

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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoveLabel

Удаляет все метки, примененные к файлу.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RemoveProtection

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

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

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

Примечание

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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

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

System.String[]

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

Microsoft.InformationProtection.Powershell.AIP.Results.SetAIPFileResult