Set-SafeLinksRule

模块:

ExchangePowerShell

适用于:

Exchange Online

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

使用 Set-SafeLinksRule cmdlet 可以在您基于云的组织中创建安全链接规则。

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

语法

Set-SafeLinksRule
   [-Identity] <RuleIdParameter>
   [-Comments <String>]
   [-Confirm]
   [-ExceptIfRecipientDomainIs <Word[]>]
   [-ExceptIfSentTo <RecipientIdParameter[]>]
   [-ExceptIfSentToMemberOf <RecipientIdParameter[]>]
   [-Name <String>]
   [-Priority <Int32>]
   [-RecipientDomainIs <Word[]>]
   [-SafeLinksPolicy <SafeLinksPolicyIdParameter>]
   [-SentTo <RecipientIdParameter[]>]
   [-SentToMemberOf <RecipientIdParameter[]>]
   [-WhatIf]
   [<CommonParameters>]

说明

安全链接是Microsoft Defender for Office 365中的一项功能，用于检查电子邮件中的链接，以查看它们是否导致恶意网站。 在用户单击邮件中的链接后，系统会临时重写 URL，并对照已知的恶意网站列表来检查此 URL。 安全链接具有 URL 跟踪报告功能，有助于确定单击后到达恶意网站的人员。

重要

不同类型的收件人条件或不同类型的收件人例外不是累加的：他们是包容性的。 有关详细信息，请参阅 安全链接策略中的收件人筛选器。

您必须先获得权限，然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。

示例

示例 1

Set-SafeLinksRule -Identity "Engineering Department URL Rule" -ExceptIfRecipientDomainIs fabrikam.com

此示例修改名为“工程部 URL 规则”的现有安全链接规则，以排除发送到 fabrikam.com 域中收件人的邮件。

示例 2

Set-SafeLinksRule -Identity "Contoso All" -RecipientDomainIs (Get-AcceptedDomain).Name

此示例修改名为 Contoso All 的现有安全链接规则，以包括发送给组织中所有接受域中收件人的邮件。

示例 3

$Data = Import-Csv -Path "C:\Data\SafeLinksDomains.csv"

$SLDomains = $Data.Domains

Set-SafeLinksRule -Identity "Contoso All" -RecipientDomainIs $SLDomains

此示例类似于示例 2，但在此示例中，安全链接规则包括发送到.csv文件中指定的接受域中收件人的邮件。

参数

-Comments

Comments 参数指定规则的信息注释，如规则的用途或其随时间变化的情况。 注释的长度不能超过 1024 个字符。

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

-Confirm

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

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

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

-ExceptIfRecipientDomainIs

ExceptIfRecipientDomainIs 参数指定一个异常，用于查找具有指定域中电子邮件地址的收件人。 可以指定多个域，中间用逗号隔开。

Type:	Word[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-ExceptIfSentTo

ExceptIfSentTo 参数指定在邮件中查找收件人的异常。 可以使用任何能够唯一标识该收件人的值。 例如：

• 名称
• 别名
• 可分辨名称 (DN)
• 可分辨名称 (DN)
• 规范 DN
• GUID

Update 如果值包含空格或需要引号，请使用以下语法： "Value1","Value2",..."ValueN"。

Type:	RecipientIdParameter[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-ExceptIfSentToMemberOf

ExceptIfSentToMemberOf 参数指定一个异常，用于查找发送到通讯组成员、启用邮件的安全组或发送到Microsoft 365 组的邮件。 可以使用任何能够唯一标识该组的值。 例如：

• 名称
• 别名
• 可分辨名称 (DN)
• 可分辨名称 (DN)
• 规范 DN
• GUID

Update 如果值包含空格或需要引号，请使用以下语法： "Value1","Value2",..."ValueN"。

PD_UCC_Multiple_Values

Type:	RecipientIdParameter[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-Identity

Identity 参数指定要修改的安全链接规则。

可以使用唯一标识该规则的任何值。 例如：

• 名称
• 可分辨名称 (DN)
• GUID

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

-Name

Name 参数指定安全链接规则的唯一名称。 如果值中有空格，请使用双引号 (") 将此值括起来。

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

-Priority

Priority 参数为确定规则处理顺序的规则指定优先级值。 整数值越小，优先级越高，值 0 是最高优先级，规则不能具有相同的优先级值。

此参数的有效值和默认值取决于现有规则的数量。 例如，如果有 8 个现有规则：

• 此参数的有效值和默认值取决于现有规则的数量。例如，如果现有 8 个规则：
• 现有 8 个规则的有效优先级值为 0、1、2、3、4、5、6、7。
• 新规则（第 9 个规则）的有效优先级值范围是 0 至 8。

如果修改规则的优先级值，则规则在列表中的位置会发生变化，以匹配指定的优先级值。 换句话说，如果将规则的优先级值设置为与现有规则相同的值，则现有规则的优先级值和所有其他低优先级规则的优先级值在增加 1 后。

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

-RecipientDomainIs

RecipientDomainIs 参数指定一个条件，用于查找具有指定域中电子邮件地址的收件人。 可以指定多个域，中间用逗号隔开。

Type:	Word[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-SafeLinksPolicy

SafeLinksPolicy 参数指定与此安全链接规则关联的安全链接策略。 规则定义条件，策略定义操作。

可以使用任何能够唯一标识该策略的值。 例如：

• 名称
• 可分辨名称 (DN)
• GUID

不能指定已与其他安全附件规则关联的安全附件策略。

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

-SentTo

SentTo 参数指定在邮件中查找收件人的条件。 可以使用任何能够唯一标识该收件人的值。 例如：

• 名称
• 别名
• 可分辨名称 (DN)
• 可分辨名称 (DN)
• 规范 DN
• GUID

Update 如果值包含空格或需要引号，请使用以下语法： "Value1","Value2",..."ValueN"。

Type:	RecipientIdParameter[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-SentToMemberOf

SentToMemberOf 参数指定一个条件，用于查找发送到通讯组成员、启用邮件的安全组或发送到Microsoft 365 组的邮件。 可以使用任何能够唯一标识该组的值。 例如：

• 名称
• 别名
• 可分辨名称 (DN)
• 可分辨名称 (DN)
• 规范 DN
• GUID

Update 如果值包含空格或需要引号，请使用以下语法： "Value1","Value2",..."ValueN"。

PD_UCC_Multiple_Values

Type:	RecipientIdParameter[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-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