Compartilhar via


New-ReportSubmissionRule

Esse cmdlet só está disponível no serviço baseado em nuvem.

Use o cmdlet New-ReportSubmissionRule para criar a regra de envio de relatório em sua organização baseada em nuvem. A regra de envio de relatório identifica a caixa de correio de relatório em que as mensagens relatadas pelo usuário são entregues.

Observação: se a regra já existir (o cmdlet Get-ReportSubmissionRule retornará a saída), você não poderá usar esse cmdlet. Para excluir a regra existente e recomeçar, use o cmdlet Remove-ReportSubmissionRule primeiro.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

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

Description

Você só poderá usar esse cmdlet se as seguintes instruções forem verdadeiras:

  • A regra de envio de relatório não existe (o cmdlet Get-ReportSubmissionRule não retorna nenhuma saída).
  • A política de envio de relatório existe (o cmdlet Get-ReportSubmissionPolicy retorna a saída).

O parâmetro SentTo identifica o endereço de email da caixa de correio de relatório. Sua organização precisa de uma regra de envio de relatório apenas para enviar mensagens relatadas pelo usuário para a caixa de correio de relatórios usando ferramentas de relatórios da Microsoft ou de terceiros no Outlook (a experiência de relatório integrada da Microsoft está ativada).

Quando você define o endereço de email da caixa de correio de relatório no portal Microsoft 365 Defender em https://security.microsoft.com/securitysettings/userSubmission, o mesmo endereço de email também é definido nos cmdlets *-ReportSubmissionPolicy:

  • Relatórios integrados da Microsoft usando ferramentas de relatórios da Microsoft no Outlook: ReportJunkAddresses, ReportNotJunkAddresses e ReportPhishAddresses (todos os três devem ser o mesmo valor).
  • Relatórios integrados da Microsoft usando ferramentas de relatórios de terceiros no Outlook: ThirdPartyReportAddresses.

Quando você usa esse cmdlet para definir o endereço de email da caixa de correio de relatório, os parâmetros correspondentes nos cmdlets *-ReportSubmissionPolicy não são atualizados.

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Exemplos

Exemplo 1

New-ReportSubmissionRule -Name DefaultReportSubmissionRule -ReportSubmissionPolicy DefaultReportSubmissionPolicy -SendTo "userreportedmessages@contoso.onmicrosoft.com"

Este exemplo cria a regra de envio de relatório. A caixa de correio de relatório é userreportedmessages@contoso.onmicrosoft.com.

Parâmetros

-Comments

O parâmetro Comments especifica comentários informativos para a regra, como a finalidade de uso da regra ou as respectivas mudanças ao longo do tempo. O tamanho do comentário não pode exceder 1024 caracteres.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Confirm

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

  • Cmdlets destrutivos (por exemplo, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, cmdlets New-* e Set-*) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Enabled

O parâmetro Habilitado especifica se a regra está habilitada ou desabilitada. Os valores válidos são:

  • $true: a regra está habilitada. Esse é o valor padrão.
  • $false: a regra está desabilitada.

Depois de criar a regra, use os cmdlets Enable-ReportSubmissionRule e Disable-ReportSubmissionRule para habilitar ou desabilitar a regra.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Name

O parâmetro Nome especifica o nome da regra de envio de relatório. Quando a regra é criada automaticamente, o nome da regra é DefaultReportSubmissionRule. Recomendamos usar esse valor para evitar confusão.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ReportSubmissionPolicy

O parâmetro ReportSubmissionPolicy especifica a política de envio de relatório associada a essa regra. A única política disponível é chamada DefaultReportSubmissionPolicy.

Type:ReportSubmissionPolicyIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-SentTo

O parâmetro SentTo especifica o endereço de email da caixa de correio de relatório em Exchange Online para onde as mensagens relatadas pelo usuário são enviadas.

O valor desse parâmetro só será significativo se a experiência de relatório integrada da Microsoft estiver habilitada e as mensagens relatadas pelo usuário forem enviadas para uma caixa de correio de relatório, conforme configurado nos cmdlets *-ReportSubmissionPolicy (qualquer um dos seguintes cenários):

  • O relatório integrado da Microsoft está habilitado usando ferramentas de relatório da Microsoft no Outlook: -EnableThirdPartyAddress $false -ReportJunkToCustomizedAddress $true -ReportNotJunkToCustomizedAddress $true -ReportPhishToCustomizedAddress $true.
  • O relatório integrado da Microsoft está habilitado usando ferramentas de relatório de terceiros no Outlook: -EnableReportToMicrosoft $false -EnableThirdPartyAddress $true -ReportJunkToCustomizedAddress $false -ReportNotJunkToCustomizedAddress $false -ReportPhishToCustomizedAddress $false.

Se você definir o endereço de email da caixa de correio de relatório no portal Microsoft 365 Defender, os seguintes parâmetros nos cmdlets *-ReportSubmissionPolicy serão definidos como o mesmo valor:

  • Relatórios integrados da Microsoft usando ferramentas de relatórios da Microsoft no Outlook: ReportJunkAddresses, ReportNotJunkAddresses e ReportPhishAddresses (todos os três devem ser o mesmo valor).
  • Relatórios integrados da Microsoft usando ferramentas de relatórios de terceiros no Outlook: ThirdPartyReportAddresses.

Quando você usa esse cmdlet para definir o endereço de email da caixa de correio de relatório, os valores de parâmetro relacionados nos cmdlets *-ReportSubmissionPolicy não são atualizados, o que não afeta a funcionalidade da caixa de correio de relatório. Você deve atualizar os valores relacionados nos cmdlets *-ReportSubmissionPolicy para obter consistência e evitar confusão.

Type:RecipientIdParameter[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-WhatIf

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online