New-DkimSigningConfig
Этот командлет доступен только в облачной службе.
Используйте командлет New-DkimSigningConfig, чтобы создавать параметры политики подписывания DKIM (DomainKeys Identified Mail) для доменов в облачной организации.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Default (По умолчанию)
New-DkimSigningConfig
[-DomainName] <SmtpDomainWithSubdomains>
[-Enabled] <Boolean>
[-AdminDisplayName <String>]
[-BodyCanonicalization <CanonicalizationType>]
[-Confirm]
[-HeaderCanonicalization <CanonicalizationType>]
[-KeySize <UInt16>]
[-WhatIf]
[<CommonParameters>]
Описание
DKIM в Microsoft 365 — это метод проверки подлинности электронной почты, который использует инфраструктуру открытых ключей (PKI), заголовки сообщений и записи CNAME в DNS для проверки подлинности отправителя сообщения, который помечен в поле заголовка DKIM-Signature. DKIM помогает предотвратить получение сообщений от адресов электронной почты ненастоящих отправителей (так называемый спуфинг), проверяя соответствие доменов в адресе From и поле заголовка DKIM-Signature.
Для его запуска необходимо получить соответствующие разрешения. Хотя в этой статье перечислены все параметры командлета, у вас может не быть доступа к некоторым параметрам, если они не включены в назначенные вам разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
New-DkimSigningConfig -DomainName contoso.com -Enabled $true
В этом примере показано включение подписывания сообщений DKIM для домена contoso.com.
Параметры
-AdminDisplayName
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр AdminDisplayName указывает описание политики. Если значение содержит пробелы, его необходимо заключить в кавычки (").
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-BodyCanonicalization
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр BodyCanonicalization определяет алгоритм канонизации, используемый для создания и проверки части подписи DKIM с текстом сообщения. Это значение регулирует чувствительность DKIM к изменениям в тексте пересылаемых сообщений. Допустимые значения:
- Расслабленный: допускаются изменения в пробелах и изменения в пустых строках в конце текста сообщения. Это значение является значением по умолчанию.
- Простой: допускаются только изменения в пустых строках в конце текста сообщения.
Свойства параметров
| Тип: | CanonicalizationType |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.
- Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | Cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DomainName
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр DomainName определяет домен в вашей организации, для которого необходимо включить подписывание сообщений DKIM.
По умолчанию подписывание сообщений DKIM включено для исходного домена *.onmicrosoft.com в организации (например, contoso.onmicrosoft.com).
В сообщения из личных доменов, для которых не включено подписывание сообщений DKIM, добавляются подписи DKIM для домена *.onmicrosoft.com.
Свойства параметров
| Тип: | SmtpDomainWithSubdomains |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Enabled
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр Enabled указывает, включена ли политика. Допустимые значения:
- $true. Политика включена.
- $true. Политика включена. Это значение задается по умолчанию.
Свойства параметров
| Тип: | Boolean |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 2 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-HeaderCanonicalization
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр HeaderCanonicalization определяет алгоритм канонизации, используемый для создания и проверки части подписи DKIM с заголовком сообщения. Это значение регулирует чувствительность DKIM к изменениям в заголовках пересылаемых сообщений. Допустимые значения:
- Неуядаемый: допускаются распространенные изменения заголовка сообщения (например, перезапись строки поля заголовка, изменение ненужных пробелов или пустых строк, а также изменения в случае полей заголовка). Это значение является значением по умолчанию.
- Простой: изменения полей заголовка не допускаются.
Свойства параметров
| Тип: | CanonicalizationType |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-KeySize
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр KeySize задает размер (в битах) открытого ключа, используемого в политике подписывания DKIM. Допустимые значения:
- 1024 (это значение по умолчанию)
- 2048
Поддерживаются ключи RSA. Ключи Ed25519 не поддерживаются.
Свойства параметров
| Тип: | UInt16 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | 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.