Set-DlpSensitiveInformationType

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

Используйте командлет Set-DlpSensitiveInformationType для изменения правил типа конфиденциальной информации, которые используют отпечатки пальцев документов.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

Default (По умолчанию)

Set-DlpSensitiveInformationType
    [-Identity] <SensitiveInformationTypeIdParameter>
    [-Confirm]
    [-Description <String>]
    [-FileData <Byte[]>]
    [-Fingerprints <MultiValuedProperty>]
    [-IsExact <Boolean>]
    [-Locale <CultureInfo>]
    [-Name <String>]
    [-Threshold <UInt32>]
    [-ThresholdConfig <PswsHashtable>]
    [-WhatIf]
    [<CommonParameters>]

Описание

Пакеты правил типа конфиденциальной информации используются защитой от потери данных (DLP) для обнаружения конфиденциального содержимого в сообщениях.

Для его запуска необходимо получить соответствующие разрешения. Хотя в этой статье перечислены все параметры командлета, у вас может не быть доступа к некоторым параметрам, если они не включены в назначенные вам разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 1

Set-DlpSensitiveInformationType "Contoso Confidential" -Locale fr -Name "Contoso Confidentiel" -Description "Ce message contient des informations confidentielles." -IsDefault

В этом примере добавляется французский перевод в существующее правило типа конфиденциальной информации "Contoso Confidential" и задается этот французский перевод по умолчанию.

Пример 2

Set-DlpSensitiveInformationType "Contoso Confidential" -Locale es -Name $null -Description $null

В этом примере удален существующий испанский перевод из правила типа конфиденциальной информации с именем "Contoso Confidential".

Пример 3

$Benefits_Template = [System.IO.File]::ReadAllBytes('C:\My Documents\Contoso Benefits Template.docx')

$Benefits_Fingerprint = New-DlpFingerprint -FileData $Benefits_Template -Description "Contoso Benefits Template"

$Contoso_Confidential = Get-DlpSensitiveInformationType "Contoso Confidential"

$Array = [System.Collections.ArrayList]($Contoso_Confidential.Fingerprints)

$Array.Add($Benefits_FingerPrint[0])

Set-DlpSensitiveInformationType $Contoso_Confidential.Identity -FingerPrints $Array

В этом примере изменяется существующее правило типа конфиденциальной информации "Contoso Confidential" путем добавления нового отпечатка документа для файла C:\My Documents\Contoso Benefits Template.docx но при этом не затрагиваются существующие отпечатки пальцев документов, которые уже определены.

Пример 4

$cc = Get-DlpSensitiveInformationType "Contoso Confidential"

$a = [System.Collections.ArrayList]($cc.Fingerprints)

$a

$a.RemoveAt(0)

Set-DlpSensitiveInformationType $cc.Identity -FingerPrints $a

В этом примере правило типа конфиденциальной информации с именем "Contoso Confidential" изменяется путем удаления существующего отпечатка документа, но не затрагивает другие отпечатки документов, которые уже определены.

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

Параметры

-Confirm

Применимо: безопасность & соответствие требованиям

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

  • Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
  • Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание параметра Confirm без значения приводит к паузе, которая вынуждает вас подтвердить команду перед продолжением.

Этот командлет имеет встроенную паузу, поэтому используйте -Confirm:$false его, чтобы пропустить подтверждение.

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

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

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

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

-Description

Применимо: безопасность & соответствие требованиям

Параметр Description задает описание для правила типа конфиденциальной информации. Параметр Description используется вместе с параметрами Locale и Name, чтобы указать описания для правила типа конфиденциальной информации на разных языках. Локализованные значения Description отображаются в свойстве AllLocalizedDescriptions правила типа конфиденциальной информации.

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

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

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

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

-FileData

Применимо: безопасность & соответствие требованиям

{{ Fill FileData Description }}

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

Тип:

Byte[]

Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-Fingerprints

Применимо: безопасность & соответствие требованиям

Параметр Fingerprints определяет файлы документов с байтовой кодировкой, которые используются в качестве отпечатков пальцев правилом типа конфиденциальной информации. Инструкции по импорту документов для использования в качестве шаблонов для отпечатков пальцев см. в разделе New-DlpFingerprint или в разделе "Примеры". Инструкции по добавлению и удалению отпечатков пальцев документа из существующего правила типа конфиденциальной информации см. в разделе «Примеры».

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

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-Identity

Применимо: безопасность & соответствие требованиям

Параметр Identity указывает правило типа конфиденциальной информации, которое вы хотите изменить. Вы можете использовать любое значение, которое однозначно идентифицирует правило типа конфиденциальной информации. Например:

  • Имя
  • LocalizedName
  • Значение GUID удостоверения

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

Тип:SensitiveInformationTypeIdParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-IsExact

Применимо: безопасность & соответствие требованиям

{{ fill IsExact Description }}

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

Тип:Boolean
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-Locale

Применимо: безопасность & соответствие требованиям

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

Допустимыми входными данными для этого параметра является поддерживаемое значение кода языка и региональных параметров из класса CultureInfo Microsoft платформа .NET Framework. Например, da-DK для датского языка или ja-JP для японского. Подробнее см. в разделе Класс CultureInfo.

Как правило, параметр Locale с параметрами Name и Description используется для добавления или удаления переведенных имен и описаний для правила типа конфиденциальной информации. Для указания существующего переведенного имени и описания в качестве значений по умолчанию можно также использовать параметр Locale с переключателем IsDefault. Перед удалением перевода по умолчанию необходимо установить другой перевод по умолчанию.

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

Тип:CultureInfo
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-Name

Применимо: безопасность & соответствие требованиям

Параметр Name задает имя для правила типа конфиденциальной информации. Длина сообщения не должна превышать 256 символов.

Параметр Name используется вместе с параметрами Locale и Description, чтобы указать имена для правила типа конфиденциальной информации на разных языках. Локализованные значения Name отображаются в свойстве AllLocalizedNames правила типа конфиденциальной информации.

Значение параметра "Имя" используется в подсказке политики, которая отображается для пользователей в Outlook в Интернете. Если переведенное значение параметра Name совпадает с языком клиента, подсказка политики отображается на языке пользователя. Если ни одно из переведенных значений параметра Name не соответствует языку клиента, в подсказке политики будет использоваться перевод, заданный параметром IsDefault.

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

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

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

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

-Threshold

Применимо: безопасность & соответствие требованиям

{{ Описание порога заполнения }}

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

Тип:UInt32
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-ThresholdConfig

Применимо: безопасность & соответствие требованиям

{{ Заполнение ThresholdConfig Описание }}

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

Тип:PswsHashtable
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-WhatIf

Применимо: безопасность & соответствие требованиям

Параметр WhatIf не поддерживается в PowerShell безопасности и соответствия требованиям.

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

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

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

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

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.