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 |