New-ReportSubmissionRule

  • Ссылка
Модуль:
ExchangePowerShell
Применяется к:
Exchange Online

Этот командлет доступен только в облачной службе.

Используйте командлет New-ReportSubmissionRule, чтобы создать правило отправки отчетов в облачной организации. Правило отправки отчетов определяет почтовый ящик отчетов, куда доставляются сообщения, сообщаемые пользователем.

Примечание. Если правило уже существует (командлет Get-ReportSubmissionRule возвращает выходные данные), использовать этот командлет нельзя. Чтобы удалить существующее правило и начать заново, сначала используйте командлет Remove-ReportSubmissionRule.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

New-ReportSubmissionRule
   [-Name] <String>
   -ReportSubmissionPolicy <ReportSubmissionPolicyIdParameter>
   [-Comments <String>]
   [-Confirm]
   [-Enabled <Boolean>]
   [-SentTo <RecipientIdParameter[]>]
   [-WhatIf]
   [<CommonParameters>]

Описание

Этот командлет можно использовать только в том случае, если выполняются следующие инструкции:

  • Правило отправки отчетов не существует (командлет Get-ReportSubmissionRule не возвращает выходные данные).
  • Существует политика отправки отчетов (командлет Get-ReportSubmissionPolicy возвращает выходные данные).

Параметр SentTo определяет адрес электронной почты почтового ящика отчетов. В вашей организации требуется правило отправки отчетов только для отправки сообщений пользователей в почтовый ящик отчетов с помощью средств отчетности Майкрософт или сторонних разработчиков в Outlook (включено интегрированное взаимодействие с отчетами Майкрософт).

Если задать адрес электронной почты почтового ящика отчетов на портале Microsoft 365 Defender по адресу https://security.microsoft.com/securitysettings/userSubmission, тот же адрес электронной почты также задается в командлетах *-ReportSubmissionPolicy:

  • Отчеты, интегрированные корпорацией Майкрософт с помощью средств отчетов Майкрософт в Outlook: ReportJunkAddresses, ReportNotJunkAddresses и ReportPhishAddresses (все три должны иметь одно и то же значение).
  • Отчеты, интегрированные корпорацией Майкрософт с помощью сторонних средств создания отчетов в Outlook: ThirdPartyReportAddresses.

При использовании этого командлета для задания адреса электронной почты почтового ящика отчетов соответствующие параметры в командлетах *-ReportSubmissionPolicy не обновляются.

Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье 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

Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.

  • Деструктивные командлеты (например, командлеты Remove-*) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
  • Большинство других командлетов (например, командлеты New-* и Set-*) не имеют встроенной приостановки. Для этих командлетов указание переключателя 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 командлеты, чтобы включить или отключить правило.

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, куда отправляются сообщения, сообщаемые пользователем.

Значение этого параметра имеет смысл только в том случае, если включено интегрированное взаимодействие с отчетами Майкрософт и сообщения, сообщаемые пользователем, отправляются в почтовый ящик отчетов, как это настроено в командлетах *-ReportSubmissionPolicy (в любом из следующих сценариев):

  • Интегрированная отчеты Майкрософт включена с помощью средств создания отчетов Майкрософт в Outlook: -EnableThirdPartyAddress $false -ReportJunkToCustomizedAddress $true -ReportNotJunkToCustomizedAddress $true -ReportPhishToCustomizedAddress $true.
  • Интегрированная отчеты Майкрософт включена с помощью сторонних средств создания отчетов в Outlook: -EnableReportToMicrosoft $false -EnableThirdPartyAddress $true -ReportJunkToCustomizedAddress $false -ReportNotJunkToCustomizedAddress $false -ReportPhishToCustomizedAddress $false.

Если вы задали адрес электронной почты почтового ящика отчетов на портале Microsoft 365 Defender, следующие параметры в командлетах *-ReportSubmissionPolicy имеют то же значение:

  • Отчеты, интегрированные корпорацией Майкрософт с помощью средств отчетов Майкрософт в Outlook: ReportJunkAddresses, ReportNotJunkAddresses и ReportPhishAddresses (все три должны иметь одно и то же значение).
  • Отчеты, интегрированные корпорацией Майкрософт с помощью сторонних средств создания отчетов в Outlook: ThirdPartyReportAddresses.

При использовании этого командлета для задания адреса электронной почты почтового ящика отчетов значения связанных параметров в командлетах *-ReportSubmissionPolicy не обновляются, что не влияет на функциональность почтового ящика отчетов. Чтобы избежать путаницы, необходимо обновить связанные значения в командлетах *-ReportSubmissionPolicy.

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