Set-AIPFileClassification

Синтаксис

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

-Force

-JustificationMessage

-Path

-PreserveFileDetails

-WhatIf

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

System.String[]

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

Microsoft.InformationProtection.Powershell.AIP.Results.SetAIPFileClassificationResult

Связанные ссылки

• Get-AIPFileStatus
• Set-AIPAuthentication
• Set-AIPFileLabel