New-OMEConfiguration
Этот командлет доступен только в облачной службе.
Используйте командлет New-OMEConfiguration для создания конфигурации Шифрование сообщений Microsoft Purview.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Default (По умолчанию)
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
Применимо: Exchange Online
Параметр BackgroundColor определяет цвет фона. Допустимые значения:
- Доступное шестнадцатеричное (шестнадцатеричное триплетное) значение цветового кода в HTML (например,
0x000000"белый"). - Доступное текстовое значение (например,
yellow0x00FFFF00). - $null (пусто). Это значение используется по умолчанию.
Дополнительные сведения см. в статье Добавление фирменной символики организации в зашифрованные сообщения.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Применимо: Exchange Online
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DisclaimerText
Применимо: Exchange Online
Параметр DisclaimerText определяет текст заявления в электронном письме, содержащем зашифрованное сообщение. Максимальная длина — 1024 символа. Если значение содержит пробелы, его необходимо заключить в кавычки (").
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-EmailText
Применимо: Exchange Online
Параметр EmailText указывает текст по умолчанию, который сопровождает зашифрованные почтовые сообщения. Этот текст отображается над инструкциями по просмотру зашифрованных сообщений. Максимальная длина — 1024 символа. Если значение содержит пробелы, его необходимо заключить в кавычки (").
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ExternalMailExpiryInDays
Применимо: Exchange Online
Этот параметр доступен только при наличии подписки на расширенное шифрование сообщений Microsoft 365.
Параметр ExternalMailExpiryInDays указывает количество дней, в течение которых зашифрованное сообщение доступно внешним получателям на портале Microsoft 365. Допустимое значение является целым числом от 0 до 730. Значение 0 означает, что срок действия сообщений не истекает. Значение по умолчанию равно 0.
В выходных данных командлета Get-OMEConfiguration значение этого параметра отображается в свойстве ExternalMailExpiryInterval.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Int32
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Identity
Применимо: Exchange Online
Параметр Identity определяет уникальное имя объекта конфигурации OME. Максимальная длина: 64 символа. Если значение содержит пробелы, его необходимо заключить в кавычки (").
Свойства параметров
| Тип: | OrganizationIdParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | 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 пикселей
Свойства параметров
| Тип: | Byte[] |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IntroductionText
Применимо: Exchange Online
Параметр IntroductionText задает текст по умолчанию, сопровождающий зашифрованные сообщения электронной почты. Для просмотра зашифрованного сообщения под адресом электронной почты получателя отображается текст по умолчанию. Если значение содержит пробелы, его необходимо заключить в кавычки (").
Свойства параметров
| Тип: | 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 символов. Если значение содержит пробелы, его необходимо заключить в кавычки (").
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PrivacyStatementUrl
Применимо: Exchange Online
{{ Заполнение PrivacyStatementUrl Description }}
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ReadButtonText
Применимо: Exchange Online
Параметр ReadButtonText указывает текст, отображаемый на кнопке "Прочитать сообщение". Если значение содержит пробелы, его необходимо заключить в кавычки (").
Свойства параметров
| Тип: | 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.