Set-RecipientFilterConfig

Artigo
09/30/2014

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2009-05-18

Use o cmdlet Set-RecipientFilterConfig para habilitar e configurar o agente de Filtro de Destinatário em um computador em que a função de servidor Transporte de Borda ou Transporte de Hub esteja instalada.

Sintaxe

Set-RecipientFilterConfig [-BlockedRecipients <MultiValuedProperty>] [-BlockListEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-ExternalMailEnabled <$true | $false>] [-Instance <RecipientFilterConfig>] [-InternalMailEnabled <$true | $false>] [-RecipientValidationEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

Para executar o cmdlet Set-RecipientFilterConfig, você deve usar uma conta à qual esteja delegado o seguinte:

Função de Administrador do Exchange Server e grupo Administradores local para o servidor de destino

Para executar o cmdlet Set-RecipientFilterConfig em um computador em que a função de servidor Transporte de Borda esteja instalada, faça logon com uma conta que seja membro do grupo Administradores local no computador.

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Microsoft Exchange Server 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro	Necessário	Tipo	Descrição
BlockedRecipients	Optional	Microsoft.Exchange.Data.MultiValuedProperty	A entrada válida para o parâmetro BlockedRecipients Enabled é um ou mais endereços SMTP. Você pode inserir até 800 endereços SMTP individuais no parâmetro BlockedRecipients.
BlockListEnabled	Optional	System.Boolean	A entrada válida para o parâmetro BlockListEnabled Enabled é `$true` ou `$false`. A configuração padrão é `$false`. Quando o parâmetro BlockListEnabled é definido como `$true`, o agente do Filtro de Destinatário bloqueia as mensagens enviadas aos destinatários listados no parâmetro BlockedRecipients.
Confirm	Optional	System.Management.Automation.SwitchParameter	O parâmetro Confirm faz com que o comando pause o processamento e exige que você confirme o que o comando fará antes que o processamento continue. Você não precisa especificar um valor com o parâmetro Confirm.
DomainController	Optional	Microsoft.Exchange.Data.Fqdn	Para especificar o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que grava essa alteração de configuração no serviço de diretório do Active Directory, inclua o parâmetro DomainController no comando. O parâmetro DomainController não tem suporte em computadores em que a função de servidor Transporte de Borda está instalada. A função de servidor Transporte de Borda grava apenas para a instância ADAM local.
Enabled	Optional	System.Boolean	A entrada válida para o parâmetro Enabled é `$true` ou `$false`. A configuração padrão é `$true`. Quando o parâmetro Enabled é definido como `$true`, o agente de Filtro de Destinatário é habilitado no computador em que você está executando o cmdlet `Set-RecipientFilterConfig`.
ExternalMailEnabled	Optional	System.Boolean	A entrada válida para o parâmetro ExternalMailEnabled é `$true` ou `$false`. A configuração padrão é `$true`. Quando o parâmetro ExternalMailEnabled é definido como `$true`, todas as mensagens de conexões não autenticadas são passadas para o agente do Filtro de Destinatário para serem processadas.
Instance	Optional	Microsoft.Exchange.Data.Directory.SystemConfiguration.RecipientFilterConfig	O parâmetro Instance permite que você passe um objeto inteiro para o comando a ser processado. Ele é usado principalmente quando um objeto inteiro deve ser passado para o comando.
InternalMailEnabled	Optional	System.Boolean	A entrada válida para o parâmetro InternalMailEnabled é `$true` ou `$false`. A configuração padrão é `$false`. Quando o parâmetro InternalMailEnabled é definido como `$true`, todas as mensagens de domínios de remetentes autenticados que pertencem a domínios autorizados em sua empresa são passados para o agente do Filtro de Destinatário para serem processadas.
RecipientValidationEnabled	Optional	System.Boolean	A entrada válida para o parâmetro RecipientValidationEnabled Enabled é `$true` ou `$false`. A configuração padrão é `$false`. Quando o parâmetro RecipientValidationEnabled é definido como `$true`, o agente do Filtro de Destinatário bloqueia as mensagens que contêm destinatários que não existem na organização.
WhatIf	Optional	System.Management.Automation.SwitchParameter	O parâmetro WhatIf instrui o comando a simular as ações que ele executará no objeto. Ao usar o parâmetro WhatIf, você poderá exibir quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. Você não precisa especificar um valor com o parâmetro WhatIf.

Tipos de entrada

Tipos de retorno

Erros

Erro	Descrição

Exemplo

Os exemplos de código a seguir mostram dois comandos Set-RecipientFilterConfig.

O primeiro exemplo de código mostra como modificar a configuração de filtro de destinatário para que a validação de destinatário seja habilitada.

O segundo exemplo de código mostra como habilitar a lista de Destinatários Bloqueados e como adicionar destinatários à lista de Destinatários Bloqueados.

O parâmetro BlockedRecipients aceita vários valores. Quando você passa um valor para o parâmetro BlockedRecipients, o valor existente é substituído pelo novo valor. Para obter mais informações sobre como adicionar ou remover valores de propriedades com vários valores, consulte Modificando propriedades com valores múltiplos.

Set-RecipientFilterConfig -RecipientValidationEnabled:$true
Set-RecipientFilterConfig -BlockListEnabled:$true -BlockedRecipients user1@contoso.com,user2@contoso.com

Compartilhar via