Set-MailboxJunkEmailConfiguration
Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e configurações podem ser exclusivos de um ambiente ou de outro.
Use o cmdlet Set-MailboxJunkEmailConfiguration para definir as configurações de lixo eletrônico nas caixas de correio.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
Set-MailboxJunkEmailConfiguration
[-Identity] <MailboxIdParameter>
[-BlockedSendersAndDomains <MultiValuedProperty>]
[-Confirm]
[-ContactsTrusted <Boolean>]
[-DomainController <Fqdn>]
[-Enabled <Boolean>]
[-FailOnError <Boolean>]
[-IgnoreDefaultScope]
[-SenderScreeningEnabled <Boolean>]
[-TrustedListsOnly <Boolean>]
[-TrustedRecipientsAndDomains <MultiValuedProperty>]
[-TrustedSendersAndDomains <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>]
Description
Este cmdlet controla as seguintes configurações de lixo eletrônico na caixa de correio:
Habilitar ou desabilitar a regra de lixo eletrônico: no Exchange local, a regra de lixo eletrônico (uma regra de caixa de entrada oculta chamada Regra de Lixo Eletrônico) controla a entrega de mensagens para a pasta Email Lixo Eletrônico ou para a Caixa de Entrada com base no limite da Pasta de Lixo Eletrônico Email SCL (para a organização ou a caixa de correio) e a coleção de lista segura na caixa de correio.
No serviço baseado em nuvem, a regra de lixo eletrônico não tem efeito sobre o fluxo de emails. As mensagens são entregues na pasta Lixo Eletrônico de Email com base nas ações definidas nas políticas anti-spam. A regra de lixo eletrônico na caixa de correio ainda controla o que acontece com as mensagens após a entrega com base na coleção de lista segura da caixa de correio.
Os usuários podem habilitar ou desabilitar a regra de lixo eletrônico em suas próprias caixas de correio usando o Outlook na Web.
Configure a coleção de listas seguras: A coleção de listas seguras é a lista de Remetentes Confiáveis, a lista de Destinatários Confiáveis e a lista de Remetentes Bloqueados. Os usuários podem configurar a coleção de listas seguras em suas próprias caixas de correio usando o Microsoft Outlook ou o Outlook na Web.
Para obter mais informações, consulte Definir configurações antispam do Exchange em caixas de correio.
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
Set-MailboxJunkEmailConfiguration "David Pelton" -Enabled $false
Este exemplo desabilita a regra de lixo eletrônico para o usuário chamado David Pelton. No Exchange local, as mensagens não são mais movidas entre a Caixa de Entrada e a pasta Email Lixo Eletrônico com base no limite da Pasta de Lixo Eletrônico Email SCL (organização ou caixa de correio) ou na coleção de lista segura da caixa de correio. No Exchange Online, a coleção da lista segura da caixa de correio não consegue mover mensagens entre a Caixa de Entrada e a pasta Lixo Email. As mensagens ainda são entregues na pasta Lixo Eletrônico de Email com base no veredicto e na ação correspondente das políticas anti-spam.
Exemplo 2
Set-MailboxJunkEmailConfiguration "Michele Martin" -TrustedSendersAndDomains @{Add="contoso.com","fabrikam.com"} -BlockedSendersAndDomains @{Add="jane@fourthcoffee.com"}
Este exemplo faz as seguintes alterações de configuração na coleção de lista segura para a usuária chamada Michele Martin:
- Adiciona contoso.com e fabrikam.com à lista de Remetentes Confiáveis sem afetar outras entradas existentes.
- Adiciona jane@fourthcoffee.com à lista de Remetentes bloqueados sem afetar outras entradas existentes.
Exemplo 3
Get-MailboxJunkEmailConfiguration * | Where {$_.ContactsTrusted -eq $true} | Set-MailboxJunkEmailConfiguration -ContactsTrusted $false
Este exemplo identifica caixas de correio onde os contatos são tratados como remetentes confiáveis e altera a configuração de lixo eletrônico para não tratar os contatos como remetentes confiáveis.
Parâmetros
-BlockedSendersAndDomains
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro BlockedSendersAndDomains especifica a lista de remetentes bloqueados, que é uma lista de endereços de email de remetente e domínios cujas mensagens são enviadas automaticamente para a pasta Lixo Email. Esse parâmetro corresponde à configuração do Outlook na Web: Mover emails desses remetentes ou domínios para minha pasta Lixo Email.
Para inserir vários valores e substituir as entradas existentes, use a seguinte sintaxe: Value1,Value2,...ValueN Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| 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 Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Complemento de segurança interna para segurança local caixas de correio
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 |
-ContactsTrusted
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro ContactsTrusted especifica se os contatos na pasta de Contatos serão tratados como remetentes confiáveis. Esse parâmetro corresponde à configuração do Outlook na Web: Confiar no email de meus contatos. Os valores válidos são:
- $true: As mensagens de contatos na pasta Contatos que chegam à caixa de correio nunca são entregues na pasta Email Lixo Eletrônico, independentemente do conteúdo.
- $false: Mensagens de contatos na pasta Contatos não são tratadas como remetentes confiáveis. O endereço de email é um remetente confiável apenas se estiver definido na lista de remetentes confiáveis. Esse valor é o padrão.
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 |
-DomainController
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.
Propriedades do parâmetro
| Tipo: | Fqdn |
| 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 |
-Enabled
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro Enabled habilita ou desabilita a regra de lixo eletrônico na caixa de correio (uma regra de caixa de entrada oculta denominada Regra de Lixo Eletrônico). Os valores válidos são:
$true: A regra de lixo eletrônico está habilitada na caixa de correio. Esse valor corresponde à configuração do Outlook na Web: Filtrar lixo eletrônico automaticamente. Esse valor é o padrão.
No Exchange local, o conjunto de listas seguras da caixa de correio (a lista de Remetentes Confiáveis, a lista de Destinatários Confiáveis e a lista de Remetentes Bloqueados) e o limite da pasta SCL Lixo Eletrônico de Email (para a organização ou a caixa de correio) entregam mensagens para a Caixa de Entrada ou para a pasta Lixo Eletrônico de Email.
No serviço baseado em nuvem, a coleção de lista segura da caixa de correio move as mensagens entregues entre a Caixa de Entrada ou a pasta Lixo Email. As mensagens são entregues na pasta Lixo Eletrônico de Email com base apenas no veredicto e na ação correspondente das políticas anti-spam.
$false: A regra de lixo eletrônico está desabilitada na caixa de correio. Esse valor corresponde à configuração Outlook na Web: Não mover emails para a pasta Email Lixo Eletrônico.
No Exchange local, a coleção de lista segura da caixa de correio ou o limite da pasta SCL Lixo Eletrônico de Email não consegue entregar mensagens para a caixa de entrada ou para a pasta Lixo Eletrônico de Email.
No serviço baseado em nuvem, a coleção de lista segura da caixa de correio não pode mover as mensagens entregues entre a Caixa de Entrada ou a pasta Lixo Email. As mensagens ainda são entregues na pasta Lixo Eletrônico de Email com base no veredicto e na ação correspondente das políticas anti-spam.
Você pode exibir o status da regra de lixo eletrônico executando um dos seguintes comandos para localizar o valor da propriedade Enabled:
Get-MailboxJunkEmailConfiguration -Identity <MailboxIdentity>- Somente Exchange local:
Get-InboxRule "Junk E-mail Rule" -Mailbox <MailboxIdentity> -IncludeHidden
O estado da regra de lixo eletrônico na caixa de correio não afeta as configurações de lixo eletrônico do lado do cliente que estão disponíveis no Filtro de Lixo Email do Outlook. Mesmo quando a regra de lixo eletrônico está desabilitada na caixa de correio, o Outlook ainda pode mover mensagens para a pasta Lixo Eletrônico de Email. Por exemplo, se o Outlook determinar que a mensagem é spam ou se o remetente estiver definido na lista de Remetentes Bloqueados, o Outlook poderá mover a mensagem para a pasta Lixo Eletrônico de Email. Para obter mais informações, consulte Visão geral do filtro de lixo eletrônico de Email.
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 |
-FailOnError
Aplicável: Exchange Online
Esse parâmetro só está disponível no serviço baseado em nuvem.
{{ Fill FailOnError Description }}
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 |
-Identity
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Complemento de segurança interna para segurança local caixas de correio
O parâmetro Identity especifica a caixa de correio que você deseja modificar. É possível usar qualquer valor que identifique a caixa de correio exclusivamente. Por exemplo:
- Nome
- Alias
- Nome diferenciado (DN)
- Nome diferenciado (DN)
- Domínio\Nome de usuário
- Endereço de email
- GUID
- LegacyExchangeDN
- SamAccountName
- ID de usuário ou nome UPN
Propriedades do parâmetro
| Tipo: | MailboxIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-IgnoreDefaultScope
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
A opção IgnoreDefaultScope informa ao comando para ignorar a configuração de escopo de destinatário padrão para a sessão do PowerShell do Exchange e usar toda a floresta como escopo. Não é preciso especificar um valor com essa opção.
Essa opção permite que o comando acesse objetos do Active Directory que não estão disponíveis no momento no escopo padrão, mas também introduz as seguintes restrições:
- Não é possível usar o parâmetro DomainController. O comando usa um servidor de catálogo global adequado automaticamente.
- Não é possível usar o parâmetro DomainController. O comando usa um servidor de catálogo global adequado automaticamente.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| 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 |
-SenderScreeningEnabled
Aplicável: Exchange Online
Esse parâmetro só está disponível no serviço baseado em nuvem.
{{ Preencher SenderScreeningEnabled Descrição }}
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 |
-TrustedListsOnly
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro TrustedListsOnly especifica que somente as mensagens de remetentes na lista de Remetentes Confiáveis são entregues na Caixa de Entrada. Todas as outras mensagens são tratadas como lixo eletrônico. Esse parâmetro corresponde à configuração do Outlook na Web: Não confie em emails, a menos que venham de alguém da minha lista de Remetentes e Destinatários Confiáveis. Os valores válidos são:
- $true: somente mensagens de endereços de email ou entradas de domínio na lista de Remetentes Confiáveis e na lista de Destinatários Confiáveis são entregues na Caixa de Entrada. Todas as outras mensagens são entregues automaticamente para a pasta Lixo Email.
- $false: Mensagens de outros remetentes, destinatários e domínios não são automaticamente tratadas como lixo eletrônico e são avaliadas individualmente. Esse valor é o padrão.
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 |
-TrustedRecipientsAndDomains
Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Esse parâmetro está reservado para uso interno da Microsoft.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| 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 |
-TrustedSendersAndDomains
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro TrustedSendersAndDomains especifica a lista de remetentes confiáveis e a lista de destinatários confiáveis, que são listas de endereços de email e domínios. As mensagens desses remetentes que chegam à caixa de correio nunca são entregues na pasta Lixo Eletrônico de Email, independentemente do conteúdo. Esse parâmetro corresponde à configuração Outlook na Web: Não mova emails desses remetentes ou domínios para minha pasta Email Lixo Eletrônico.
Para inserir vários valores e substituir as entradas existentes, use a seguinte sintaxe: Value1,Value2,...ValueN Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Para esvaziar a lista de endereços de email e domínios, use o valor $null.
Observações:
- Não é possível adicionar endereços de email de remetente do mesmo domínio que o endereço de email do destinatário. Todas as caixas de correio na lista de endereços global (GAL) são automaticamente consideradas como remetentes confiáveis.
- Você não pode modificar diretamente a lista de Destinatários Confiáveis usando este cmdlet. Use esse parâmetro para modificar a lista de remetentes confiáveis, e os endereços de email e os domínios são sincronizados com a lista de destinatários confiáveis.
- Em organizações híbridas do Exchange com sincronização de diretório, as entradas de domínio não são sincronizadas por padrão, mas você pode habilitar a sincronização de domínios. Para saber mais, veja Configurar a filtragem para usar os dados de domínio seguro de conteúdo.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| 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 Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Complemento de segurança interna para segurança local caixas de correio
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.
Entradas
Input types
Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.
Saídas
Output types
Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.