Partilhar via

Set-SendConnector (RTM)

  • Artigo

 

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

Tópico modificado em: 2007-08-27

Use o cmdlet Set-SendConnector para modificar um conector de envio em um computador em que a função de servidor Transporte de Hub ou de Transporte de Borda esteja instalada.

Sintaxe

Set-SendConnector -Identity <SendConnectorIdParameter> [-AddressSpaces <MultiValuedProperty>] [-AuthenticationCredential <PSCredential>] [-Comment <String>] [-ConnectionInactivityTimeOut <EnhancedTimeSpan>] [-DNSRoutingEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-ForceHELO <$true | $false>] [-Fqdn <Fqdn>] [-IgnoreSTARTTLS <$true | $false>] [-LinkedReceiveConnector <ReceiveConnectorIdParameter>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-Port <Int32>] [-ProtocolLoggingLevel <None | Verbose>] [-RequireTLS <$true | $false>] [-SmartHostAuthMechanism <None | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-SmartHosts <MultiValuedProperty>] [-SourceIPAddress <IPAddress>] [-SourceTransportServers <MultiValuedProperty>] [-UseExternalDNSServersEnabled <$true | $false>]

Set-SendConnector [-AddressSpaces <MultiValuedProperty>] [-AuthenticationCredential <PSCredential>] [-Comment <String>] [-ConnectionInactivityTimeOut <EnhancedTimeSpan>] [-DNSRoutingEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-ForceHELO <$true | $false>] [-Fqdn <Fqdn>] [-IgnoreSTARTTLS <$true | $false>] [-Instance <SmtpSendConnectorConfig>] [-LinkedReceiveConnector <ReceiveConnectorIdParameter>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-Port <Int32>] [-ProtocolLoggingLevel <None | Verbose>] [-RequireTLS <$true | $false>] [-SmartHostAuthMechanism <None | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-SmartHosts <MultiValuedProperty>] [-SourceIPAddress <IPAddress>] [-SourceTransportServers <MultiValuedProperty>] [-UseExternalDNSServersEnabled <$true | $false>]

Descrição detalhada

O cmdlet Set-SendConnector modifica um conector de envio existente. O parâmetro Name é necessário quando você executa o cmdlet Set-SendConnector. O parâmetro Identity é necessário somente quando você modifica o valor do parâmetro Name.

Depois que você concluir essa tarefa, o conector de envio será modificado.

Para executar o cmdlet Set-SendConnector, você deve usar uma conta à qual esteja delegada a função de Administrador do Exchange Server e o grupo Administradores local do servidor de destino.

Para executar o cmdlet Set-SendConnector 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

Identidade

Necessário

Microsoft.Exchange.Configuration.Tasks.SendConnectorIdParameter

O parâmetro Identity especifica a GUID ou o nome de conector que representa o conector de envio que você deseja modificar.

AddressSpaces

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro é necessário, a não ser que esse conector esteja vinculado a um conector de recebimento. Se um conector de recebimento vinculado for especificado usando-se o parâmetro LinkedReceiveConnector, o valor de AddressSpaces deverá ser $null. Caso contrário, o parâmetro AddressSpaces irá especificar os nomes de domínio para os quais o conector de envio envia mensagens. Você pode especificar vários espaços de endereçamento, separando-os por vírgulas. A sintaxe completa para inserir cada espaço de endereçamento é a seguinte:

<ConnectorScope>:<AddressSpaceType>:<AddressSpace>;<AddressSpaceCost>

  • ConnectorScope   Se você especificar um valor de Local, o conector poderá ser usado apenas por outros servidores de Transporte de Hub existentes no mesmo site do Active Directory que o servidor de Transporte de Hub de origem no qual você está executando o cmdlet New-SendConnector. Se você omitir o qualificador ConnectorScope, o conector poderá ser usado por todos os servidores de Transporte de Hub existentes em toda a organização do Exchange 2007.

  • AddressSpaceType   Para espaços de endereçamento SMTP, esse valor deve ser SMTP. Para espaços de endereçamento não-SMTP, esse valor deve ser qualquer cadeia de caracteres de texto descritiva, como "Lotus Notes".

  • AddressSpace   Para espaços de endereçamento SMTP, pode ser usado o caractere curinga (*) do DNS (sistema de nome de domínio), conforme definido no RFC 1035. Por exemplo, você pode usar "*", "*.com." ou *.contoso.com". Para espaços de endereçamento não-SMTP, você pode usar caracteres curinga (*) e outros caracteres, como "*contoso.com" ou "@contoso".

  • AddressSpaceCost   O intervalo de entrada válido para o custo é de 1 a 100. Um custo mais baixo indica uma rota melhor. Este parâmetro é opcional. Se você omitir o qualificador AddressSpaceCost ao inserir um espaço de endereçamento usando a sintaxe completa, será usado um custo 1.

Você só precisa usar a sintaxe completa para o parâmetro AddressSpaces para as seguintes condições:

  • Conectores do escopo que tenham o qualificador Local

  • Espaços de endereçamento não SMTP

  • Espaços de endereçamento SMTP com custo diferente de 1

Se você digitar um nome de domínio ou uma lista de nomes de domínio separada por vírgulas para o valor do parâmetro AddressSpaces, o tipo de SMTP do espaço de endereçamento e um custo de conector 1 serão assumidos para cada nome de domínio. Os conectores de envio que são configurados em servidores de Transporte de Borda só oferecem suporte a espaços de endereçamento SMTP. Os conectores de envio que são configurados nos servidores de Transporte de Hub oferecem suporte a espaços de endereçamento SMTP e não-SMTP.

AuthenticationCredential

Optional

System.Management.Automation.PSCredential

Esse parâmetro exige a criação e a passagem de um objeto de credencial. Esse objeto de credencial é criado com o cmdlet Get-Credential. Para obter mais informações sobre o cmdlet Get-Credential, digite Get-Help Get-Credential no Shell de Gerenciamento do Exchange.

Comment

Optional

System.String

O parâmetro Comment deve ficar entre aspas duplas, por exemplo: "this is an admin note".

ConnectionInactivityTimeOut

Optional

Microsoft.Exchange.Data.EnhancedTimeSpan

Esse parâmetro especifica o tempo máximo que uma conexão ociosa pode permanecer aberta. O valor padrão é 10 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 intervalo de entrada válido para esse parâmetro é 00:00:01 a 1.00:00:00.

DNSRoutingEnabled

Optional

System.Boolean

Esse parâmetro especifica se o roteamento de DNS (Sistema de Nome de Domínio) deve ser usado ou se todas as mensagens devem ser enviadas pelo host inteligente que é configurado com o parâmetro SmartHosts. O valor padrão é $True. Se desejar definir o valor como $False, você deve primeiro definir um valor no parâmetro SmartHosts.

DomainController

Optional

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

Optional

System.Boolean

Esse parâmetro é parte do processo para habilitar a autenticação TLS (Transport Layer Security) mútua dos domínios que são atendidos pelo conector de envio. A autenticação TLS mútua funcionará corretamente somente se as seguintes condições forem atendidas:

  • O valor do parâmetro DomainSecureEnabled deve ser $True.

  • O valor do parâmetro DNSRoutingEnabled deve ser $True.

  • O valor do parâmetro IgnoreStartTLS deve ser $False.

O caractere curinga (*) não tem suporte em domínios configurados para autenticação mútua de TLS. O mesmo domínio também deve ser definido no conector de recebimento correspondente e no valor do parâmetro TLSReceiveDomainSecureList no cmdlet Get-TransportConfig.

O valor padrão de DomainSecureEnabled é $False para os tipos de conectores de envio a seguir:

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

  • Os conectores de envio criados pelo usuário que são definidos em um servidor de Transporte de Borda.

O valor padrão de DomainSecureEnabled é $True para os seguintes tipos de conectores de envio:

  • Os conectores de envio padrão que são definidos em um servidor de Transporte de Borda.

Enabled

Optional

System.Boolean

A entrada válida para esse parâmetro é $True ou $False. O valor padrão é $True. Use o parâmetro Enabled para habilitar ou desabilitar a capacidade do conector processar mensagens de email.

Force

Optional

System.Management.Automation.SwitchParameter

Esse parâmetro suprime as mensagens de aviso ou de confirmação exibidas durante alterações específicas na configuração.

ForceHELO

Optional

System.Boolean

A entrada válida para esse parâmetro é $True ou $False. O valor padrão é $False. Por padrão, EHLO é usado. Se esse parâmetro for definido como $True, HELO será enviado em vez de EHLO.

Fqdn

Optional

Microsoft.Exchange.Data.Fqdn

Esse parâmetro especifica o FQDN usado como o servidor de origem para servidores de mensagens conectados que usam o conector de envio para receber mensagens de saída. O valor desse parâmetro é exibido para servidores de mensagens conectados sempre que um nome de servidor de origem é exigido, como nos exemplos a seguir:

  • No comando EHLO/HELO, quando o conector de envio se comunica com o servidor de mensagens do próximo salto

  • No campo de cabeçalho Received: mais recente da mensagem que é adicionado pelo servidor de mensagens do próximo salto depois que a mensagem sai do servidor de Transporte de Hub ou de Transporte de Borda

  • Durante a autenticação TLS

O valor padrão do parâmetro Fqdn é $Null. Isso significa que o valor padrão real de FQDN é o FQDN do servidor de Transporte de Hub ou de Transporte de Borda que contém o conector de envio.

Dica

Se o conector de envio estiver configurado em um servidor de Transporte de Hub que também tenha a função de servidor Caixa de Correio instalada, nenhum valor especificado para o parâmetro Fqdn será usado. Em vez disso, será usado sempre o FQDN do servidor que é exibido com o cmdlet Get-ExchangeServer.
Para servidores que possuem as funções de servidor Transporte de Hub e Caixa de Correio instaladas, a única maneira de remover o nome do servidor dos cabeçalhos Received: da mensagem de saída é usar o cmdlet Remove-ADPermission para remover a permissão Ms-Exch-Send-Headers-Routing das entidades de segurança que usam o conector. Essa ação removerá todos os cabeçalhos Received: da mensagem quando ela deixar o servidor de Transporte de Hub. Recomendamos que você não remova os cabeçalhos Received: de mensagens internas, porque eles são usados para cálculos de contagem de número máximo de saltos. Para obter mais informações sobre os cmdlets Remove-ADPermission e Get-ExchangeServer, consulte os seguintes tópicos:
• Remove-ADPermission (RTM)
• Get-ExchangeServer (RTM)

IgnoreSTARTTLS

Optional

System.Boolean

A entrada válida para esse parâmetro é $True ou $False. Esse parâmetro especifica se a opção StartTLS oferecida por um servidor de envio remoto deve ser ignorada. Esse parâmetro é usado com domínios remotos. Esse parâmetro deverá ser definido como $False se o parâmetro RequireTLS estiver definido como $True. Por padrão, um conector de envio com o valor do parâmetro DNSRoutingEnabled definido como $True também tem o valor do parâmetro IgnoreStartTLS definido como $False. Isso significa que o conector de envio sempre negociará o TLS se o TLS for oferecido pelo servidor de recebimento. Se você definir o valor do parâmetro IgnoreStartTLS como $True, o conector de envio nunca tentará negociar o TLS com o servidor de recebimento.

Instance

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.SmtpSendConnectorConfig

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.

LinkedReceiveConnector

Optional

Microsoft.Exchange.Configuration.Tasks.ReceiveConnectorIdParameter

Esse parâmetro força todas as mensagens que foram recebidas pelo conector de recebimento especificado enviadas por esse conector de envio. O valor de LinkedReceivedConnector pode usar qualquer um dos identificadores a seguir para especificar o conector de recebimento:

  • GUID

  • DN (nome distinto)

  • Servername\ConnectorName

Quando você usar o parâmetro LinkReceiveConnector com o cmdlet Set-SendConnector, deverá também usar os seguintes parâmetros com os valores especificados:

  • AddressSpaces $null

  • DNSRoutingEnabled $False

  • MaxMessageSize unlimited

  • Smarthosts <SmarthostID>

  • SmarthostAuthMechanism <AuthMechanism>

MaxMessageSize

Optional

Microsoft.Exchange.Data.Unlimited

Esse parâmetro especifica o tamanho máximo de uma mensagem que pode passar por um conector. 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)

Os valores não qualificados são considerados bytes. O intervalo de entrada válido para esse parâmetro é de 0 a 2147483647 bytes. Para remover o limite de tamanho de mensagens em um conector de envio, digite um valor unlimited.

Name

Optional

System.String

O parâmetro Name é o nome do conector, fornecido pelo administrador. Se o nome contiver espaços, você deverá colocar o parâmetro Name entre aspas duplas, como mostra o exemplo: "New Send Connector".

Port

Optional

System.Int32

O intervalo de entrada válido para esse parâmetro é um inteiro entre 0 e 65535. O valor padrão é 25. Se você especificar um valor no parâmetro SmartHosts, o valor de Port especificará o número da porta usada para o encaminhamento de host inteligente. Na maior parte das organizações, o número de porta é definido como 25.

ProtocolLoggingLevel

Optional

Microsoft.Exchange.Data.ProtocolLoggingLevel

Esse parâmetro habilita ou desabilita o log de protocolo para o conector de envio 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 dos logs de protocolo do conector de envio para todos os conectores de envio que são configurados em um servidor de Transporte de Hub ou em arquivos do servidor de Transporte de Borda é especificado usando o parâmetro SendProtocolLogPath do comando Set-TransportServer.

RequireTLS

Optional

System.Boolean

Esse parâmetro especifica se todas as mensagens enviadas por esse conector devem ser transmitidas por meio de TLS. O valor padrão é $False.

SmartHostAuthMechanism

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.SmtpSendConnectorConfig+AuthMechanisms

Esse parâmetro é usado durante a autenticação com um servidor remoto. Esse parâmetro é usado somente quando um host inteligente é configurado e o parâmetro DNSRoutingEnabled é definido como $False. Os valores válidos são None, BasicAuth, BasicAuthRequireTLS, ExchangeServer ou ExternalAuthoritative. Todos os valores são mutuamente exclusivos. Se você selecionar BasicAuth ou BasicAuthRequireTLS, deverá usar o parâmetro AuthenticationCredential para especificar a credencial de autenticação.

SmartHosts

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro aceita um ou mais FQDNs, como server.contoso.com, ou um ou mais endereços IP, separados por vírgulas. Se inserir um endereço IP, você deverá inseri-lo de forma literal, como no exemplo: 10.10.1.1. A identidade do host inteligente pode ser o FQDN de um servidor de host inteligente, um registro MX (troca de mensagens) ou um registro A (endereço). Se você configurar um FQDN como a identidade do host inteligente, o servidor de origem do conector de envio deverá estar apto a usar a resolução de nomes DNS para localizar o servidor host inteligente.

SourceIPAddress

Optional

System.Net.IPAddress

Esse parâmetro especifica o endereço IP local a ser usado como o ponto de extremidade para uma conexão SMTP a um servidor remoto de mensagens. O endereço IP padrão é 0.0.0.0. Esse valor determina que o servidor use qualquer endereço IP local disponível. Esse parâmetro é válido apenas para conectores de envio configurados nos servidores de Transporte de Borda.

SourceTransportServers

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro especifica os nomes dos servidores de Transporte de Hub que podem usar este conector de envio. Você pode especificar os nomes de mais de um servidor de Transporte de Hub, separando-os por vírgulas. Esse parâmetro não é válido para conectores de envio configurados nos servidores de Transporte de Borda.

UseExternalDNSServersEnabled

Optional

System.Boolean

Esse parâmetro especifica se esse conector de envio deve usar a lista de DNS externo especificada com o parâmetro ExternalDNSServers do cmdlet Set-TransportServer. O valor padrão é $False. Os valores válidos desse parâmetro são $True e $False.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

 

Exemplo

O primeiro exemplo de código mostra um comando Set-SendConnector que modifica um conector de envio existente. O comando define o limite de MaxMessageSize como 10 MB e de ConnectionInactivityTimeOut como 15 minutos.

O segundo exemplo mostra os comandos que modificam um conector de envio existente para usar a autenticação quando o conector de envio manda uma mensagem de email para Contoso.com. O servidor de email de Contoso.com exige que o servidor Exchange Server 2007 local faça a autenticação com ele para enviar mensagens de email. Para configurar o conector de envio para usar autenticação, você deve primeiro executar o comando Get-Credential e atribuir o comando a uma variável. Quando você executar o comando Get-Credential, ele solicitará o nome de usuário e a senha da conta que será usada durante a autenticação com o servidor de email de Contoso.com.

No exemplo, o comando Get-Credential é atribuído à variável $CredentialObject. Depois que as credenciais de autenticação são atribuídas à variável $CredentialObject, o conector de envio pode ser modificado com o cmdlet Set-SendConnector. A variável $CredentialObject é passada ao parâmetro AuthenticationCredential. Além de definir as credenciais que serão usadas, você deve definir o parâmetro SmartHostAuthMechanism como BasicAuth para instruir o conector de envio a realizar a autenticação com o servidor de email de Contoso.com usando as credenciais fornecidas.

Set-SendConnector "Contoso.com Send Connector" -MaxMessageSize 10MB -ConnectionInactivityTimeOut 00:15:00 
$CredentialObject = Get-Credential
Set-SendConnector "E-Mail to Contoso.com" -AuthenticationCredential $CredentialObject -SmartHostAuthMechanism BasicAuth