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 configurar as configurações de lixo eletrônico em caixas de correio.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte 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 na caixa de correio:
Habilitar ou desabilitar a regra de email de lixo eletrônico: no Exchange local, a regra de email 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 Junk Email ou a caixa de entrada com base no limite de pasta de Email de lixo eletrônico da SCL (para a organização ou a caixa de correio) e a coleção de listas de segurança na caixa de correio.
No serviço baseado em nuvem, a regra de lixo eletrônico não tem efeito no fluxo de email. Proteção do Exchange Online entrega mensagens para a pasta Junk Email com base nas ações definidas em políticas anti-spam. A regra de email 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 listas de segurança da caixa de correio.
Os usuários podem habilitar ou desabilitar a regra de lixo eletrônico em sua própria caixa de correio usando Outlook na Web.
Configure a coleção safelist: a coleção safelist é a lista Remetentes Seguros, a lista Destinatários Seguros e a lista Remetentes Bloqueados. Os usuários podem configurar a coleção safelist em sua própria caixa de correio usando o Microsoft Outlook ou 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.
Exemplos
Exemplo 1
Set-MailboxJunkEmailConfiguration "David Pelton" -Enabled $falseEste 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 Junk Email com base no limite de Pasta de Email de Lixo eletrônico da SCL (organização ou caixa de correio) ou na coleção safelist da caixa de correio. Em Exchange Online, a coleção safelist da caixa de correio não consegue mover mensagens entre a caixa de entrada e a pasta Junk Email. As mensagens ainda são entregues à pasta Junk 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 safelist para o usuário chamado Michele Martin:
- Adiciona contoso.com e fabrikam.com à lista remetentes seguros 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 $falseEste 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.
Parâmetros
-BlockedSendersAndDomains
O parâmetro BlockedSendersAndDomains especifica a lista De remetentes bloqueados, que é uma lista de endereços de email e domínios do remetente cujas mensagens são enviadas automaticamente para a pasta Junk Email. Esse parâmetro corresponde à configuração Outlook na Web: mover o email desses remetentes ou domínios para a pasta Email 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, 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"...}.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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, 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 Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-ContactsTrusted
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 Outlook na Web: confie em email dos meus contatos. Os valores válidos são:
- $true: Mensagens de contatos na pasta Contatos que chegam à caixa de correio nunca são entregues na pasta Junk Email, 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 for definido na lista Remetentes Seguros. Esse é o valor padrão.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Enabled
O parâmetro Habilitado habilita ou desabilita a regra de lixo eletrônico na 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.
No Exchange local, a coleção safelist da caixa de correio (a lista De remetentes seguros, lista de destinatários seguros e remetentes bloqueados) e o limite da pasta SCL Junk Email (para a organização ou a caixa de correio) entrega mensagens para a caixa de entrada ou a pasta Junk Email.
No serviço baseado em nuvem, a coleção safelist da caixa de correio move mensagens entregues entre a caixa de entrada ou a pasta Junk Email. As mensagens são entregues à pasta Junk Email com base no veredicto e na ação correspondente de 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 mova o email para a pasta Junk Email.
No Exchange local, a coleção safelist da caixa de correio ou o limite de pasta Email lixo eletrônico SCL não podem entregar mensagens na caixa de entrada ou na pasta Junk Email.
No serviço baseado em nuvem, a coleção safelist da caixa de correio não consegue mover mensagens entregues entre a caixa de entrada ou a pasta Junk Email. As mensagens ainda são entregues à pasta Junk 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 qualquer um dos seguintes comandos para encontrar o valor da propriedade Habilitado:
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 Outlook Junk Email Filter. Mesmo quando a regra de lixo eletrônico é desabilitada na caixa de correio, o Outlook ainda pode mover mensagens para a pasta Junk Email. Por exemplo, se o Outlook determinar que a mensagem é spam ou o remetente estiver definido na lista Remetentes Bloqueados, o Outlook poderá mover a mensagem para a pasta Junk Email. Para obter mais informações, consulte Visão geral do Filtro de Email lixo eletrônico.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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\username
- Endereço de email
- GUID
- LegacyExchangeDN
- SamAccountName
- ID de usuário ou nome UPN
| Type: | MailboxIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-IgnoreDefaultScope
A opção IgnoreDefaultScope informa ao comando para ignorar a configuração de escopo padrão do destinatário para a sessão do Exchange PowerShell e usar toda a floresta como o 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 apenas as mensagens de remetentes na lista remetentes seguros são entregues na caixa de entrada. Todas as outras mensagens são tratadas como lixo eletrônico. Esse parâmetro corresponde à configuração Outlook na Web: não confie em email, a menos que ele venha de alguém na minha lista de Remetentes Seguros e Destinatários. Os valores válidos são:
- $true: somente mensagens de endereço de email ou entradas de domínio na lista Remetentes Seguros e na lista Destinatários Seguros são entregues na caixa de entrada. Todas as outras mensagens são entregues automaticamente na pasta Junk Email.
- $false: as mensagens de outros remetentes, destinatários e domínios não são tratadas automaticamente como lixo eletrônico e são avaliadas individualmente. Esse é o valor padrão.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
| Required: | False |
| 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 Seguros e Destinatários Seguros, 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 Junk Email, independentemente do conteúdo. Esse parâmetro corresponde à configuração Outlook na Web: não mova o email desses remetentes ou domínios para a pasta Junk Email.
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, 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:
- Você não pode adicionar endereços de email do remetente do mesmo domínio que o endereço de email do destinatário. Todas as caixas de correio na GAL (lista de endereços global) são automaticamente consideradas como remetentes confiáveis.
- Você não pode modificar diretamente a lista Destinatários Seguros usando este cmdlet. Você usa esse parâmetro para modificar a lista Remetentes Seguros e os endereços de email e domínios são sincronizados com a lista Destinatários Seguros.
- No EOP autônomo 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 para domínios. Para saber mais, veja Configurar a filtragem para usar os dados de domínio seguro de conteúdo.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
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.