Set-MailboxJunkEmailConfiguration
Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e definições podem ser exclusivos de um ambiente ou outro.
Utilize o cmdlet Set-MailboxJunkEmailConfiguration para configurar as definições de e-mail de lixo em 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 definições de e-mail de lixo na caixa de correio:
Ativar ou desativar a regra de e-mail de lixo: no Exchange no local, a regra de e-mail de lixo (uma regra de Caixa de Entrada oculta denominada Regra de E-mail de Lixo) controla a entrega de mensagens na pasta Email de Lixo ou na Caixa de Entrada com base no limiar de Pasta de Email de Lixo SCL (para a organização ou a caixa de correio) e na coleção de lista segura na caixa de correio.
No serviço baseado na nuvem, a regra de e-mail de lixo não tem qualquer efeito no fluxo de correio. As mensagens são entregues na pasta Email de Lixo com base nas ações definidas nas políticas antisspam. A regra de e-mail de lixo na caixa de correio ainda controla o que acontece às mensagens após a entrega com base na coleção de lista segura da caixa de correio.
Os utilizadores podem ativar ou desativar a regra de e-mail de lixo na sua própria caixa de correio com Outlook na Web.
Configurar a coleção de lista segura: a coleção de listas de segurança é a lista de Remetentes Seguros, a lista Destinatários Seguros e a lista de Remetentes Bloqueados. Os utilizadores podem configurar a coleção de listas de segurança na sua própria caixa de correio com o Microsoft Outlook ou Outlook na Web.
Para obter mais informações, consulte Configurar definiçõ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, 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
Set-MailboxJunkEmailConfiguration "David Pelton" -Enabled $false
Este exemplo desativa a regra de e-mail de lixo para o utilizador com o nome David Pelton. No Exchange no local, as mensagens já não são movidas entre a Caixa de Entrada e a pasta Email de Lixo com base no limiar de Pasta de Email de Lixo SCL (organização ou caixa de correio) ou na coleção de lista segura da caixa de correio. No Exchange Online, a coleção de lista segura da caixa de correio não consegue mover mensagens entre a Caixa de Entrada e a pasta Email de Lixo. As mensagens continuam a ser entregues na pasta Email de Lixo com base no veredicto e na ação correspondente das políticas antisspam.
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 à coleção de lista segura para o utilizador com o nome Michele Martin:
- Adiciona contoso.com e fabrikam.com à lista de Remetentes Seguros sem afetar outras entradas existentes.
- Adiciona jane@fourthcoffee.com à lista 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 contactos são tratados como remetentes fidedignos e, em seguida, altera a configuração de e-mail de lixo para não tratar os contactos como remetentes fidedignos.
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 Remetentes Bloqueados, que é uma lista de endereços de e-mail e domínios do remetente cujas mensagens são enviadas automaticamente para a pasta Email de Lixo. Este parâmetro corresponde à definição de Outlook na Web: mova o e-mail destes remetentes ou domínios para a minha pasta Email de Lixo.
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, Suplemento de segurança incorporado para no local caixas de correio
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 |
-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. Este parâmetro corresponde à definição de Outlook na Web: Confiar no e-mail dos meus contactos. Os valores válidos são:
- $true: as mensagens de contactos na pasta Contactos que chegam à caixa de correio nunca são entregues na pasta Email de Lixo, independentemente do conteúdo.
- $false: as mensagens de contactos na pasta Contactos não são tratadas como remetentes fidedignos. O endereço de e-mail é um remetente fidedigno apenas se estiver definido na lista remetentes seguros. Este valor é a predefiniçã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 Ativado ativa ou desativa a regra de e-mail de lixo na caixa de correio (uma regra de Caixa de Entrada oculta denominada Regra de E-mail de Lixo). Os valores válidos são:
$true: a regra de e-mail de lixo está ativada na caixa de correio. Este valor corresponde à definição de Outlook na Web: Filtrar automaticamente o e-mail de lixo. Este valor é a predefinição.
No Exchange no local, a coleção de lista segura da caixa de correio (a lista remetentes seguros, a lista de Destinatários Seguros e a lista de Remetentes Bloqueados) e o limiar da pasta Email de Lixo SCL (para a organização ou a caixa de correio) envia mensagens para a Caixa de Entrada ou para a pasta Email de Lixo.
No serviço baseado na nuvem, a coleção de lista segura da caixa de correio move as mensagens entregues entre a Caixa de Entrada ou a pasta Email de Lixo. As mensagens são entregues na pasta Email de Lixo com base no veredicto e na ação correspondente apenas de políticas antisspam.
$false: a regra de e-mail de lixo está desativada na caixa de correio. Este valor corresponde à definição de Outlook na Web: não mova o e-mail para a minha pasta Email de Lixo.
No Exchange no local, a coleção de lista segura da caixa de correio ou o limiar da pasta de Email de Lixo SCL não consegue entregar mensagens na Caixa de Entrada ou na pasta Email de Lixo.
No serviço baseado na nuvem, a coleção de lista segura da caixa de correio não consegue mover mensagens entregues entre a Caixa de Entrada ou a pasta Email de Lixo. As mensagens continuam a ser entregues na pasta Email de Lixo com base no veredicto e na ação correspondente das políticas antisspam.
Pode ver a status da regra de e-mail de lixo ao executar um dos seguintes comandos para localizar o valor da propriedade Ativado:
Get-MailboxJunkEmailConfiguration -Identity <MailboxIdentity>- Apenas no Exchange no local:
Get-InboxRule "Junk E-mail Rule" -Mailbox <MailboxIdentity> -IncludeHidden
O estado da regra de e-mail de lixo na caixa de correio não afeta as definições de e-mail de lixo do lado do cliente que estão disponíveis no Filtro de Email de Lixo do Outlook. Mesmo quando a regra de e-mail de lixo está desativada na caixa de correio, o Outlook ainda pode mover mensagens para a pasta Email de Lixo. Por exemplo, se o Outlook determinar que a mensagem é spam ou se o remetente estiver definido na lista Remetentes Bloqueados, o Outlook pode mover a mensagem para a pasta Email de Lixo. Para obter mais informações, veja Descrição geral do Filtro de Email de Lixo.
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, Suplemento de segurança incorporado para no 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 Utilizador
- 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
O comutador IgnoreDefaultScope indica ao comando para ignorar a definição de âmbito de destinatário predefinida para a sessão do Exchange PowerShell e utilizar toda a floresta como âmbito. Não é preciso especificar um valor com essa opção.
Este comutador permite que o comando aceda a objetos do Active Directory que não estão atualmente disponíveis no âmbito predefinido, 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.
{{ Fill SenderScreeningEnabled 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 |
-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 apenas as mensagens de remetentes na lista remetentes seguros são entregues na Caixa de Entrada. Todas as outras mensagens são tratadas como e-mail de lixo. Este parâmetro corresponde à definição de Outlook na Web: não confie no e-mail, a menos que seja proveniente de alguém na minha lista remetentes e destinatários seguros. Os valores válidos são:
- $true: apenas as mensagens do endereço de e-mail 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 Email de Lixo.
- $false: as mensagens de outros remetentes, destinatários e domínios não são tratadas automaticamente como e-mail de lixo e são avaliadas individualmente. Este valor é a predefiniçã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 Remetentes Seguros e a lista De Destinatários Seguros, que são listas de endereços de e-mail e domínios. As mensagens destes remetentes que chegam à caixa de correio nunca são entregues na pasta Email de Lixo, independentemente do conteúdo. Este parâmetro corresponde à definição de Outlook na Web: não mova o e-mail destes remetentes ou domínios para a minha pasta Email de Lixo.
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 e-mail e domínios, utilize o valor $null.
Observações:
- Não pode adicionar endereços de e-mail do remetente do mesmo domínio que o endereço de e-mail do destinatário. Todas as caixas de correio na lista de endereços global (GAL) são automaticamente consideradas remetentes fidedignos.
- Não pode modificar diretamente a lista De Destinatários Seguros com este cmdlet. Utilize este parâmetro para modificar a lista de Remetentes Seguros e os endereços de e-mail e domínios são sincronizados com a lista Destinatários Seguros.
- Nas organizações híbridas do Exchange com sincronização de diretórios, as entradas de domínio não são sincronizadas por predefinição, mas pode ativar a sincronização para 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, Suplemento de segurança incorporado para no local caixas de correio
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.
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.