Set-ReceiveConnector

 

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

Tópico modificado em: 2009-08-19

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>] [-Confirm [<SwitchParameter>]] [-ConnectionInactivityTimeout <EnhancedTimeSpan>] [-ConnectionTimeout <EnhancedTimeSpan>] [-DefaultDomain <AcceptedDomainIdParameter>] [-DeliveryStatusNotificationEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-EightBitMimeEnabled <$true | $false>] [-EnableAuthGSSAPI <$true | $false>] [-Enabled <$true | $false>] [-EnhancedStatusCodesEnabled <$true | $false>] [-Fqdn <Fqdn>] [-LongAddressesEnabled <$true | $false>] [-MaxHeaderSize <ByteQuantifiedSize>] [-MaxHopCount <Int32>] [-MaxInboundConnection <Unlimited>] [-MaxInboundConnectionPercentagePerSource <Int32>] [-MaxInboundConnectionPerSource <Unlimited>] [-MaxLocalHopCount <Int32>] [-MaxLogonFailures <Int32>] [-MaxMessageSize <ByteQuantifiedSize>] [-MaxProtocolErrors <Unlimited>] [-MaxRecipientsPerMessage <Int32>] [-MessageRateLimit <Unlimited>] [-Name <String>] [-OrarEnabled <$true | $false>] [-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>] [-WhatIf [<SwitchParameter>]]

Set-ReceiveConnector [-AuthMechanism <None | Tls | Integrated | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-Banner <String>] [-BinaryMimeEnabled <$true | $false>] [-Bindings <MultiValuedProperty>] [-ChunkingEnabled <$true | $false>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ConnectionInactivityTimeout <EnhancedTimeSpan>] [-ConnectionTimeout <EnhancedTimeSpan>] [-DefaultDomain <AcceptedDomainIdParameter>] [-DeliveryStatusNotificationEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-EightBitMimeEnabled <$true | $false>] [-EnableAuthGSSAPI <$true | $false>] [-Enabled <$true | $false>] [-EnhancedStatusCodesEnabled <$true | $false>] [-Fqdn <Fqdn>] [-Instance <ReceiveConnector>] [-LongAddressesEnabled <$true | $false>] [-MaxHeaderSize <ByteQuantifiedSize>] [-MaxHopCount <Int32>] [-MaxInboundConnection <Unlimited>] [-MaxInboundConnectionPercentagePerSource <Int32>] [-MaxInboundConnectionPerSource <Unlimited>] [-MaxLocalHopCount <Int32>] [-MaxLogonFailures <Int32>] [-MaxMessageSize <ByteQuantifiedSize>] [-MaxProtocolErrors <Unlimited>] [-MaxRecipientsPerMessage <Int32>] [-MessageRateLimit <Unlimited>] [-Name <String>] [-OrarEnabled <$true | $false>] [-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>] [-WhatIf [<SwitchParameter>]]

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 de 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 Tipo Descrição

Identity

Necessário

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 None, TLS, Integrated, BasicAuth, BasicAuthRequireTLS, ExchangeServer e ExternalAuthoritative. Você pode especificar vários valores, separados por vírgulas, para o parâmetro AuthMechanism. Se o parâmetro RequireTLS for definido como $true, o parâmetro AuthMechanism deverá ser definido como TLS. Se você definir o parâmetro AuthMechanism como BasicAuthRequireTLS, deverá selecionar também BasicAuth e TLS. O valor do parâmetro AuthMechanism, ExternalAuthoritative, só pode coexistir com o valor TLS. Se você definir o parâmetro AuthMechanism como ExternaAuthoritative, o parâmetro PermissionGroups deverá ter também o valor ExchangeServers.

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á:

220 <Servername> Microsoft ESMTP MAIL service ready at <RegionalDay-Date-24HourTimeFormat> <RegionalTimeZoneOffset>

Ao especificar um valor para o parâmetro Banner, use a seguinte sintaxe:

"220 <RemainingBannerText>".

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 $True ou $False. O valor padrão é $True. Quando o parâmetro BinaryMimeEnabled é definido como $True, a palavra-chave BINARYMIME EHLO é anunciada na resposta de EHLO ao servidor remoto e fica disponível para uso. Quando o parâmetro BinaryMimeEnabled é definido como $False, a palavra-chave BINARYMIME EHLO não é anunciada na resposta de EHLO ao servidor remoto e fica desabilitada. A extensão BINARYMIME habilita computadores remotos para enviar dados binários da mensagem a este conector de recebimento. A extensão BINARYMIME exige que a extensão de serviço de quebra de dados, CHUNKING, seja habilitada. Portanto, se você definir o parâmetro BinaryMimeEnabled como $True, deverá definir também o parâmetro ChunkingEnabled como $True.

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 192.168.1.1:25. O endereço IP 0.0.0.0 indica que o conector de recebimento usa todos os endereços IP configurados em todos os adaptadores de rede para ouvir mensagens de entrada.

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 0.0.0.0.

Os valores especificados com o parâmetro Bindings devem satisfazer um dos seguintes requisitos de exclusividade:

  • Você pode especificar uma combinação exclusiva de endereço IP e porta TCP que não entre em conflito com o endereço IP ou a porta TCP usada no parâmetro Bindings de outro Conector de Recebimento no servidor.

  • Você pode usar uma combinação existente de endereço IP e porta TCP, mas use o parâmetro RemoteIPRanges para restringir os servidores remotos atendidos pelo Conector de Recebimento.

ChunkingEnabled

Opcional

System.Boolean

Os valores válidos para esse parâmetro são $True ou $False. O valor padrão é $True. Quando o parâmetro ChunkingEnabled é definido como $True, a palavra-chave CHUNKING EHLO é anunciada na resposta de EHLO ao servidor remoto e fica disponível para uso. Quando o parâmetro ChunkingEnabled é definido como $False, a palavra-chave CHUNKING EHLO não é anunciada na resposta de EHLO ao servidor remoto e fica desabilitada. A extensão CHUNKING habilita corpos de mensagens grandes para serem retransmitidos pelo servidor remoto ao conector de recebimento em várias partes menores.

Comment

Opcional

System.String

Coloque o parâmetro Comment entre aspas duplas, conforme o exemplo a seguir: "this is an admin note".

Confirm

Opcional

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.

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 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 00:00:01 a 1.00:00:00.

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 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 00:00:01 a 1.00:00:00.

DefaultDomain

Opcional

Microsoft.Exchange.Configuration.Tasks.AcceptedDomainIdParameter

Esse parâmetro especifica o nome de domínio a ser anexado aos valores enviados ao MAIL FROM: ou RCPT TO: no envelope da mensagem por um servidor de envio se nenhum nome de domínio for fornecido.

DeliveryStatusNotificationEnabled

Opcional

System.Boolean

Os valores válidos para esse parâmetro são $True ou $False. O valor padrão é $True. Quando o parâmetro DeliveryStatusNotificationEnabled é definido como $True, a palavra-chave DSN EHLO é anunciada na resposta de EHLO ao servidor remoto e fica disponível para uso. Quando o parâmetro DeliveryStatusNotificationEnabled é definido como $False, a palavra-chave DSN EHLO não é anunciada na resposta de EHLO ao servidor remoto e fica desabilitada. A extensão DSN para ESMTP oferece a funcionalidade avançada de notificação de status de entrega que é especificada no RFC 1891.

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 do parâmetro DomainSecureEnabled é $True.

  • O valor do parâmetro AuthMechanism contém TLS e não contém ExternalAuthoritative.

  • O parâmetro TLSReceiveDomainSecureList no cmdlet Get-TransportConfig contém pelo menos um domínio que é atendido por esse conector de recebimento. O caractere curinga (*) não tem suporte em domínios configurados para autenticação mútua de TLS. O mesmo domínio pode ser definido também no conector de envio correspondente e no valor do parâmetro TLSSendDomainSecureList no cmdlet Get-TransportConfig.

O valor padrão de DomainSecureEnabled é $False para os seguintes tipos de conectores de recebimento:

  • Todos os conectores de recebimento definidos em um servidor de Transporte de Hub.

  • Os conectores de recebimento criados pelo usuário, definidos em um servidor de Transporte de Borda.

O valor padrão de DomainSecureEnabled é $True para os conectores de recebimento padrão definidos em um servidor de Transporte de Borda.

EightBitMimeEnabled

Opcional

System.Boolean

Os valores válidos para esse parâmetro são $True ou $False. O valor padrão é $True. Quando o parâmetro EightBitMimeEnabled é definido como $True, a palavra-chave 8BITMIME EHLO é anunciada na resposta de EHLO ao servidor remoto e está disponível para uso. Quando o parâmetro EightBitMimeEnabled é definido como $False, a palavra-chave 8BITMIME EHLO não é anunciada na resposta de EHLO ao servidor remoto e fica desabilitada.

EnableAuthGSSAPI

Opcional

System.Boolean

Esse parâmetro controla o anúncio do método de autenticação GSSAPI (Interface de programação do aplicativo Serviços de Segurança Genéricos) quando a autenticação integrada do Windows estiver habilitada nesse conector. Se o parâmetro AuthMechanism contiver Integrated e o parâmetro EnableAuthGSSAPI estiver definido como $True, a palavra-chave AUTH GSSAPI NTLM será anunciada na resposta de EHLO no conector de recebimento. Os clientes podem usar Kerberos ou NTLM para executar a autenticação no conector de recebimento. Se o parâmetro AuthMechanism contiver Integrated e o parâmetro EnableAuthGSSAPI estiver definido como $False, a palavra-chave AUTH NTLM será anunciada na resposta de EHLO no conector de recebimento. Os clientes podem usar somente NTLM para executar a autenticação no conector de recebimento.

Se você tiver servidores de mensagens do IIS (Serviços de Informações da Internet) da Microsoft que executem a autenticação com esse conector de recebimento, você deverá definir o valor do parâmetro EnableAuthGSSAPI como $False. A autenticação com servidores Exchange 2003 não é afetada pelo valor do parâmetro EnableAuthGSSAPI. Os servidores Exchange 2003 usam os métodos de autenticação que são anunciados na palavra-chave X-EXPS. A palavra-chave X-EXPS será anunciada na resposta de EHLO do conector de recebimento quando o parâmetro AuthMechanism contiver ExchangeServer.

O intervalo de entrada válido para esse parâmetro é $True ou $False. O valor padrão é $False. Por padrão, o parâmetro EnableAuthGSSAPI é definido como $True somente no conector de recebimento padrão chamado "<Nome do servidor> cliente", que é criado somente em servidores de Transporte de Hub.

Enabled

Opcional

System.Boolean

Os valores válidos para esse parâmetro são $True ou $False. O valor padrão é $True. Use o parâmetro Enabled para habilitar ou desabilitar o conector.

EnhancedStatusCodesEnabled

Opcional

System.Boolean

Os valores válidos para esse parâmetro são $True ou $False. O valor padrão é $True. Quando o parâmetro EnhancedStatusCodesEnabled é definido como $True, a palavra-chave ENHANCEDSTATUSCODES EHLO é anunciada na resposta de EHLO ao servidor remoto e fica disponível para uso. Quando o parâmetro EnhancedStatusCodesEnabled é definido como $False, a palavra-chave ENHANCEDSTATUSCODES EHLO não é anunciada na resposta de EHLO ao servidor remoto e fica desabilitada. A extensão ENHANCEDSTATUSCODES fornece informações avançadas de erro e status nas notificações de status de entrega que são enviadas para servidores remotos.

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:

  • No banner SMTP padrão do conector de recebimento.

  • Na resposta EHLO/HELO do conector de recebimento.

  • No campo de cabeçalho Received: mais recente da mensagem de entrada quando a mensagem entra no servidor de Transporte de Hub ou de Transporte de Borda.

  • Durante a autenticação TLS

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.

LongAddressesEnabled

Opcional

System.Boolean

Esse parâmetro permite que o conector de recebimento aceite endereços de email X.400 longos. Os endereços de email X.400 são encapsulados em endereços de email SMTP com o método de encapsulamento IMCEA (Endereço encapsulado do conector de email da Internet).

Quando o valor desse parâmetro for $False, o comprimento máximo de um endereço de email SMTP completo será de 571 caracteres.

Quando o valor desse parâmetro for $True, serão executadas as seguintes alterações:

  • A palavra-chave XLONGADDR é anunciada na resposta de EHLO do conector de recebimento.

  • O comprimento de linha aceito de uma sessão SMTP é aumentado em 8.000 caracteres.

  • Endereços longos válidos são aceitos pelo MAIL FROM: e RCPT TO: Comandos SMTP.

Portanto, os endereços de email X.400 podem ter até 1.860 caracteres de comprimento após o encapsulamento IMCEA.

O intervalo de entrada válido para esse parâmetro é $True ou $False. O valor padrão é $False. Só é possível modificar esse parâmetro em conectores de recebimento que estejam configurados em servidores de Transporte de Hub.

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 é 65536 bytes. Quando você inserir um valor, qualifique-o com uma das seguintes unidades:

  • B (bytes)

  • KB (quilobytes)

  • MB (megabytes)

  • GB (gigabytes)

Valores não qualificados são tratados como bytes. O intervalo de entrada válido para esse parâmetro é de 1 a 2147483647 bytes.

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 número máximo de saltos é determinado pelo número de cabeçalhos Received: em uma mensagem enviada. O valor padrão é 30. O intervalo de entrada válido para esse parâmetro é de 1 a 500.

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 é 5000. O intervalo de entrada válido para esse parâmetro é de 1 a 2147483647. Para desabilitar o limite de conexão de entrada em um conector de recebimento, insira um valor de unlimited.

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 1 a 100.

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 é 100. O intervalo de entrada válido para esse parâmetro é de 1 a 10000. Para desabilitar o limite de conexão de entrada por origem em um conector de recebimento, insira um valor de unlimited.

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 número máximo de saltos locais é determinado pelo número de cabeçalhos Received: com endereços de servidor local em uma mensagem enviada. O valor padrão é 8. O intervalo de entrada válido para esse parâmetro é de 0 a 50. Ao especificar um valor de 0, a mensagem será rejeitada se o SMTP detectar um salto local. Por exemplo, a mensagem será rejeitada se o SMTP detectar um único cabeçalho com o nome do servidor local. Isso acontece porque 0 não é considerado um valor infinito. Portanto, o SMTP enxerga somente o primeiro endereço de servidor ao tentar executar a conversão.

Dica

Quando você atualiza um servidor de Transporte de Hub ou servidor de Transporte de Borda para o Exchange 2007 Service Pack 1 (SP1), o valor do parâmetro MaxLocalHopCount é 8 para todos os conectores de recebimento existentes que possuam um valor de MaxLocalHopCount superior a 1.

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 é 3. O intervalo de entrada válido para esse parâmetro é de 0 a 10. Quando você especificar um valor igual a 0, a conexão nunca será fechada devido a falhas de logon.

MaxMessageSize

Opcional

Microsoft.Exchange.Data.ByteQuantifiedSize

Esse parâmetro especifica o tamanho máximo de uma mensagem. O valor padrão é 10MB. Quando você inserir um valor, qualifique-o com uma das seguintes unidades:

  • B (bytes)

  • KB (quilobytes)

  • MB (megabytes)

  • GB (gigabytes)

Inteiros não qualificados são tratados como bytes. O intervalo de entrada válido desse parâmetro é de 65.536 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 é 5. O intervalo de entrada válido para esse parâmetro é de 0 a 2147483647. Quando você especificar um valor unlimited, uma conexão nunca será fechada devido a erros de protocolo.

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 é 200. O intervalo de entrada válido para esse parâmetro é de 1 a 512000.

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 é unlimited. O valor padrão de um conector de recebimento configurado em um servidor de Transporte de Borda é de 600 mensagens por minuto. O intervalo de entrada válido para esse parâmetro é de 1 a 2147483647. Para remover o limite de taxa de mensagens em um conector de recebimento, insira um valor unlimited.

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: New Receive Connector.

OrarEnabled

Opcional

System.Boolean

Esse parâmetro habilita o ORAR (Destinatário alternativo solicitado pelo remetente). Quando o valor desse parâmetro for $False, o ORAR não será aceito. Quando o valor desse parâmetro for $True, o ORAR será aceito, anunciando-se a palavra-chave XORAR na resposta de EHLO do conector de recebimento. As informações reais do ORAR são transmitidas no RCPT TO: Comando SMTP.

O intervalo de entrada válido para esse parâmetro é $True ou $False. O valor padrão é $False. Se o endereço de email especificado nas informações do ORAR for um endereço de email X.400 longo, o parâmetro LongAddressesEnabled deverá ser $True.

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: None, AnonymousUsers, ExchangeUsers, ExchangeServers, ExchangeLegacyServers e Partners. Os grupos de permissões padrão que são atribuídos a um conector de recebimento dependem do tipo de uso especificado pelo parâmetro Usage quando o conector de recebimento foi criado. Para obter mais informações sobre tipos de uso do conector de recebimento, consulte Conectores de Recebimento.

PipeliningEnabled

Opcional

System.Boolean

Os valores válidos para esse parâmetro são $True ou $False. O valor padrão é $True. Quando o parâmetro PipeliningEnabled é definido como $True, a palavra-chave PIPELINING EHLO é anunciada na resposta de EHLO ao servidor remoto e fica disponível para uso. Quando o parâmetro PipeliningEnabled é definido como $False, a palavra-chave PIPELINING EHLO não é anunciada na resposta de EHLO ao servidor remoto e fica desabilitada. A extensão PIPELINING habilita o servidor remoto para enviar solicitações sem aguardar uma resposta do conector de recebimento.

ProtocolLoggingLevel

Opcional

Microsoft.Exchange.Data.ProtocolLoggingLevel

Esse parâmetro habilita ou desabilita o log de protocolos do conector de recebimento especificado. Um valor de Verbose habilita o log de protocolo para o conector. Um valor de None desabilita o log de protocolo para o conector. O valor padrão é None. O local do protocolo do conector de recebimento registra todos os conectores de recebimento configurados em um servidor de Transporte de Hub ou um servidor de Transporte de Borda é especificado com o parâmetro ReceiveProtocolLogPath do cmdlet Set-TransportServer.

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 192.168.1.1-192.168.1.10. Você pode especificar vários intervalos de endereços IP separados por vírgulas.

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 $True ou $False. O valor padrão é $False. Quando o parâmetro RequireEHLODomain é definido como $True, o computador remoto deve fornecer um nome de domínio no handshake do EHLO depois que a conexão SMTP é estabelecida. Se o computador remoto não fornecer o nome de domínio, a conexão SMTP será fechada.

RequireTLS

Opcional

System.Boolean

Os valores válidos para esse parâmetro são $True ou $False. O valor padrão é $False. Quando o parâmetro RequireTLS for definido como $True, todas as mensagens recebidas por esse conector exigirão transmissão TLS.

SizeEnabled

Opcional

Microsoft.Exchange.Data.SizeMode

Os valores válidos para esse parâmetro são Enabled, Disabled ou EnabledwithoutValue. O valor padrão é Enabled. Quando o parâmetro SizeEnabled estiver definido como Enabled, a extensão SIZE SMTP ficará habilitada e o valor máximo permitido de mensagem do parâmetro MaxMessageSize será publicado na faixa EHLO. Quando o parâmetro SizeEnabled estiver definido como Disabled, a extensão SIZE SMTP não será usada e o valor máximo permitido da mensagem não será divulgado para o servidor remoto. Quando o parâmetro SizeEnabled estiver definido como EnabledWithoutValue, a extensão SIZE SMTP ficará habilitada, mas o valor máximo permitido de mensagem do parâmetro MaxMessageSize será publicado na faixa EHLO. Isso permite que a mensagem ignore as verificações de tamanho de mensagem para as conexões entre servidores de Transporte de Hub. A extensão SMTP SIZE está definida no RFC 1870. SIZE permite que o servidor de origem declare o tamanho da mensagem de entrada para o servidor de destino. Permite também que o servidor de destino declare o tamanho máximo de mensagem permitido a ser aceito para o servidor de envio. Se o tamanho informado da mensagem de entrada exceder o valor especificado no parâmetro MessageSizeMax, o conector de recebimento responderá ao servidor remoto, usando um código de erro e fechará a conexã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 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 00:00:00 a 00:10:00. Ao definir o valor como 00:00:00, você desabilita o intervalo de tarpitting.

WhatIf

Opcional

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

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