New-DkimSigningConfig

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

Используйте командлет New-DkimSigningConfig, чтобы создавать параметры политики подписывания DKIM (DomainKeys Identified Mail) для доменов в облачной организации.

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

Синтаксис

New-DkimSigningConfig
   [-DomainName] <SmtpDomainWithSubdomains>
   [-Enabled] <Boolean>
   [-AdminDisplayName <String>]
   [-BodyCanonicalization <CanonicalizationType>]
   [-Confirm]
   [-HeaderCanonicalization <CanonicalizationType>]
   [-KeySize <UInt16>]
   [-WhatIf]
   [<CommonParameters>]

Описание

DKIM в Майкрософт 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

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

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

-BodyCanonicalization

Параметр BodyCanonicalization определяет алгоритм канонизации, используемый для создания и проверки части подписи DKIM с текстом сообщения. Это значение регулирует чувствительность DKIM к изменениям в тексте пересылаемых сообщений. Допустимые значения:

  • Расслабленный: допускаются изменения в пробелах и изменения в пустых строках в конце текста сообщения. Это значение используется по умолчанию.
  • Простой: допускаются только изменения в пустых строках в конце текста сообщения.
Type:CanonicalizationType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Confirm

Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.

  • Деструктивные командлеты (например, командлеты Remove-*) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
  • Большинство других командлетов (например, командлеты New-* и Set-*) не имеют встроенной приостановки. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-DomainName

Параметр DomainName определяет домен в вашей организации, для которого необходимо включить подписывание сообщений DKIM.

По умолчанию подписывание сообщений DKIM включено для исходного домена *.onmicrosoft.com в организации (например, contoso.onmicrosoft.com).

В сообщения из личных доменов, для которых не включено подписывание сообщений DKIM, добавляются подписи DKIM для домена *.onmicrosoft.com.

Type:SmtpDomainWithSubdomains
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Enabled

Параметр Enabled указывает, включена ли политика. Допустимые значения:

  • $true. Политика включена. Это значение используется по умолчанию.
  • $true. Политика включена. Это значение задается по умолчанию.
Type:Boolean
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-HeaderCanonicalization

Параметр HeaderCanonicalization определяет алгоритм канонизации, используемый для создания и проверки части подписи DKIM с заголовком сообщения. Это значение регулирует чувствительность DKIM к изменениям в заголовках пересылаемых сообщений. Допустимые значения:

  • Неактивные: допускаются распространенные изменения заголовка сообщения (например, перезапись строки поля заголовка, изменение ненужных пробелов или пустых строк, а также изменения в случае полей заголовка). Это значение используется по умолчанию.
  • Простой: изменения полей заголовка не допускаются.
Type:CanonicalizationType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-KeySize

Параметр KeySize задает размер (в битах) открытого ключа, используемого в политике подписывания DKIM. Допустимые значения: 1024 или 2048.

Поддерживаются ключи RSA; Ключи Ed25519 не поддерживаются.

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

-WhatIf

Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.

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