New-ReportSubmissionRule
此 cmdlet 仅在基于云的服务中可用。
使用 New-ReportSubmissionRule cmdlet 在基于云的组织中创建报表提交规则。 报告提交规则标识用户报告邮件的传递位置的报告邮箱。
注意:如果规则已存在 (Get-ReportSubmissionRule cmdlet 返回输出) ,则不能使用此 cmdlet。 若要删除现有规则并重新开始,请先使用 Remove-ReportSubmissionRule cmdlet。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
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 集成报告体验) 启用。
在 Microsoft 365 Defender 门户中https://security.microsoft.com/securitysettings/userSubmission设置报告邮箱的电子邮件地址时,也会在 *-ReportSubmissionPolicy cmdlet 中设置相同的电子邮件地址:
- 在 Outlook 中使用 Microsoft 报告工具的 Microsoft 集成报告:ReportJunkAddresses、ReportNotJunkAddresses 和 ReportPhishAddresses (这三个值) 必须相同。
- 在 Outlook 中使用第三方报告工具的 Microsoft 集成报告:ThirdPartyReportAddresses。
使用此 cmdlet 设置报告邮箱的电子邮件地址时,不会更新 *-ReportSubmissionPolicy cmdlet 中的相应参数。
您必须先获得权限,然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数,但如果这些参数并未包含在分配给您的权限中,那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
New-ReportSubmissionRule -Name DefaultReportSubmissionRule -ReportSubmissionPolicy DefaultReportSubmissionPolicy -SendTo "userreportedmessages@contoso.onmicrosoft.com"
此示例创建报表提交规则。 报告邮箱为 userreportedmessages@contoso.onmicrosoft.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 |
-Enabled
Enabled 参数指定是启用或禁用规则。 有效值包含:
- $true:已启用规则。 此值为默认值。
- $false:禁用规则。
创建规则后,使用 Enable-ReportSubmissionRule 和 Disable-ReportSubmissionRule cmdlet 启用或禁用该规则。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-Name
Name 参数指定报表提交规则的名称。 自动创建规则时,规则的名称为 DefaultReportSubmissionRule。 建议使用此值以避免混淆。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-ReportSubmissionPolicy
ReportSubmissionPolicy 参数指定与此规则关联的报表提交策略。 唯一可用的策略名为 DefaultReportSubmissionPolicy。
Type: | ReportSubmissionPolicyIdParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-SentTo
SentTo 参数指定发送用户报告邮件Exchange Online中报告邮箱的电子邮件地址。
仅当启用了 Microsoft 集成报告体验,并且用户报告的邮件被发送到 *-ReportSubmissionPolicy cmdlet 中配置的报告邮箱时,此参数的值才有意义, (以下任一方案) :
- 在 Outlook 中使用 Microsoft 报告工具启用 Microsoft 集成报告:
-EnableThirdPartyAddress $false -ReportJunkToCustomizedAddress $true -ReportNotJunkToCustomizedAddress $true -ReportPhishToCustomizedAddress $true
。 - 使用 Outlook 中的第三方报告工具启用 Microsoft 集成报告:
-EnableReportToMicrosoft $false -EnableThirdPartyAddress $true -ReportJunkToCustomizedAddress $false -ReportNotJunkToCustomizedAddress $false -ReportPhishToCustomizedAddress $false
。
如果在 Microsoft 365 Defender 门户中设置报告邮箱的电子邮件地址,则 *-ReportSubmissionPolicy cmdlet 中的以下参数将设置为相同的值:
- 在 Outlook 中使用 Microsoft 报告工具的 Microsoft 集成报告:ReportJunkAddresses、ReportNotJunkAddresses 和 ReportPhishAddresses (这三个值) 必须相同。
- 在 Outlook 中使用第三方报告工具的 Microsoft 集成报告:ThirdPartyReportAddresses。
使用此 cmdlet 设置报告邮箱的电子邮件地址时,不会更新 *-ReportSubmissionPolicy cmdlet 中的相关参数值,这不会影响报告邮箱的功能。 应更新 *-ReportSubmissionPolicy cmdlet 中的相关值,以确保一致性并避免混淆。
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 |