New-OMEConfiguration
Этот командлет доступен только в облачной службе.
Используйте командлет 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белый). - Доступное текстовое значение (например,
yellow0x00FFFF00). - $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
{{ Fill PrivacyStatementUrl Description }}
| 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
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по