Set-ArcConfig

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

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

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

语法

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、Exchange Online Protection

ArcTrustedSealers 参数指定要添加的 ARC 密封器的域名。

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

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

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

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

类型:String[]
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Confirm

适用:Exchange Online、Exchange Online Protection

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

  • 破坏性 cmdlet(例如 Remove-* cmdlets)内置有暂停,可强制要求先确认命令,然后再继续操作。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:-Confirm:$false
  • 其他大多数 cmdlet(例如 New-* 和 Set-* cmdlet)都没有内置暂停。 对于这些 cmdlet,指定不含值的 Confirm 开关会引入暂停,从而强制要求你先确认命令,然后再继续操作。
类型:SwitchParameter
别名:cf
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Identity

适用:Exchange Online、Exchange Online Protection

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

  • 你自己的组织的默认值。
  • <委托组织的 TenantID>\Default。 <TenantID> 值是一个 GUID,在 Microsoft 365 (tid= 值) 的许多管理门户 URL 中可见。 例如,a32d39e2-3702-4ff5-9628-31358774c091。
类型:HostedConnectionFilterPolicyIdParameter
Position:1
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-WhatIf

适用:Exchange Online、Exchange Online Protection

WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。

类型:SwitchParameter
别名:wi
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False