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 |
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: |
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 |
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 |
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 |
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 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 O intervalo de entrada válido para esse parâmetro é |
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. |
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 Quando o valor desse parâmetro for
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 é |
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 é
Valores não qualificados são tratados como 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 número máximo de saltos é determinado pelo número de cabeçalhos |
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 número máximo de saltos locais é determinado pelo número de cabeçalhos 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 é |
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 é
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 é |
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: |
OrarEnabled |
Opcional |
System.Boolean |
Esse parâmetro habilita o ORAR (Destinatário alternativo solicitado pelo remetente). Quando o valor desse parâmetro for O intervalo de entrada válido para esse parâmetro é |
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 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 |
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