New-ReceiveConnector (RTM)
Aplica-se a: Exchange Server 2007 SP1, Exchange Server 2007
Tópico modificado em: 2007-07-23
Use o cmdlet New-ReceiveConnector para criar um novo conector de recebimento 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
New-ReceiveConnector -Name <String> [-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>] [-PermissionGroups <None | AnonymousUsers | ExchangeUsers | ExchangeServers | ExchangeLegacyServers | Partners | Custom>] [-PipeliningEnabled <$true | $false>] [-ProtocolLoggingLevel <None | Verbose>] [-RemoteIPRanges <MultiValuedProperty>] [-RequireEHLODomain <$true | $false>] [-RequireTLS <$true | $false>] [-Server <ServerIdParameter>] [-SizeEnabled <Disabled | Enabled | EnabledWithoutValue>] [-TarpitInterval <EnhancedTimeSpan>] [-TemplateInstance <PSObject>] [-Usage <Custom | Internet | Internal | Client | Partner>]
Descrição detalhada
O cmdlet New-ReceiveConnector cria um novo conector de recebimento. Para que sejam solicitados os parâmetros necessários de um novo conector de recebimento, digite New-ReceiveConnector. Os parâmetros Name, Bindings e RemoteIPRanges são os parâmetros necessários de um novo conector de recebimento.
Depois que essa tarefa for concluída, o conector de recebimento será criado.
Para executar o cmdlet New-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 New-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 Exchange Server 2007, consulte Considerações sobre permissão.
Parâmetros
Parâmetro | Necessário | Tipo | Descrição |
---|---|---|---|
Name |
Necessário |
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: " |
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:
Você deve especificar um valor para o parâmetro Bindings quando os seguintes valores para o parâmetro Usage forem especificados:
|
ChunkingEnabled |
Opcional |
System.Boolean |
A entrada válida para esse parâmetro é |
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, em que 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, em que 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 TLS mútua funcionará corretamente somente 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á. |
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 é Observação O número máximo de saltos é determinado pelo número de campos de cabeçalhos |
MaxInboundConnection |
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. O valor padrão é |
MaxInboundConnectionPercentagePerSource |
Opcional |
System.Int32 |
Esse parâmetro especifica o número máximo de conexões que um conector de recebimento serve simultaneamente de um único endereço IP, 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 é |
MaxInboundConnectionPerSource |
Opcional |
Microsoft.Exchange.Data.Unlimited |
Esse parâmetro especifica o número máximo de conexões 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 valor padrão é
Os valores não qualificados são considerados 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 |
Esse parâmetro 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 é |
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 em Você deve especificar um valor para o parâmetro RemoteIPRanges quando os seguintes valores para o parâmetro Usage forem especificados:
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 |
Server |
Opcional |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Esse parâmetro especifica o servidor no qual o novo conector de recebimento deve ser criado. |
SizeEnabled |
Opcional |
Microsoft.Exchange.Data.SizeMode |
Os valores válidos para esse parâmetro são |
TarpitInterval |
Opcional |
Microsoft.Exchange.Data.EnhancedTimeSpan |
Esse parâmetro especifica a quantidade 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: dd.hh:mm:ss, em que d = dias, h = horas, m = minutos e s = segundos. O intervalo de entrada válido para esse parâmetro é de |
TemplateInstance |
Opcional |
System.Management.Automation.PSObject |
Quando um objeto existente for fornecido a esse parâmetro, o comando usará a configuração desse objeto para criar uma cópia idêntica do objeto no servidor local ou de destino. |
Usage |
Opcional |
Microsoft.Exchange.Management.SystemConfigurationTasks.NewReceiveConnector+UsageType |
Esse parâmetro especifica os grupos de permissões padrão e os métodos de autenticação atribuídos a esse conector de recebimento. Os valores válidos para o parâmetro Usage são os seguintes: Será necessário um valor para o parâmetro Bindings se você especificar qualquer um dos seguintes valores para o parâmetro Usage:
Será necessário um valor para o parâmetro RemoteIPRanges se você especificar qualquer um dos seguintes valores para o parâmetro Usage:
Se você não especificar um valor para um parâmetro exigido, o comando será encerrado sem êxito. O cmdlet New-ReceiveConnector não avisará você sobre os parâmetros ausentes exigidos. Para obter mais informações sobre tipos de uso de conector de recebimento, grupos de permissões e métodos de autenticação, consulte Conectores de Recebimento. |
Tipos de entrada
Tipos de retorno
Erros
Erro | Descrição |
---|---|
|
|
Exemplo
Esse comando New-ReceiveConnector cria um novo conector de recebimento. O exemplo mostra os parâmetros mínimos necessários para criar um conector de recebimento.
Dica
Você não pode criar vários conectores de recebimento que compartilham parâmetros Bindings e RemoteIPRanges idênticos.
New-ReceiveConnector -Name Test -Bindings 10.10.1.1:25 -RemoteIPRanges 192.168.0.1-192.168.0.24