New-OMEConfiguration

Ссылка

Модуль:: ExchangePowerShell

Применяется к:: Exchange Online

Этот командлет доступен только в облачной службе.

Используйте командлет New-OMEConfiguration для создания конфигурации Шифрование сообщений Microsoft Purview.

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

Синтаксис

New-OMEConfiguration
   [-Identity] <OrganizationIdParameter>
   [-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

New-OMEConfiguration -Identity "Contoso Marketing" -EmailText "Encrypted message enclosed." -PortalText "This portal is encrypted." -DisclaimerText "Encryption security disclaimer." -Image ([System.IO.File]::ReadAllBytes('C:\Temp\OME Logo.gif'))

В этом примере создается новая конфигурация OME с именем Contoso Marketing с указанными значениями. Неиспользуемые параметры получают значения по умолчанию.

Параметры

-BackgroundColor

Параметр BackgroundColor задает цвет фона. Допустимые значения:

Доступное шестнадцатеричное (шестнадцатеричное) значение цветового кода HTML (например, 0x000000 белый).
Доступное текстовое значение (например, yellow 0x00FFFF00).
$null (пусто). Это значение используется по умолчанию.

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-DisclaimerText

Параметр DisclaimerText определяет текст заявления в электронном письме, содержащем зашифрованное сообщение. Максимальная длина — 1024 символа. Если значение содержит пробелы, его необходимо заключить в кавычки (").

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-EmailText

Параметр EmailText указывает текст по умолчанию, который сопровождает зашифрованные почтовые сообщения. Этот текст отображается над инструкциями по просмотру зашифрованных сообщений. Максимальная длина — 1024 символа. Если значение содержит пробелы, его необходимо заключить в кавычки (").

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-ExternalMailExpiryInDays

Этот параметр доступен только в подписке Майкрософт 365 Advanced Message Encryption.

Параметр ExternalMailExpiryInDays указывает количество дней, в течение которых зашифрованное сообщение доступно внешним получателям на портале Майкрософт 365. Допустимым значением является целое число от 0 до 730. Значение 0 означает, что срок действия сообщений никогда не истечет. Значение по умолчанию равно 0.

В выходных данных командлета Get-OMEConfiguration значение этого параметра отображается в свойстве ExternalMailExpiryInterval.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-Identity

Параметр Identity задает уникальное имя объекта конфигурации OME. Максимальная длина: 64 символа. Если значение содержит пробелы, его необходимо заключить в кавычки (").

Type:	OrganizationIdParameter
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online

-Image

Параметр Image определяет и отправляет изображение, которое будет отображаться в сообщении электронной почты и в Центр администрирования Microsoft 365.

Допустимое значение для этого параметра требует считывания файла в байтовый объект с использованием следующего синтаксиса: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). Эту команду можно использовать в качестве значения параметра или записать выходные данные в переменную ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) и использовать переменную в качестве значения параметра ($data).

Поддерживаемые форматы файлов: PNG, JPG, BMP, TIFF
Оптимальный размер файла эмблемы: менее 40 КБ
Оптимальное разрешение файла эмблемы: 170x70 пикселей

Type:	Byte[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-IntroductionText

Параметр IntroductionText указывает текст по умолчанию, который сопровождает зашифрованные сообщения электронной почты. Текст по умолчанию отображается под адресом электронной почты получателя для просмотра зашифрованного сообщения. Если значение содержит пробелы, его необходимо заключить в кавычки (").

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-OTPEnabled

Параметр OTPEnabled определяет, могут ли получатели использовать одноразовый пароль для просмотра зашифрованных сообщений. Допустимые значения:

$true. Получатели могут использовать одноразовый секретный код для просмотра зашифрованных сообщений. Это значение используется по умолчанию.
$false. Получатели не могут использовать одноразовый секретный код для просмотра зашифрованных сообщений. Получатель должен войти с помощью рабочей или учебной учетной записи Майкрософт 365.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-PortalText

Параметр PortalText указывает текст, отображаемый в верхней части портала просмотра зашифрованных сообщений электронной почты. Максимальная длина — 128 символов. Если значение содержит пробелы, его необходимо заключить в кавычки (").

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-PrivacyStatementUrl

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-ReadButtonText

Параметр ReadButtonText указывает текст, отображаемый на кнопке "Прочитать сообщение". Если значение содержит пробелы, его необходимо заключить в кавычки (").

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-SocialIdSignIn

Параметр SocialIdSignIn указывает, разрешено ли пользователю просматривать зашифрованное сообщение в Центр администрирования Microsoft 365, используя собственный идентификатор социальной сети (Google, Yahoo и т. д.). Допустимые значения:

$true: вход с идентификатором социальной сети разрешен. Это значение используется по умолчанию.
$false: вход с идентификатором социальной сети запрещен. Может ли получатель использовать одноразовый секретный код или его Майкрософт 365 рабочей или учебной учетной записи, управляется параметром OTPEnabled.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-WhatIf