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 ou outro ambiente.

Use o cmdlet Set-MailboxJunkEmailConfiguration para definir as configurações de lixo eletrônico nas caixas de correio.

Você só pode usar esse cmdlet em uma caixa de correio aberta no Outlook (no modo cache do Exchange) ou no Outlook na Web. Se a caixa de correio não tiver sido aberta, você receberá o erro: a configuração de lixo eletrônico não pôde ser definida. O usuário precisa entrar no Outlook Web App antes de poder modificar suas listas de remetentes e destinatários confiáveis ou remetentes bloqueados. Se você quiser suprimir esse erro para operações em massa, você pode adicionar-ErrorAction SilentlyContinue ao final do comando.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax (https://docs.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).

Syntax

Set-MailboxJunkEmailConfiguration
   [-Identity] <MailboxIdParameter>
   [-BlockedSendersAndDomains <MultiValuedProperty>]
   [-Confirm]
   [-ContactsTrusted <Boolean>]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-IgnoreDefaultScope]
   [-TrustedListsOnly <Boolean>]
   [-TrustedRecipientsAndDomains <MultiValuedProperty>]
   [-TrustedSendersAndDomains <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]

Description

Este cmdlet controla as seguintes configurações de lixo eletrônico da caixa de correio:

  • Habilitar ou desabilitar a regra de lixo eletrônico: 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 lixo eletrônico ou a caixa de entrada com base no limite da pasta de lixo eletrônico de SCL (para a organização ou a caixa de correio) e a coleção SafeList na 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.

  • Configurar o conjunto de listas seguras: o conjunto 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 Configurar configurações antispam do Exchange em caixas de correio.

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.

Examples

Exemplo 1

Set-MailboxJunkEmailConfiguration "David Pelton" -Enabled $false

Este exemplo desabilita a configuração da regra de lixo eletrônico do usuário David Pelton.

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 o usuário chamado Michele Martins:

  • 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 em que os contatos são tratados como remetentes confiáveis e, em seguida, altera a configuração de lixo eletrônico para não tratar contatos como remetentes confiáveis.

Parameters

-BlockedSendersAndDomains

O parâmetro BlockedSendersAndDomains especifica a lista de remetentes bloqueados, que é uma lista de endereços de email e domínios de remetente cujas mensagens são enviadas automaticamente para a pasta lixo eletrônico. Este parâmetro corresponde à configuração Outlook na Web: mover emails destes remetentes ou domínios para a pasta lixo eletrônico.

Para inserir vários valores e substituir quaisquer entradas existentes, use a seguinte sintaxe: <value1> , <value2> ,... <valueN> . Se os valores contiverem espaços ou exigirem aspas, você precisará usar a seguinte sintaxe: " <value1> ", " <value2> ",... " <valueN> ".

Para adicionar ou remover um ou mais valores sem afetar as entradas existentes, use a seguinte sintaxe: @ {Add = " <value1> ", " <value2> "...; Remove = " <value1> ", " <value2> "...}.

Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, 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, Remover-* cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para esses cmdlets, você pode ignorar a solicitação 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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-ContactsTrusted

O parâmetro ContactsTrusted especifica se os contatos na pasta de Contatos serão tratados como remetentes confiáveis. Este parâmetro corresponde à configuração Outlook na Web: confiar em 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 à pasta lixo eletrônico, independentemente do conteúdo.

  • $false: as mensagens de contatos na pasta contatos não são tratadas como remetentes confiáveis. O endereço de email é um remetente confiável somente se ele estiver definido na lista de remetentes confiáveis. Esse é o valor padrão.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-DomainController

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.

Type:Fqdn
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Habilitado

O parâmetro Enabled habilita ou desabilita a regra de lixo eletrônico da caixa de correio (uma regra de caixa de entrada oculta chamada 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 Outlook na Web: filtrar automaticamente o lixo eletrônico. Esse é o valor padrão. O Exchange usa 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 lixo eletrônico de SCL (para a organização ou caixa de correio) para entregar mensagens à caixa de entrada ou à pasta lixo eletrônico.

  • $false: a regra de lixo eletrônico está desabilitada na caixa de correio. Esse valor corresponde à configuração Outlook na Web: não mover email para minha pasta lixo eletrônico. O Exchange não usa a coleção SafeList da caixa de correio ou o limite da pasta lixo eletrônico de SCL para entregar mensagens à caixa de entrada ou à pasta lixo eletrônico.

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 "regra de lixo eletrônico"-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 eletrônico do Outlook. Mesmo quando a regra de lixo eletrônico estiver desabilitada na caixa de correio, o Outlook ainda poderá mover mensagens para a pasta lixo eletrônico. 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. Para obter mais informações, consulte visão geral do filtro de lixo eletrônico.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-Identity

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)

  • <domain name>\<account name>

  • DN canônico

  • GUID

  • LegacyExchangeDN

  • SamAccountName

  • ID de usuário ou nome UPN

Type:MailboxIdParameter
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-IgnoreDefaultScope

O parâmetro IgnoreDefaultScope instrui o comando a ignorar a configuração de escopo do destinatário padrão do Shell de Gerenciamento do Exchange e usar toda a floresta como escopo. Isso permite ao comando acessar os objetos do Active Directory que não estão atualmente disponíveis no escopo padrão.

O uso do parâmetro IgnoreDefaultScope apresenta 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.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-TrustedListsOnly

O parâmetro TrustedListsOnly especifica que somente as mensagens dos remetentes da lista de remetentes confiáveis são entregues na caixa de entrada. Todas as outras mensagens são tratadas como lixo eletrônico. Este parâmetro corresponde à configuração Outlook na Web: não confiar em email, a menos que ele venha de alguém em minha lista de remetentes confiáveis e destinatários. Os valores válidos são:

  • $true: somente mensagens de endereço de email ou entradas de domínio na lista de remetentes confiáveis e a lista de destinatários confiáveis são entregues na caixa de entrada. Todas as outras mensagens são entregues automaticamente à pasta lixo eletrônico.

  • $false: as 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 é o valor padrão.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-TrustedRecipientsAndDomains

Esse parâmetro está reservado para uso interno da Microsoft.

Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online
-TrustedSendersAndDomains

O parâmetro TrustedSendersAndDomains especifica a lista de remetentes confiáveis e os 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 à pasta lixo eletrônico, independentemente do conteúdo. Este parâmetro corresponde à configuração Outlook na Web: não mover email destes remetentes ou domínios para a pasta lixo eletrônico.

Para inserir vários valores e substituir quaisquer entradas existentes, use a seguinte sintaxe: <value1> , <value2> ,... <valueN> . Se os valores contiverem espaços ou exigirem aspas, você precisará usar a seguinte sintaxe: " <value1> ", " <value2> ",... " <valueN> ".

Para adicionar ou remover um ou mais valores sem afetar as entradas existentes, use a seguinte sintaxe: @ {Add = " <value1> ", " <value2> "...; Remove = " <value1> ", " <value2> "...}.

Para esvaziar a lista de endereços de email e domínios, use o valor $null.

Observações:

  • Todos os endereços de email na GAL (lista de endereços global) são automaticamente considerados remetentes confiáveis, portanto, não é necessário adicioná-los à lista.

  • Você não pode modificar diretamente a lista de destinatários confiáveis usando este cmdlet. Você usa 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.

  • Domínios seguros não são reconhecidos no Exchange Online e no Exchange Online Protection. Para obter mais informações, consulte KB3019657.

Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, 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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Inputs

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.

Outputs

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.