Set-ArcConfig

此 cmdlet 仅在基于云的服务中可用。

使用 Set-ArcConfig cmdlet 修改在基于云的组织中配置的受信任的已验证接收链 (ARC) 密封程序的列表。

有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。

语法

Default (默认值)

Set-ArcConfig
    [-Identity] <HostedConnectionFilterPolicyIdParameter>
    -ArcTrustedSealers <String[]>
    [-Confirm]
    [-WhatIf]
    [<CommonParameters>]

说明

在传递前修改传输中的邮件内容的服务可能会使 DKIM 电子邮件签名失效并影响邮件的身份验证。 这些服务可以使用 ARC 提供修改发生前原始身份验证的详细信息。 然后,组织可以信任这些详细信息来帮助验证邮件。

您必须先获得权限,然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数,但如果分配给你的权限中未包含某些参数,则可能无权访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet。

示例

示例 1

Set-ArcConfig -Identity Default -ArcTrustedSealers fabrikam.com

此示例将“fabrikam.com”配置为组织中唯一受信任的 ARC 密封程序。

示例 2

$DomainsAdd = @(Get-ArcConfig | select -Expand ArcTrustedSealers)

$DomainsAdd += "cohovineyard.com","tailspintoys.com"

Set-ArcConfig -Identity Default -ArcTrustedSealers $DomainsAdd

此示例添加受信任的 ARC 密封程序“cohovineyard.com”和“tailspintoys.com”,而不会影响其他受信任的 ARC 密封程序条目。

示例 3

$x = @(Get-ArcConfig | select -Expand ArcTrustedSealers)

$y = $x.Split(",")

$DomainsRemove = [System.Collections.ArrayList]($y)

$DomainsRemove

$DomainsRemove.RemoveAt(6)

Set-ArcConfig -Identity Default -ArcTrustedSealers $DomainsRemove

此示例通过删除现有的 ARC 封口剂来修改受信任的 ARC 封口剂列表,而不会影响已指定的其他 ARC 封口剂。

前四个命令返回现有的 ARC 密封器列表。 列表中第一个 ARC 密封器的索引号为 0,第二个的索引号为 1,依此类推。 使用索引号指定要删除的 ARC 封口机。

最后两个命令删除列表中显示的第七个 ARC 密封器。

示例 4

$arcSealer = 'fabrikam.com'
$x = @(Get-ArcConfig | Select-Object -Expand ArcTrustedSealers)

$y = @($x.Split(","))
$DomainsRemove = [System.Collections.ArrayList]($y)
$DomainsRemove.Remove($arcSealer)

if ($DomainsToRemove.Count -eq 0) {
   Set-ArcConfig -Identity Default -ArcTrustedSealers " "
   }
else {
   Set-ArcConfig -Identity Default -ArcTrustedSealers $DomainsRemove
   }

此示例从 ($arcSealer) 列表中删除指定的 ARC 密封器。

如果从列表中删除此条目后不存在其他 ARC 密封程序,则使用 ArcTrustedSealers 参数的值 " " 可避免在值 $DomainsToRemove 为空时出现绑定参数错误。

参数

-ArcTrustedSealers

适用:Exchange Online,用于本地邮箱的内置安全加载项

ArcTrustedSealers 参数指定要添加的 ARC sealers 的域名。

域名必须与受影响的电子邮件 (例如 fabrikam.com) 的 ARC-Seal 和 ARC-Message-Signature 标头中的标记中d显示的域匹配。 可以使用 Outlook 查看这些标题。

若要用指定的值替换现有的 ARC 密封器列表,请使用语法 Domain1,Domain2,...DomainN。 若要保留现有值,请确保包含要保留的条目以及要添加的新值。

若要在不影响其他条目的情况下添加或删除值,请参阅本文的示例部分。

若要清空列表,请 (用双引号) 括起来的空格中的值 " " 。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Confirm

适用:Exchange Online,用于本地邮箱的内置安全加载项

Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 有何影响取决于 cmdlet 在继续操作前是否需要确认。

  • 破坏性 cmdlet(例如 Remove-* cmdlets)内置有暂停,可强制要求先确认命令,然后再继续操作。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:-Confirm:$false。
  • 其他大多数 cmdlet(例如 New-* 和 Set-* cmdlet)都没有内置暂停。 对于这些 cmdlet,在不带值的情况下指定“确认”开关会引入一个暂停,从而强制你在继续之前确认命令。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Identity

适用:Exchange Online,用于本地邮箱的内置安全加载项

Identity 参数指定要修改的受信任 ARC 密封器列表。 使用下列值之一:

  • 你自己组织的默认值。
  • <委派组织的 TenantID>\Default。 <TenantID> 值是一个 GUID,在 Microsoft 365 的许多管理门户 URL 中可见 (tid= 值) 。 例如,a32d39e2-3702-4ff5-9628-31358774c091。

参数属性

类型:HostedConnectionFilterPolicyIdParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:1
必需:True
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-WhatIf

适用:Exchange Online,用于本地邮箱的内置安全加载项

WhatIf 开关显示命令执行的操作,而无需进行任何更改。 不必为此开关指定值。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:WI

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持以下常用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。