Set-RecipientFilterConfig (RTM)

 

Aplica-se a: Exchange Server 2007

Tópico modificado em: 2007-08-27

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>] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-ExternalMailEnabled <$true | $false>] [-Instance <RecipientFilterConfig>] [-InternalMailEnabled <$true | $false>] [-RecipientValidationEnabled <$true | $false>]

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 Exchange Server 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro	Necessário	Tipo	Descrição
BlockedRecipients	Opcional	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	Opcional	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.
DomainController	Opcional	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	Opcional	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	Opcional	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	Opcional	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	Opcional	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	Opcional	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.

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 Bloqueios de IP e como adicionar destinatários à lista de destinatários bloqueados.

A propriedade BlockedRecipients adota vários valores; quando você transmite um valor para a propriedade BlockedRecipients, o valor existente é substituído pelo novo valor. Para obter informações sobre procedimentos que explicam como adicionar valores a uma propriedade de vários valores existente, consulte Modificando propriedades com valores múltiplos.

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