Set-ReceiveConnector (RTM)
Aplica-se a: Exchange Server 2007 SP1, Exchange Server 2007
Tópico modificado em: 2007-07-23
Use o cmdlet Set-ReceiveConnector para modificar um conector de recebimento existente em um computador em que a função de servidor Transporte de Hub ou a função de servidor Transporte de Borda esteja instalada.
Sintaxe
Set-ReceiveConnector -Identity <ReceiveConnectorIdParameter> [-AuthMechanism <None | Tls | Integrated | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-Banner <String>] [-BinaryMimeEnabled <$true | $false>] [-Bindings <MultiValuedProperty>] [-ChunkingEnabled <$true | $false>] [-Comment <String>] [-ConnectionInactivityTimeout <EnhancedTimeSpan>] [-ConnectionTimeout <EnhancedTimeSpan>] [-DefaultDomain <AcceptedDomainIdParameter>] [-DeliveryStatusNotificationEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-EightBitMimeEnabled <$true | $false>] [-Enabled <$true | $false>] [-EnhancedStatusCodesEnabled <$true | $false>] [-Fqdn <Fqdn>] [-MaxHeaderSize <ByteQuantifiedSize>] [-MaxHopCount <Int32>] [-MaxInboundConnection <Unlimited>] [-MaxInboundConnectionPercentagePerSource <Int32>] [-MaxInboundConnectionPerSource <Unlimited>] [-MaxLocalHopCount <Int32>] [-MaxLogonFailures <Int32>] [-MaxMessageSize <ByteQuantifiedSize>] [-MaxProtocolErrors <Unlimited>] [-MaxRecipientsPerMessage <Int32>] [-MessageRateLimit <Unlimited>] [-Name <String>] [-PermissionGroups <None | AnonymousUsers | ExchangeUsers | ExchangeServers | ExchangeLegacyServers | Partners | Custom>] [-PipeliningEnabled <$true | $false>] [-ProtocolLoggingLevel <None | Verbose>] [-RemoteIPRanges <MultiValuedProperty>] [-RequireEHLODomain <$true | $false>] [-RequireTLS <$true | $false>] [-SizeEnabled <Disabled | Enabled | EnabledWithoutValue>] [-TarpitInterval <EnhancedTimeSpan>]
Set-ReceiveConnector [-AuthMechanism <None | Tls | Integrated | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-Banner <String>] [-BinaryMimeEnabled <$true | $false>] [-Bindings <MultiValuedProperty>] [-ChunkingEnabled <$true | $false>] [-Comment <String>] [-ConnectionInactivityTimeout <EnhancedTimeSpan>] [-ConnectionTimeout <EnhancedTimeSpan>] [-DefaultDomain <AcceptedDomainIdParameter>] [-DeliveryStatusNotificationEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-EightBitMimeEnabled <$true | $false>] [-Enabled <$true | $false>] [-EnhancedStatusCodesEnabled <$true | $false>] [-Fqdn <Fqdn>] [-Instance <ReceiveConnector>] [-MaxHeaderSize <ByteQuantifiedSize>] [-MaxHopCount <Int32>] [-MaxInboundConnection <Unlimited>] [-MaxInboundConnectionPercentagePerSource <Int32>] [-MaxInboundConnectionPerSource <Unlimited>] [-MaxLocalHopCount <Int32>] [-MaxLogonFailures <Int32>] [-MaxMessageSize <ByteQuantifiedSize>] [-MaxProtocolErrors <Unlimited>] [-MaxRecipientsPerMessage <Int32>] [-MessageRateLimit <Unlimited>] [-Name <String>] [-PermissionGroups <None | AnonymousUsers | ExchangeUsers | ExchangeServers | ExchangeLegacyServers | Partners | Custom>] [-PipeliningEnabled <$true | $false>] [-ProtocolLoggingLevel <None | Verbose>] [-RemoteIPRanges <MultiValuedProperty>] [-RequireEHLODomain <$true | $false>] [-RequireTLS <$true | $false>] [-SizeEnabled <Disabled | Enabled | EnabledWithoutValue>] [-TarpitInterval <EnhancedTimeSpan>]
Descrição detalhada
O cmdlet Set-ReceiveConnector modifica um conector de recebimento existente. O parâmetro Identity será necessário quando você executar o cmdlet Set-ReceiveConnector.
Depois que essa tarefa for concluída, o conector de recebimento será modificado.
Para executar o cmdlet Set-ReceiveConnector, você deve usar uma conta à qual esteja delegada o seguinte:
- Função Administrador do Exchange Server e grupo Administradores local para o servidor de destino
Para executar o cmdlet Set-ReceiveConnector 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(s) | Tipo | Descrição |
---|---|---|---|
Identidade |
Necessário(s) |
Microsoft.Exchange.Configuration.Tasks.ReceiveConnectorIdParameter |
Esse parâmetro especifica a GUID ou o nome do conector que representa o conector de recebimento. O rótulo Identity pode ser omitido. |
AuthMechanism |
Opcional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ReceiveConnector+AuthMechanisms |
Esse parâmetro especifica os mecanismos de autenticação anunciados e aceitos. As opções de autenticação são |
Banner |
Opcional |
System.String |
Esse parâmetro substitui a faixa 220 padrão do protocolo SMTP. Quando o valor do parâmetro Banner estiver vazio, o banner SMTP padrão será:
Ao especificar um valor para o parâmetro Banner, use a seguinte sintaxe:
220 é o código de resposta SMTP padrão de "Serviço pronto", definido no RFC 2821. |
BinaryMimeEnabled |
Opcional |
System.Boolean |
Os valores válidos para esse parâmetro são |
Bindings |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
Este parâmetro especifica o endereço IP local e os números de porta TCP usados pelo Conector de Recebimento para ouvir as mensagens de entrada. A sintaxe válida para esse parâmetro é <Endereço IP>:<Porta TCP>, como Dica Você deve especificar um endereço IP local válido para o servidor de Transporte de Borda ou de Transporte de Hub no qual o conector de recebimento está localizado. Se você especificar um endereço IP local inválido, o serviço de Transporte do Microsoft Exchange poderá não iniciar quando o serviço for reiniciado. Para especificar todos os endereços IP configurados em todos os adaptadores de rede, você pode usar o endereço IP Os valores especificados com o parâmetro Bindings devem satisfazer um dos seguintes requisitos de exclusividade:
|
ChunkingEnabled |
Opcional |
System.Boolean |
Os valores válidos para esse parâmetro são |
Comment |
Opcional |
System.String |
Coloque o parâmetro Comment entre aspas duplas, conforme o exemplo a seguir: |
ConnectionInactivityTimeout |
Opcional |
Microsoft.Exchange.Data.EnhancedTimeSpan |
Esse parâmetro especifica a quantidade máxima de tempo ocioso antes que uma conexão com um conector de recebimento seja fechada. O valor padrão para um Conector de recebimento configurado em um servidor de Transporte de Hub é de 5 minutos. O valor padrão para um conector de recebimento configurado em um servidor de Transporte de Borda é de 1 minuto. Para especificar um valor, insira o valor como um período de tempo: dd.hh:mm:ss, onde d = dias, h = horas, m = minutos e s = segundos. O valor especificado pelo parâmetro ConnectionTimeout deve ser maior que o valor especificado pelo parâmetro ConnectionInactivityTimeout. O intervalo de entrada válido de ambos os parâmetros é de |
ConnectionTimeOut |
Opcional |
Microsoft.Exchange.Data.EnhancedTimeSpan |
Esse parâmetro especifica o período máximo que uma conexão pode permanecer aberta, mesmo se estiver transmitindo dados ativamente. O valor padrão para um Conector de recebimento configurado em um servidor de Transporte de Hub é de 10 minutos, enquanto o valor padrão para um Conector de recebimento configurado em um servidor de Transporte de Borda é de 5 minutos. Para especificar um valor, insira o valor como um período de tempo: dd.hh:mm:ss, onde d = dias, h = horas, m = minutos e s = segundos. O valor especificado pelo parâmetro ConnectionTimeout deve ser maior que o valor especificado pelo parâmetro ConnectionInactivityTimeout. O intervalo de entrada válido de ambos os parâmetros é de |
DefaultDomain |
Opcional |
Microsoft.Exchange.Configuration.Tasks.AcceptedDomainIdParameter |
Esse parâmetro especifica o nome de domínio a ser anexado aos valores enviados ao |
DeliveryStatusNotificationEnabled |
Opcional |
System.Boolean |
Os valores válidos para esse parâmetro são |
DomainController |
Opcional |
Microsoft.Exchange.Data.Fqdn |
Para especificar o FQDN (nome de domínio totalmente qualificado) 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 que executam a função de servidor Transporte de Borda. A função de servidor Transporte de Borda lê e grava apenas na instância local do ADAM. |
DomainSecureEnabled |
Opcional |
System.Boolean |
Esse parâmetro é a primeira parte do processo para habilitar a autenticação TLS mútua para os domínios atendidos por esse conector de recebimento. A autenticação mútua de TLS funcionará corretamente apenas se as seguintes condições forem verdadeiras:
O valor padrão de DomainSecureEnabled é
O valor padrão de DomainSecureEnabled é |
EightBitMimeEnabled |
Opcional |
System.Boolean |
Os valores válidos para esse parâmetro são |
Enabled |
Opcional |
System.Boolean |
Os valores válidos para esse parâmetro são |
EnhancedStatusCodesEnabled |
Opcional |
System.Boolean |
Os valores válidos para esse parâmetro são |
Fqdn |
Opcional |
Microsoft.Exchange.Data.Fqdn |
Este parâmetro especifica o FQDN usado como servidor de destino dos servidores de mensagens conectados que usam o Conector de Recebimento para enviar mensagens de entrada. O valor desse parâmetro é exibido para os servidores de mensagens conectados sempre que um nome de servidor de destino for necessário, como nos exemplos a seguir:
O valor padrão do parâmetro Fqdn é o FQDN do servidor de Transporte de Hub ou de Transporte de Borda que contém o Conector de Recebimento. Dica Não modifique o valor do FQDN no conector de recebimento padrão chamado “<Nome do Servidor> Padrão”, criado automaticamente em servidores de Transporte de Hub. Se você tiver vários servidores de Transporte de Hub em sua organização do Exchange e mudar o valor do FQDN no conector de recebimento do “<Nome do Servidor> Padrão”, o fluxo interno de mensagens entre os servidores de Transporte de Hub falhará. |
Instance |
Opcional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ReceiveConnector |
Esse parâmetro permite que você passe um objeto inteiro para o comando para ser processado. Ele é usado principalmente quando um objeto inteiro deve ser passado para o comando. |
MaxHeaderSize |
Opcional |
Microsoft.Exchange.Data.ByteQuantifiedSize |
Esse parâmetro especifica em bytes o tamanho máximo do cabeçalho de mensagem SMTP que o conector de recebimento aceita antes de fechar a conexão. O valor padrão é
Os valores não qualificados são considerados bytes. O intervalo de entrada válido para esse parâmetro é de |
MaxHopCount |
Opcional |
System.Int32 |
Esse parâmetro especifica o número máximo de saltos que uma mensagem pode ter para que seja rejeitada pelo conector de recebimento. O valor padrão é Dica O número máximo de saltos é determinado pelo número de cabeçalhos "Received:" em uma mensagem enviada. |
MaxInboundConnection |
Opcional |
Microsoft.Exchange.Data.Unlimited |
O parâmetro MaxInboundConnection especifica o número máximo de conexões de entrada servidas por esse conector de recebimento simultaneamente. O valor padrão é |
MaxInboundConnectionPercentagePerSource |
Opcional |
System.Int32 |
Esse parâmetro especifica o número máximo de conexões servidas por um conector de recebimento simultaneamente de um único endereço IP. O valor é expresso como a porcentagem de conexões restantes disponíveis em um Conector de recebimento. Digite o valor como um inteiro sem o caractere de porcentagem (%). O valor padrão é 2 por cento. O intervalo de entrada válido para esse parâmetro é de |
MaxInboundConnectionPerSource |
Opcional |
Microsoft.Exchange.Data.Unlimited |
Esse parâmetro especifica o número máximo de conexões de entrada servidas por esse conector de recebimento simultaneamente de um único endereço IP. O valor padrão é |
MaxLocalHopCount |
Opcional |
System.Int32 |
Esse parâmetro especifica o número máximo de saltos que uma mensagem pode ter para que seja rejeitada pelo conector de recebimento. O valor padrão é Dica O número máximo de saltos locais é determinado pelo número de "Recebido:" com endereços de servidor local em uma mensagem enviada. |
MaxLogonFailures |
Opcional |
System.Int32 |
Esse parâmetro especifica o número de tentativas falhas de logon do conector de recebimento antes de fechar a conexão. O valor padrão é |
MaxMessageSize |
Opcional |
Microsoft.Exchange.Data.ByteQuantifiedSize |
Esse parâmetro especifica o tamanho máximo de uma mensagem. O parâmetro MaxMessageSize aceita um inteiro. O valor padrão é
Inteiros não qualificados são tratados como bytes. O intervalo de entrada válida desse parâmetro é de 1 a 2.147.483.647 bytes. |
MaxProtocolErrors |
Opcional |
Microsoft.Exchange.Data.Unlimited |
Esse parâmetro especifica o número máximo de erros de protocolo SMTP que o conector de recebimento aceita antes de fechar a conexão. O valor padrão é |
MaxRecipientsPerMessage |
Opcional |
System.Int32 |
O parâmetro MaxRecipientsPerMessage especifica o número máximo de erros de destinatários por mensagem que o conector de recebimento aceita antes de fechar a conexão. O valor padrão é |
MessageRateLimit |
Opcional |
Microsoft.Exchange.Data.Unlimited |
Esse parâmetro especifica o número máximo de mensagens que podem ser enviadas por um único endereço IP de cliente por minuto. O valor padrão de um conector de recebimento configurado em um servidor de Transporte de Hub é |
Name |
Opcional |
System.String |
Esse parâmetro especifica o nome do conector fornecido pelo administrador. Digite o parâmetro Name como uma cadeia de caracteres, conforme o exemplo a seguir: |
PermissionGroups |
Opcional |
Microsoft.Exchange.Data.PermissionGroups |
Esse parâmetro define os grupos ou as funções que podem enviar mensagens ao conector de recebimento e as permissões atribuídas a esses grupos. Um grupo de permissões é um conjunto predefinido de permissões concedidas a entidades de segurança externas conhecidas. Os valores válidos para esse parâmetro são os seguintes: |
PipeliningEnabled |
Opcional |
System.Boolean |
Os valores válidos para esse parâmetro são |
ProtocolLoggingLevel |
Opcional |
Microsoft.Exchange.Data.ProtocolLoggingLevel |
Esse parâmetro habilita ou desabilita o log de protocolos do conector de recebimento especificado. Um valor de |
RemoteIPRanges |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
Este parâmetro especifica os endereços IP remotos dos quais esse conector aceita mensagens. A sintaxe válida para esse parâmetro é <Endereço IP de início>-<Endereço IP de término>, como Vários Conectores de Recebimento no mesmo servidor podem ter intervalos de endereços IP remotos sobrepostos, desde que um intervalo de endereço IP seja completamente sobreposto por outro. Quando intervalos de endereços IP remotos se sobrepõem, o intervalo de endereços IP remotos com a correspondência mais específica ao endereço IP do servidor de conexão é usado. |
RequireEHLODomain |
Opcional |
System.Boolean |
Os valores válidos para esse parâmetro são |
RequireTLS |
Opcional |
System.Boolean |
Os valores válidos para esse parâmetro são |
SizeEnabled |
Opcional |
Microsoft.Exchange.Data.SizeMode |
Os valores válidos para esse parâmetro são |
TarpitInterval |
Opcional |
Microsoft.Exchange.Data.EnhancedTimeSpan |
O parâmetro TarpitInterval especifica o período de tempo a aguardar por uma resposta SMTP em um servidor remoto que o Exchange determina que esteja fazendo mau uso da conexão. As conexões autenticadas nunca são atrasadas dessa maneira. O valor padrão é 5 segundos. Para especificar um valor, insira o valor como um período de tempo: hh:mm:ss, em que h = horas, m = minutos e s = segundos. O intervalo de entrada válido para esse parâmetro é de |
Tipos de entrada
Tipos de retorno
Erros
Erro | Descrição |
---|---|
|
|
Exemplo
O exemplo a seguir do comando
Set-ReceiveConnector define o parâmetro Banner como "220 Banner Text here"
e o parâmetro ConnectionTimeOut como 00:15:00
.
Set-ReceiveConnector -Identity "Internet Receive Connector" -Banner "220 Banner Text here" -ConnectionTimeout 00:15:00