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 onde as mensagens relatadas pelo usuário são entregues.
Observação: se a regra já existir (o cmdlet Get-ReportSubmissionRule retorna saída), você não poderá usar este cmdlet. Para excluir a regra existente e começar novamente, use primeiro o cmdlet Remove-ReportSubmissionRule.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
New-ReportSubmissionRule
[-Name] <String>
-ReportSubmissionPolicy <ReportSubmissionPolicyIdParameter>
[-Comments <String>]
[-Confirm]
[-Enabled <Boolean>]
[-SentTo <RecipientIdParameter[]>]
[-WhatIf]
[<CommonParameters>]
Description
Você poderá usar esse cmdlet somente se as seguintes instruções forem verdadeiras:
- A regra de envio de relatório não existe (o cmdlet Get-ReportSubmissionRule não retorna saída).
- A política de envio de relatório existe (o cmdlet Get-ReportSubmissionPolicy retorna 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ório usando ferramentas de relatório da Microsoft ou que não sejam da Microsoft no Outlook (os relatórios no Outlook estão ativados).
Quando você define o endereço de email da caixa de correio de relatório no portal do Microsoft 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ório da Microsoft no Outlook: ReportJunkAddresses, ReportNotJunkAddresses e ReportPhishAddresses (todos os três devem ter o mesmo valor).
- Relatórios integrados da Microsoft usando ferramentas de relatório que não são da Microsoft 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 artigo 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 -SentTo "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
Aplicável: Exchange Online
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.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Confirm
Aplicável: Exchange Online
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer confirmação antes de continuar.
- Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false. - A maioria dos outros cmdlets (por exemplo, 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 reconhecer o comando antes de continuar.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Enabled
Aplicável: Exchange Online
O parâmetro Enabled especifica se a regra está habilitada ou desabilitada. Os valores válidos são:
- $true: A regra está habilitada. Esse valor é o 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.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Name
Aplicável: Exchange Online
O parâmetro Nome especifica o nome da regra de envio de relatório. Quando a regra é criada automaticamente, o nome da regra é DefaultReportSubmissionRule. É recomendável usar esse valor para evitar confusão.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ReportSubmissionPolicy
Aplicável: Exchange Online
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.
Propriedades do parâmetro
| Tipo: | ReportSubmissionPolicyIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SentTo
Aplicável: Exchange Online
O parâmetro SentTo especifica o endereço de email da caixa de correio de relatório no Exchange Online para onde as mensagens relatadas pelo usuário são enviadas.
O valor desse parâmetro só será significativo se o relatório no Outlook estiver habilitado e as mensagens relatadas pelo usuário forem enviadas para uma caixa de correio de relatório, conforme configurado nos cmdlets *-ReportSubmissionPolicy (um dos seguintes cenários):
- O relatório integrado da Microsoft está habilitado usando as ferramentas de relatório da Microsoft no Outlook:
-EnableThirdPartyAddress $false -ReportJunkToCustomizedAddress $true -ReportNotJunkToCustomizedAddress $true -ReportPhishToCustomizedAddress $true. - Os relatórios integrados da Microsoft estão habilitados usando ferramentas de relatórios que não são da Microsoft 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 do Microsoft Defender, os seguintes parâmetros nos cmdlets *-ReportSubmissionPolicy serão definidos com o mesmo valor:
- Relatórios integrados da Microsoft usando ferramentas de relatório da Microsoft no Outlook: ReportJunkAddresses, ReportNotJunkAddresses e ReportPhishAddresses (todos os três devem ter o mesmo valor).
- Relatórios integrados da Microsoft usando ferramentas de relatório que não são da Microsoft 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 consistência e para evitar confusão.
Propriedades do parâmetro
| Tipo: | RecipientIdParameter[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Aplicável: Exchange Online
A opção WhatIf mostra o que o comando faz sem fazer nenhuma alteração. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.