Test-Message

此 cmdlet 仅在基于云的服务中运行。

使用 Test-Message cmdlet 模拟和报告邮件流规则 (传输规则) 和统一 DLP 规则对测试电子邮件的影响。 由于此 cmdlet 将电子邮件引入 DLP 评估管道,因此可以在测试邮件上执行阻止、中等操作。 相关通知也会发送给任何配置的收件人。

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

语法

TransportRules

Test-Message
    -Recipients <ProxyAddressCollection>
    -SendReportTo <RecipientIdParameter>
    -TransportRules
    [-Confirm]
    [-Force]
    [-MessageFileData <Byte[]>]
    [-Sender <SmtpAddress>]
    [-UnifiedDlpRules]
    [-WhatIf]
    [<CommonParameters>]

UnifiedDLPRules

Test-Message
    -Recipients <ProxyAddressCollection>
    -SendReportTo <RecipientIdParameter>
    -UnifiedDlpRules
    [-Confirm]
    [-Force]
    [-MessageFileData <Byte[]>]
    [-Sender <SmtpAddress>]
    [-WhatIf]
    [<CommonParameters>]

说明

需要使用 TransportRules 或 UnifiedDlpRules 开关运行此 cmdlet。

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

示例

示例 1

$data = [System.IO.File]::ReadAllBytes('C:\Data\test.eml')

Test-Message -MessageFileData $data -Sender megan@contoso.com -Recipients adele@contoso.com -SendReportTo admin@contoso.com -TransportRules -UnifiedDlpRules

此示例使用 C:\Data 中的test.eml消息文件来测试邮件流规则和统一 DLP 规则,以测试发件人 megan@contoso.com 到收件人 adele@contoso.com的邮件流规则。 结果报告将发送到 admin@contoso.com。

参数

-Confirm

适用:Exchange Server 2013、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

-Force

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

Force 开关指定是否取消显示警告或确认消息。 您可以在以编程方式运行任务时使用此开关,因为此时并不适合提示用户提供管理输入。 您无需使用此开关指定值。

参数属性

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

参数集

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

-MessageFileData

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

MessageFileData 参数指定要测试的.eml消息文件。

此参数的有效值要求您使用以下语法将文件读取到字节编码对象: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). 可以使用此命令作为参数值,也可以将输出写入变量 ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) ,并将该变量用作参数值 ($data) 。

参数属性

类型:

Byte[]

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

参数集

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

-Recipients

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

收件人参数指定要用于测试邮件的收件人电子邮件地址。

可以指定多个电子邮件地址,中间用逗号分隔。

参数属性

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

参数集

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

-Sender

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

Sender 参数指定要用于测试消息的发件人电子邮件地址。

参数属性

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

参数集

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

-SendReportTo

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

SendReportTo 参数指定命令结果的目标电子邮件地址。

参数属性

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

参数集

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

-TransportRules

适用:Exchange Server 2013、Exchange Online、本地邮箱的内置安全加载项

TransportRules 开关指定您要测试邮件流规则。 不必为此开关指定值。

参数属性

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

参数集

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

-UnifiedDlpRules

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

UnifiedDlpRules 开关指定要统一 DLP 规则。 不必为此开关指定值。

参数属性

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

参数集

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

-WhatIf

适用:Exchange Server 2013、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。