Set-OMEConfiguration
Этот командлет доступен только в облачной службе.
Используйте командлет Set-OMEConfiguration для настройки Шифрование сообщений Microsoft Purview.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Default (По умолчанию)
Set-OMEConfiguration
[-Identity] <OMEConfigurationIdParameter>
[-BackgroundColor <String>]
[-Confirm]
[-DisclaimerText <String>]
[-EmailText <String>]
[-ExternalMailExpiryInDays <Int32>]
[-Image <Byte[]>]
[-IntroductionText <String>]
[-OTPEnabled <Boolean>]
[-PortalText <String>]
[-PrivacyStatementUrl <String>]
[-ReadButtonText <String>]
[-SocialIdSignIn <Boolean>]
[-WhatIf]
[<CommonParameters>]
Описание
Для его запуска необходимо получить соответствующие разрешения. Хотя в этой статье перечислены все параметры командлета, у вас может не быть доступа к некоторым параметрам, если они не включены в назначенные вам разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
Set-OMEConfiguration -Identity "OME Configuration" -EmailText "Encrypted message enclosed." -PortalText "This portal is encrypted." -DisclaimerText "Encryption security disclaimer." -Image ([System.IO.File]::ReadAllBytes('C:\Temp\OME Logo.gif'))
В этом примере настраиваются значения, указанные для конфигурации OME по умолчанию с именем "OME Configuration".
Параметры
-BackgroundColor
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр BackgroundColor определяет цвет фона. Допустимые значения:
- Шестнадцатеричное значение кода цвета (#RRGGBB) в формате HTML, заключенное в кавычки. Например,
"#FFFFFF"белый. - Допустимое значение имени цвета. Например,
yellowесть #ffff00. Список допустимых названий цветов см. в справочнике по цветам фона. - $null (пусто). Это значение используется по умолчанию.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. То, как этот переключатель влияет на командлет, зависит от того, требует ли командлет подтверждения перед продолжением.
- Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание параметра Confirm без значения приводит к паузе, которая вынуждает вас подтвердить команду перед продолжением.
Этот командлет имеет встроенную паузу, поэтому используйте -Confirm:$false его, чтобы пропустить подтверждение.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DisclaimerText
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр DisclaimerText определяет текст заявления в электронном письме, содержащем зашифрованное сообщение. Максимальная длина — 1024 символа. Если значение содержит пробелы, его необходимо заключить в кавычки (").
Чтобы удалить имеющийся текст и использовать значение по умолчанию, укажите для этого параметра значение $null.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-EmailText
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр EmailText указывает текст по умолчанию, который сопровождает зашифрованные почтовые сообщения. Этот текст отображается над инструкциями по просмотру зашифрованных сообщений. Максимальная длина — 1024 символа. Если значение содержит пробелы, его необходимо заключить в кавычки (").
Чтобы удалить имеющийся текст и использовать значение по умолчанию, укажите для этого параметра значение $null.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ExternalMailExpiryInDays
Применимо: Exchange Online
Этот параметр доступен только при наличии подписки на расширенное шифрование сообщений Microsoft 365.
Параметр ExternalMailExpiryInDays указывает количество дней, в течение которых зашифрованное сообщение доступно внешним получателям на портале Microsoft 365. Допустимое значение является целым числом от 0 до 730. Значение 0 означает, что срок действия сообщений не истекает. Значение по умолчанию равно 0.
В конфигурации OME по умолчанию обновить значение этого параметра невозможно. Это значение можно изменить только в настраиваемой конфигурации.
В выходных данных командлета Get-OMEConfiguration значение этого параметра отображается в свойстве ExternalMailExpiryInterval.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Int32
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Identity
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр Identity указывает настройки OME, которые требуется изменить. В конфигурации OME по умолчанию свойство Identity имеет значение OME Configuration.
Свойства параметров
| Тип: | OMEConfigurationIdParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Image
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр "Изображение" определяет и отправляет изображение для отображения в сообщении электронной почты и в Центре администрирования Microsoft 365.
Допустимое значение этого параметра требует чтения файла в объект с байтовой кодировкой со следующим синтаксисом: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). Вы можете использовать эту команду в качестве значения параметра или вы можете записать выходные данные в переменную ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) и использовать переменную как значение параметра ($data).
- Поддерживаемые форматы файлов: PNG, JPG, BMP, TIFF
- Оптимальный размер файла эмблемы: менее 40 КБ
- Оптимальное разрешение файла эмблемы: 170x70 пикселей
Чтобы удалить имеющееся изображение и использовать изображение по умолчанию, укажите для этого параметра значение $null.
Свойства параметров
| Тип: | Byte[] |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IntroductionText
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр IntroductionText задает текст, отображаемый рядом с именем отправителя и адресом электронной почты. Если значение содержит пробелы, его необходимо заключить в кавычки (").
Чтобы удалить имеющийся текст и использовать значение по умолчанию, укажите для этого параметра значение $null.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-OTPEnabled
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр OTPEnabled определяет, могут ли получатели использовать одноразовый пароль для просмотра зашифрованных сообщений. Допустимые значения:
- $true. Получатели могут использовать одноразовый секретный код для просмотра зашифрованных сообщений. Это значение используется по умолчанию.
- $false. Получатели не могут использовать одноразовый секретный код для просмотра зашифрованных сообщений. Получатель должен войти в систему, используя рабочую или учебную учетную запись Microsoft 365.
Свойства параметров
| Тип: | Boolean |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PortalText
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр PortalText определяет текст, отображаемый в верхней части портала просмотра зашифрованного сообщения электронной почты. Максимальная длина — 128 символов. Если значение содержит пробелы, его необходимо заключить в кавычки (").
Чтобы удалить имеющийся текст и использовать значение по умолчанию, укажите для этого параметра значение $null.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PrivacyStatementUrl
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр PrivacyStatementUrl указывает ссылку на заявление о конфиденциальности в зашифрованном сообщении электронной почты.
Если этот параметр не используется, то ссылка "Заявление о конфиденциальности" ведет к заявлению о конфиденциальности Майкрософт по умолчанию.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ReadButtonText
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр ReadButtonText указывает текст, отображаемый на кнопке "Прочитать сообщение". Если значение содержит пробелы, его необходимо заключить в кавычки (").
Чтобы удалить имеющийся текст и использовать значение по умолчанию, укажите для этого параметра значение $null.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SocialIdSignIn
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр SocialIdSignIn указывает, разрешено ли пользователю просматривать зашифрованное сообщение в Центре администрирования Microsoft 365 с помощью собственного идентификатора социальной сети (учетной записи Google, Yahoo и Майкрософт). Допустимые значения:
- $true. Вход в социальную сеть разрешен. Это значение используется по умолчанию.
- $false. Вход в учетную запись в социальной сети запрещен. Может ли получатель использовать одноразовый секретный код или свою рабочую или учебную учетную запись Microsoft 365, регулируется параметром OTPEnabled.
Свойства параметров
| Тип: | Boolean |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | 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.
Входные данные
Input types
Чтобы просмотреть типы входных данных, которые принимает этот командлет, см. Типы входных и выходных данных командлета. Если поле "Типы входных данных" для командлета пусто, командлет не принимает входные данные.
Выходные данные
Output types
Чтобы просмотреть типы возвращаемых данных, также называемые типами вывода, которые принимает этот командлет, см. раздел Типы ввода и вывода командлета. Если поле "Типы выходных данных" пусто, командлет не возвращает данные.