New-ReportSubmissionRule
此 cmdlet 仅在基于云的服务中可用。
使用 New-ReportSubmissionRule cmdlet 在基于云的组织中创建报表提交规则。 报告提交规则标识用户报告邮件的传递位置的报告邮箱。
注意:如果规则已存在 (Get-ReportSubmissionRule cmdlet 返回输出) ,则不能使用此 cmdlet。 若要删除现有规则并重新开始,请先使用 Remove-ReportSubmissionRule cmdlet。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
Default (默认值)
New-ReportSubmissionRule
[-Name] <String>
-ReportSubmissionPolicy <ReportSubmissionPolicyIdParameter>
[-Comments <String>]
[-Confirm]
[-Enabled <Boolean>]
[-SentTo <RecipientIdParameter[]>]
[-WhatIf]
[<CommonParameters>]
说明
仅当以下语句为 true 时,才能使用此 cmdlet:
- (Get-ReportSubmissionRule cmdlet 不返回任何输出) ,则不存在报告提交规则。
- 报告提交策略存在 (Get-ReportSubmissionPolicy cmdlet 返回输出) 。
SentTo 参数标识报告邮箱的电子邮件地址。 组织只需要报告提交规则才能使用 Outlook 中的Microsoft或非Microsoft报告工具将用户报告的邮件发送到报告邮箱, (Outlook 中的报告) 启用。
在 Microsoft Defender 门户中https://security.microsoft.com/securitysettings/userSubmission设置报告邮箱的电子邮件地址时,也会在 *-ReportSubmissionPolicy cmdlet 中设置相同的电子邮件地址:
- 在 Outlook 中使用Microsoft报告工具Microsoft集成报告:ReportJunkAddresses、ReportNotJunkAddresses 和 ReportPhishAddresses (这三个值) 必须相同。
- 在 Outlook 中使用非Microsoft报告工具Microsoft集成报告:ThirdPartyReportAddresses。
使用此 cmdlet 设置报告邮箱的电子邮件地址时,不会更新 *-ReportSubmissionPolicy cmdlet 中的相应参数。
您必须先获得权限,然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数,但如果某些参数未包含在分配给你的权限中,则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
New-ReportSubmissionRule -Name DefaultReportSubmissionRule -ReportSubmissionPolicy DefaultReportSubmissionPolicy -SentTo "userreportedmessages@contoso.onmicrosoft.com"
此示例创建报表提交规则。 报告邮箱为 userreportedmessages@contoso.onmicrosoft.com。
参数
-Comments
适用:Exchange Online
Comments 参数指定规则的信息注释,如规则的用途或其随时间变化的情况。 注释的长度不能超过 1024 个字符。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Confirm
适用:Exchange Online
Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。
- 破坏性 cmdlet(例如 Remove-* cmdlets)内置有暂停,可强制要求先确认命令,然后再继续操作。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:
-Confirm:$false。 - 其他大多数 cmdlet(例如 New-* 和 Set-* cmdlet)都没有内置暂停。 对于这些 cmdlet,指定不含值的 Confirm 开关会引入暂停,从而强制要求你先确认命令,然后再继续操作。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Enabled
适用:Exchange Online
Enabled 参数指定是启用或禁用规则。 有效值包含:
- $true:已启用规则。 此值为默认值。
- $false:禁用规则。
创建规则后,使用 Enable-ReportSubmissionRule 和 Disable-ReportSubmissionRule cmdlet 启用或禁用该规则。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Name
适用:Exchange Online
Name 参数指定报表提交规则的名称。 自动创建规则时,规则的名称为 DefaultReportSubmissionRule。 建议使用此值以避免混淆。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 0 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-ReportSubmissionPolicy
适用:Exchange Online
ReportSubmissionPolicy 参数指定与此规则关联的报表提交策略。 唯一可用的策略名为 DefaultReportSubmissionPolicy。
参数属性
| 类型: | ReportSubmissionPolicyIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-SentTo
适用:Exchange Online
SentTo 参数指定发送用户报告邮件Exchange Online中报告邮箱的电子邮件地址。
仅当启用了 Outlook 中的报告,并且用户报告的邮件会按照 *-ReportSubmissionPolicy cmdlet 中的配置将 (以下任一方案) 时,此参数的值才有意义:
- Microsoft使用 Outlook 中的Microsoft报告工具启用集成报告:
-EnableThirdPartyAddress $false -ReportJunkToCustomizedAddress $true -ReportNotJunkToCustomizedAddress $true -ReportPhishToCustomizedAddress $true。 - Microsoft使用 Outlook 中的非Microsoft报告工具启用集成报告:
-EnableReportToMicrosoft $false -EnableThirdPartyAddress $true -ReportJunkToCustomizedAddress $false -ReportNotJunkToCustomizedAddress $false -ReportPhishToCustomizedAddress $false。
如果在 Microsoft Defender 门户中设置报告邮箱的电子邮件地址,则 *-ReportSubmissionPolicy cmdlet 中的以下参数将设置为相同的值:
- 在 Outlook 中使用Microsoft报告工具Microsoft集成报告:ReportJunkAddresses、ReportNotJunkAddresses 和 ReportPhishAddresses (这三个值) 必须相同。
- 在 Outlook 中使用非Microsoft报告工具Microsoft集成报告:ThirdPartyReportAddresses。
使用此 cmdlet 设置报告邮箱的电子邮件地址时,不会更新 *-ReportSubmissionPolicy cmdlet 中的相关参数值,这不会影响报告邮箱的功能。 应更新 *-ReportSubmissionPolicy cmdlet 中的相关值,以确保一致性并避免混淆。
参数属性
| 类型: | RecipientIdParameter[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-WhatIf
适用:Exchange Online
WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。
参数属性
| 类型: | SwitchParameter |
| 默认值: | 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。