New-ReportSubmissionRule
Esse cmdlet só está disponível no serviço baseado em nuvem.
Utilize o cmdlet New-ReportSubmissionRule para criar a regra de submissão de relatórios na sua organização com base na cloud. A regra de submissão do relatório identifica a caixa de correio de relatório onde as mensagens comunicadas pelo utilizador são entregues.
Nota: se a regra já existir (o cmdlet Get-ReportSubmissionRule devolve a saída), não poderá utilizar este cmdlet. Para eliminar a regra existente e recomeçar, utilize 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 (Padrão)
New-ReportSubmissionRule
[-Name] <String>
-ReportSubmissionPolicy <ReportSubmissionPolicyIdParameter>
[-Comments <String>]
[-Confirm]
[-Enabled <Boolean>]
[-SentTo <RecipientIdParameter[]>]
[-WhatIf]
[<CommonParameters>]
Description
Só pode utilizar este cmdlet se as seguintes instruções forem verdadeiras:
- A regra de submissão do relatório não existe (o cmdlet Get-ReportSubmissionRule não devolve nenhuma saída).
- A política de submissão de relatórios existe (o cmdlet Get-ReportSubmissionPolicy devolve a saída).
O parâmetro SentTo identifica o endereço de e-mail da caixa de correio de relatórios. A sua organização precisa de uma regra de submissão de relatórios apenas para enviar mensagens comunicadas pelo utilizador para a caixa de correio de relatórios através das ferramentas de relatórios da Microsoft ou não microsoft no Outlook (os relatórios no Outlook estão ativados).
Quando define o endereço de e-mail da caixa de correio de relatórios no portal do Microsoft Defender em https://security.microsoft.com/securitysettings/userSubmission, o mesmo endereço de e-mail também é definido nos cmdlets *-ReportSubmissionPolicy:
- Relatórios integrados da Microsoft com ferramentas de relatórios da Microsoft no Outlook: ReportJunkAddresses, ReportNotJunkAddresses e ReportPhishAddresses (os três têm de ser o mesmo valor).
- Relatórios integrados da Microsoft com ferramentas de relatórios não Microsoft no Outlook: ThirdPartyReportAddresses.
Quando utiliza este cmdlet para definir o endereço de e-mail da caixa de correio de relatórios, 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, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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 submissão do relatório. A caixa de correio de relatórios é 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. 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, 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 confirmar 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 Ativado especifica se a regra está ativada ou desativada. Os valores válidos são:
- $true: a regra está ativada. Este valor é a predefinição.
- $false: a regra está desativada.
Depois de criar a regra, utilize os cmdlets Enable-ReportSubmissionRule e Disable-ReportSubmissionRule para ativar ou desativar 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 submissão do relatório. Quando a regra é criada automaticamente, o nome da regra é DefaultReportSubmissionRule. Recomendamos que utilize este valor para evitar confusões.
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 submissão de relatórios associada a esta regra. A única política disponível chama-se 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 e-mail da caixa de correio de relatórios no Exchange Online para onde as mensagens comunicadas pelo utilizador são enviadas.
O valor deste parâmetro só é significativo se os relatórios no Outlook estiverem ativados e as mensagens comunicadas pelo utilizador forem enviadas para uma caixa de correio de relatórios, conforme configurado nos cmdlets *-ReportSubmissionPolicy (qualquer um dos seguintes cenários):
- Os relatórios integrados da Microsoft são ativados com as ferramentas de relatórios da Microsoft no Outlook:
-EnableThirdPartyAddress $false -ReportJunkToCustomizedAddress $true -ReportNotJunkToCustomizedAddress $true -ReportPhishToCustomizedAddress $true. - Os relatórios integrados da Microsoft são ativados com ferramentas de relatórios não microsoft no Outlook:
-EnableReportToMicrosoft $false -EnableThirdPartyAddress $true -ReportJunkToCustomizedAddress $false -ReportNotJunkToCustomizedAddress $false -ReportPhishToCustomizedAddress $false.
Se definir o endereço de e-mail da caixa de correio de relatórios no portal Microsoft Defender, os seguintes parâmetros nos cmdlets *-ReportSubmissionPolicy são definidos para o mesmo valor:
- Relatórios integrados da Microsoft com ferramentas de relatórios da Microsoft no Outlook: ReportJunkAddresses, ReportNotJunkAddresses e ReportPhishAddresses (os três têm de ser o mesmo valor).
- Relatórios integrados da Microsoft com ferramentas de relatórios não Microsoft no Outlook: ThirdPartyReportAddresses.
Quando utiliza este cmdlet para definir o endereço de e-mail da caixa de correio de relatórios, os valores dos parâmetros relacionados nos cmdlets *-ReportSubmissionPolicy não são atualizados, o que não afeta a funcionalidade da caixa de correio de relatórios. Deve atualizar os valores relacionados nos cmdlets *-ReportSubmissionPolicy para consistência e evitar confusões.
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 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.
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 suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.