Get-SafeAttachmentRule

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

使用 Get-SafeAttachmentRule cmdlet 查看基于云的组织中的安全附件规则。

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

语法

Default (默认值)

Get-SafeAttachmentRule
    [[-Identity] <RuleIdParameter>]
    [-State <RuleState>]
    [<CommonParameters>]

说明

安全附件是 Microsoft Defender 中的一项功能,适用于Office 365,可在特殊虚拟机监控程序环境中打开电子邮件附件以检测恶意活动。 有关详细信息,请参阅 Defender for Office 365 中的安全附件

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

示例

示例 1

Get-SafeAttachmentRule

此示例返回组织中所有安全附件规则的摘要列表。

示例 2

Get-SafeAttachmentRule -Identity "Research Department Attachment Rule" | Format-List

此示例返回有关名为“研究部门附件规则”的安全附件规则的详细信息。

参数

-Identity

适用:Exchange Online

Identity 参数指定要查看的安全附件规则。

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

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

警告:identity 参数的值$null或不存在的值将返回 所有 对象,就像在没有 Identity 参数的情况下运行 Get- 命令一样。 验证 Identity 参数的任何值列表是否准确且不包含不存在$null值。

参数属性

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

参数集

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

-State

适用:Exchange Online

State 参数按规则状态筛选结果。 有效值为 Enabled 和 Disabled。

参数属性

类型:RuleState
默认值: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