Set-SafeAttachmentRule
此 cmdlet 仅在基于云的服务中可用。
使用 Set-SafeAttachmentRule cmdlet 修改基于云的组织中的安全附件规则。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
Set-SafeAttachmentRule
[-Identity] <RuleIdParameter>
[-Comments <String>]
[-Confirm]
[-ExceptIfRecipientDomainIs <Word[]>]
[-ExceptIfSentTo <RecipientIdParameter[]>]
[-ExceptIfSentToMemberOf <RecipientIdParameter[]>]
[-Name <String>]
[-Priority <Int32>]
[-RecipientDomainIs <Word[]>]
[-SafeAttachmentPolicy <SafeAttachmentPolicyIdParameter>]
[-SentTo <RecipientIdParameter[]>]
[-SentToMemberOf <RecipientIdParameter[]>]
[-WhatIf]
[<CommonParameters>] 说明
安全附件是 Microsoft Defender for Office 365 中的一项功能，可在特殊的虚拟机监控程序环境中打开电子邮件附件以检测恶意活动。 有关详细信息，请参阅 Defender for Office 365 中的安全附件。
安全附件策略只能分配给一个安全附件规则。
重要
不同类型的收件人条件或不同类型的收件人例外不是累加的：他们是包容性的。 有关详细信息，请参阅 安全附件策略设置。
您必须先获得权限，然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Set-SafeAttachmentRule -Identity "Engineering Department Attachment Rule" -ExceptIfRecipientDomainIs fabrikam.com此示例修改名为“工程部门附件规则”的现有安全附件规则，以排除发送到 fabrikam.com 域的邮件。
参数
-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 |
-SafeAttachmentPolicy
SafeAttachmentPolicy 参数指定与此安全附件规则关联的安全附件策略。 规则定义条件，策略定义操作。
可以使用任何能够唯一标识该策略的值。 例如：
- 名称
- 可分辨名称 (DN)
- GUID
不能指定已与另一个安全附件规则关联的安全附件策略。
| Type: | SafeAttachmentPolicyIdParameter |
| 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 |