Set-AIPFileClassification

  • Ссылка
Модуль:
AzureInformationProtection

Сканирует файл для автоматического назначения метки Azure Information Protection в соответствии с настроенными в политике условиями.

Синтаксис

Set-AIPFileClassification
   [-JustificationMessage <String>]
   [-Force]
   [-PreserveFileDetails]
   [-Path] <String[]>
   [<CommonParameters>]
Set-AIPFileClassification
   [-JustificationMessage <String>]
   [-Force]
   [-WhatIf]
   [-DiscoveryInfoTypes <String[]>]
   [-Path] <String[]>
   [<CommonParameters>]

Описание

Командлет Set-AIPFileClassification может автоматически применять метку для одного или нескольких файлов при настройке меток для автоматической классификации.

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

По умолчанию, если файл уже содержит метку, имеющаяся метка или защита не заменяется.

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

Дополнительные сведения см. в разделе" Автоматическое применение метки конфиденциальности к содержимому

Запуск командлета неинтерактивно

Этот командлет можно запустить неинтерактивно. Дополнительные сведения см. в руководстве администратора клиента унифицированных меток.

Примеры

Пример 1. Сканирование всех файлов в папке и ее подпапках и применение меток в соответствии с настроенными условиями для автоматической классификации

PS C:\> Set-AIPFileClassification -Path C:\Projects\ -PreserveFileDetails


FileName      : C:\Projects\Project1.docx
Status        : Success
Comment       :
MainLabelName : Confidential
MainLabelId   : 074e257c-1234-1234-1234-34a182080e71
SubLabelName  : Finance group
SubLabelId    : d9f23ae3-1234-1234-1234-f515f824c57b

FileName      : C:\Projects\Datasheet.pdf
Status        : Skipped
Comment       : No label to apply
MainLabelName : 
MainLabelId   : 
SubLabelName  : 
SubLabelId    : 

FileName      : C:\Projects\Analysis.xlsx
Status        : Skipped
Comment       : No label to apply
MainLabelName : 
MainLabelId   : 
SubLabelName  : 
SubLabelId    : 

FileName      : C:\Projects\Pricelist.xlsx
Status        : Skipped
Comment       : No label to apply
MainLabelName : 
MainLabelId   : 
SubLabelName  : 
SubLabelId    : 

FileName      : C:\Projects\Dashboard.xlsx
Status        : Success
Comment       : 
MainLabelName : Public
MainLabelId   : f018e9e7-0cfc-4c69-b27a-ac3cb7df43cc
SubLabelName  : 
SubLabelId    :

Эта команда сканирует все файлы в папке Projects и любой из ее вложенных папок, а также устанавливает метки в соответствии с настроенными условиями в политике автоматического добавления меток. В этом примере доступно пять файлов, два из которых помечены автоматически. Файл Datasheet.pdf не помечен, так как его содержимое не соответствует настроенным условиям автоматической классификации Analysis.xlsx уже было помечено вручную, и Pricelist.xlsx имеет более высокую метку. Так как команда выполняется без параметра -Force , существующие метки для Analysis.xlsx и Pricelist.xlsx не перезаписываются.

Кроме того, если метки настроены для применения защиты Rights Management, файлы, успешно помеченные с помощью этой команды, также будут защищены. В этом случае владельцем этих файлов (имеющим разрешение на полный доступ к Rights Management) является пользователь, выполнивший команду PowerShell.

Поскольку указан параметр PreserveFileDetails, дата изменения помеченных файлов остается неизменной.

Пример 2. Сканирование всех файлов в папке и ее подпапках, применение меток в соответствии с настроенными условиями для автоматической классификации, переопределение имеющихся меток

PS C:\> Set-AIPFileClassification -Path C:\Projects\ -Force -PreserveFileDetails


FileName      : C:\Projects\Project1.docx
Status        : Success
Comment       :
MainLabelName : Confidential
MainLabelId   : 074e257c-1234-1234-1234-34a182080e71
SubLabelName  : Finance group
SubLabelId    : d9f23ae3-1234-1234-1234-f515f824c57b

FileName      : C:\Projects\Datasheet.pdf
Status        : Skipped
Comment       : No label to apply
MainLabelName : 
MainLabelId   : 
SubLabelName  : 
SubLabelId    : 

FileName      : C:\Projects\Analysis.xlsx
Status        : Success
Comment       :
MainLabelName : Public
MainLabelId   : f018e9e7-0cfc-4c69-b27a-ac3cb7df43cc
SubLabelName  : 
SubLabelId    : 

FileName      : C:\Projects\Pricelist.xlsx
Status        : Success
Comment       :
MainLabelName : Public
MainLabelId   : f018e9e7-0cfc-4c69-b27a-ac3cb7df43cc
SubLabelName  : 
SubLabelId    : 

FileName      : C:\Projects\Dashboard.xlsx
Status        : Success
Comment       : 
MainLabelName : Public
MainLabelId   : f018e9e7-0cfc-4c69-b27a-ac3cb7df43cc
SubLabelName  : 
SubLabelId    :

Эта команда аналогична предыдущему примеру, что она также сканирует все файлы в папке Projects и любой из ее вложенных папок и устанавливает метки в соответствии с настроенными условиями автоматического добавления меток. Однако на этот раз, так как команда включает параметр -Force , она также заменяет существующую метку для Dashboard.xlsxи Pricelist.xlsx.

Содержимое Datasheet.pdf не соответствовало настроенным условиям, и этот файл остается без метки.

Пример 3. (Только клиент унифицированных меток) Сканирование файла в режиме WhatIf для всех известных типов конфиденциальной информации

PS C:\> Set-AIPFileClassification -Path C:\Projects\Project1.docx -WhatIf -DiscoveryInfoTypes All


MainLabelName           : General
MainLabelId             : 89a453df-5df4-4976-8191-jdn2fsf9560a
SubLabelName            :
SubLabelId              :
WhatIf                  : True
MatchedInformationTypes : {Credit Card Number, U.S. Social Security Number (SSN), International Classification of
                          Diseases (ICD-10-CM), International Classification of Diseases (ICD-9-CM)}
LastModifiedBy          :
LastModifiedTime        : 8/19/2014 5:11:26 AM
FileName                : C:\Projects\Project1.docx
Status                  : Success
Comment                 :

Эта команда обнаруживает все известные типы информации в файле Project1.docx без применения защиты или метки.

Пример 4. (Только клиент унифицированных меток) Сканирование файла в режиме WhatIf для определенных типов конфиденциальной информации

PS C:\> Set-AIPFileClassification -Path C:\Projects\Project1.docx -WhatIf -DiscoveryInfoTypes "50842eb7-edc8-4019-85dd-5a5c1f2bb085","a44669fe-0d48-453d-a9b1-2cc83f2cba77"

MainLabelName           : General
MainLabelId             : 89a453df-5df4-4976-8191-jdn2fsf9560a
SubLabelName            :
SubLabelId              :
WhatIf                  : True
MatchedInformationTypes : {Credit Card Number, U.S. Social Security Number (SSN)}
LastModifiedBy          :
LastModifiedTime        : 8/19/2014 5:11:26 AM
FileName                : Project1.docx
Status                  : Success
Comment                 :

Эта команда обнаруживает конкретные типы сведений "Номер кредитной карты" и "Номер социального страхования (SSN)" в файлеProject1.docx без применения защиты или метки.

Пример 5. (Только клиент унифицированных меток) Сканирование файла в режиме WhatIf для определенных типов конфиденциальной информации и отображение найденных значений

PS C:\> $x=Set-AIPFileClassification -Path "C:\Projects\Project1.docx" -WhatIf -DiscoveryInfoTypes "50842eb7-edc8-4019-85dd-5a5c1f2bb085","a44669fe-0d48-453d-a9b1-2cc83f2cba77"
PS C:\> $x.MatchedInformationTypes

RulePackageSetId  : 00000000-0000-0000-0000-000000000000
RulePackageId     : 00000000-0000-0000-0000-000000000000
RuleId            : 50842eb7-edc8-4019-85dd-5a5c1f2bb085
Name              : Credit Card Number
Count             : 1
UniqueCount       : 1
Confidence        : 85
SensitiveContents : {Offset: 2089, Length: 19}
 
RulePackageSetId  : 00000000-0000-0000-0000-000000000000
RulePackageId     : 00000000-0000-0000-0000-000000000000
RuleId            : a44669fe-0d48-453d-a9b1-2cc83f2cba77
Name              : U.S. Social Security Number (SSN)
Count             : 1
UniqueCount       : 1
Confidence        : 85
SensitiveContents : {Offset: 7063, Length: 11}


PS C:\> $x.MatchedInformationTypes[0].SensitiveContents | fl

Offset  : 2089
Length  : 19
Value   : 4539-9572-7949-2212
Context : OLOGICAL SCIENCES     Credit Card #
          Expiration Date:      4539-9572-7949-2212
          8/2009                Department:     BIOLOGICAL SCIENCES     Anticipa

Как и в предыдущем примере, первая команда обнаруживает конкретные типы сведений "Номер кредитной карты" и "Номер социального страхования (SSN)" в файлеProject1.docx без применения защиты или метки. Однако в этом примере результаты хранятся в переменной для дальнейшей обработки.

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

Последняя команда отображает и форматирует данные, определяемые первым типом конфиденциальной информации, который в этом примере представляет собой сведения о кредитной карте.

Параметры

-DiscoveryInfoTypes

Примечание. Этот параметр поддерживается только в клиенте унифицированных меток Azure Information Protection.

Укажите типы конфиденциальной информации для обнаружения при использовании параметра WhatIf .

Если вы хотите искать определенные типы конфиденциальной информации, укажите номер идентификатора сущности для этого типа информации, который можно найти в разделе "Типы конфиденциальной информации" в Exchange Server.

Например, "50842eb7-edc8-4019-85dd-5a5c1f2bb085" — это число, указываемое для типа конфиденциальной информации номера кредитной карты.

Type:String[]
Accepted values:All, "rule_id_1", "rule_id_2"
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Заменяет имеющуюся метку при выполнении настроенных условий.

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

-JustificationMessage

Обоснование причины понижения метки классификации, удаления метки или снятия защиты, если политика Azure Information Protection запрашивает пользователей предоставить эти сведения.

Если установка метки активирует обоснование и эта причина не указана, метка не применяется, даже если задан параметр -Force . В этом случае возвращается состояние "Пропущено" со следующим примечанием: "Метка не применяется"

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

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

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

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

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

-WhatIf

Релевантный для: Только клиент унифицированных меток

Показывает, что произойдет при выполнении командлета и эквивалентен режиму обнаружения для сканера. Изменения не будут применяться к входным или выходным файлам.

Используйте этот параметр с DiscoveryInfoTypes для поиска всех типов конфиденциальной информации или определенных типов конфиденциальной информации.

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

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

System.String[]

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

Microsoft.InformationProtection.Powershell.AIP.Results.SetAIPFileClassificationResult