New-DkimSigningConfig
此 cmdlet 仅在基于云的服务中可用。
使用 New-DkimSigningConfig cmdlet 为基于云的组织中的域创建域密钥识别邮件 (DKIM) 签名策略设置。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
Default (默认值)
New-DkimSigningConfig
[-DomainName] <SmtpDomainWithSubdomains>
[-Enabled] <Boolean>
[-AdminDisplayName <String>]
[-BodyCanonicalization <CanonicalizationType>]
[-Confirm]
[-HeaderCanonicalization <CanonicalizationType>]
[-KeySize <UInt16>]
[-WhatIf]
[<CommonParameters>]
说明
Microsoft 365 中的 DKIM 是一种电子邮件身份验证方法,它使用 DNS 中的公钥基础结构 (PKI) 、邮件头和 CNAME 记录对邮件发件人进行身份验证,邮件发件人在 DKIM-Signature 标头字段中标记。 DKIM 通过验证 From 地址中的域与 DKIM-Signature 标头字段中的域是否匹配,来帮助防止伪造的发件人电子邮件地址(也称为欺骗)。
您必须先获得权限,然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数,但如果某些参数未包含在分配给你的权限中,则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
New-DkimSigningConfig -DomainName contoso.com -Enabled $true
本示例为 contoso.com 域启用 DKIM 邮件签名。
参数
-AdminDisplayName
适用:Exchange Online、Exchange Online Protection
AdminDisplayName 参数指定策略的说明。 如果值中有空格,请使用双引号 (") 将此值括起来。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-BodyCanonicalization
适用:Exchange Online、Exchange Online Protection
BodyCanonicalization 参数指定用于创建和验证 DKIM 签名的邮件正文部分的规范化算法。 此值有效地控制 DKIM 对传输过程中邮件正文更改的敏感性。 有效值包含:
- 宽松:可以容忍消息正文末尾的空格更改和空行的更改。 此值为默认值。
- 简单:仅允许消息正文末尾空行的更改。
参数属性
| 类型: | CanonicalizationType |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Confirm
适用:Exchange Online、Exchange Online Protection
Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。
- 破坏性 cmdlet(例如 Remove-* cmdlets)内置有暂停,可强制要求先确认命令,然后再继续操作。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:
-Confirm:$false。 - 其他大多数 cmdlet(例如 New-* 和 Set-* cmdlet)都没有内置暂停。 对于这些 cmdlet,指定不含值的 Confirm 开关会引入暂停,从而强制要求你先确认命令,然后再继续操作。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-DomainName
适用:Exchange Online、Exchange Online Protection
DomainName 参数指定组织中想要为其启用 DKIM 邮件签名的域。
默认情况下,为组织中的 *.onmicrosoft.com 初始域(例如,contoso.onmicrosoft.com)启用 DKIM 邮件签名。
对于不启用 DKIM 邮件签名的自定义域,将 *.onmicrosoft.com 域的 DKIM 签名添加到邮件中。
参数属性
| 类型: | SmtpDomainWithSubdomains |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Enabled
适用:Exchange Online、Exchange Online Protection
Enabled 参数指定是否已启用此策略。 有效值包含:
- $true:已启用策略。
- $true:启用此策略。此为默认值。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 2 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-HeaderCanonicalization
适用:Exchange Online、Exchange Online Protection
HeaderCanonicalization 参数指定用于创建和验证 DKIM 签名的邮件头部分的规范化算法。 此值有效地控制 DKIM 对传输过程中邮件头更改的敏感性。 有效值包含:
- 宽松:允许对邮件头的常见修改, (例如,标头字段行重新包装、不必要的空格或空行的更改,以及标头字段) 的更改。 此值为默认值。
- 简单:不允许对标头字段进行更改。
参数属性
| 类型: | CanonicalizationType |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-KeySize
适用:Exchange Online、Exchange Online Protection
KeySize 参数指定 DKIM 签名策略中使用的公钥的大小(位)。 有效值包含:
- 1024 (这是默认值)
- 2048
支持 RSA 密钥。 不支持 Ed25519 密钥。
参数属性
| 类型: | UInt16 |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-WhatIf
适用:Exchange Online、Exchange Online Protection
WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。