Compartilhar via


New-SendConnector

 

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

Tópico modificado em: 2007-09-05

Use o cmdlet New-SendConnector para criar um novo conector de envio 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-SendConnector -Name <String> -AddressSpaces <MultiValuedProperty> [-AuthenticationCredential <PSCredential>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ConnectionInactivityTimeOut <EnhancedTimeSpan>] [-Custom <SwitchParameter>] [-DNSRoutingEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-ForceHELO <$true | $false>] [-Fqdn <Fqdn>] [-IgnoreSTARTTLS <$true | $false>] [-Internal <SwitchParameter>] [-Internet <SwitchParameter>] [-IsScopedConnector <$true | $false>] [-MaxMessageSize <Unlimited>] [-Partner <SwitchParameter>] [-Port <Int32>] [-ProtocolLoggingLevel <None | Verbose>] [-RequireTLS <$true | $false>] [-SmartHostAuthMechanism <None | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-SmartHosts <MultiValuedProperty>] [-SourceIPAddress <IPAddress>] [-SourceTransportServers <MultiValuedProperty>] [-TemplateInstance <PSObject>] [-Usage <Custom | Internal | Internet | Partner>] [-UseExternalDNSServersEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]

New-SendConnector -Name <String> [-AuthenticationCredential <PSCredential>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ConnectionInactivityTimeOut <EnhancedTimeSpan>] [-Custom <SwitchParameter>] [-DNSRoutingEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-ForceHELO <$true | $false>] [-Fqdn <Fqdn>] [-IgnoreSTARTTLS <$true | $false>] [-Internal <SwitchParameter>] [-Internet <SwitchParameter>] [-LinkedReceiveConnector <ReceiveConnectorIdParameter>] [-MaxMessageSize <Unlimited>] [-Partner <SwitchParameter>] [-Port <Int32>] [-ProtocolLoggingLevel <None | Verbose>] [-RequireTLS <$true | $false>] [-SmartHostAuthMechanism <None | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-SmartHosts <MultiValuedProperty>] [-SourceIPAddress <IPAddress>] [-SourceTransportServers <MultiValuedProperty>] [-TemplateInstance <PSObject>] [-Usage <Custom | Internal | Internet | Partner>] [-UseExternalDNSServersEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

Esse cmdlet cria um novo conector de envio. Para que sejam solicitados os parâmetros necessários de um novo conector de envio, digite New-SendConnector. Depois que essa tarefa for concluída, o conector de envio será criado.

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

Para executar o cmdlet New-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(s) Tipo Descrição

AddressSpaces

Necessário(s)

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 do parâmetro AddressSpaces deverá ser $null. Caso contrário, o parâmetro AddressSpaces especificará os nomes de domínio para os quais o Conector de Envio envia mensagens. A sintaxe completa para inserir cada espaço de endereçamento é a seguinte: <AddressSpaceType>:<AddressSpace>;<AddressSpaceCost>

  • AddressSpaceType   Em um servidor de Transporte de Borda, o tipo de espaço de endereçamento deve ser SMTP. Em um servidor de Transporte de Hub, o tipo de espaço de endereçamento pode ser SMTP, X400 ou qualquer outra cadeia de caracteres de texto. Se você omitir o tipo de espaço de endereçamento, será usado o tipo de espaço de endereçamento SMTP.

  • AddressSpace   Para tipos de espaço de endereçamento SMTP, o espaço de endereçamento que você inserir deve ser compatível com RFC 1035. Por exemplo, *, *.com e *.contoso.com são permitidos, mas *contoso.com não é permitido. Para tipos de espaço de endereçamento X.400, o espaço de endereçamento que você inserir deverá ser compatível com RFC 1685, como o=MySite;p=MyOrg;a=adatum;c=us. Para todos os outros valores de tipo de endereço, você pode inserir qualquer texto para o espaço de endereçamento.

  • 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 custo do espaço de endereçamento, será usado um custo de 1. Se você inserir um espaço de endereçamento não SMTP que contenha o caractere de ponto-e-vírgula, (;), será necessário especificar o custo do espaço de endereçamento.

Se você especificar o tipo de espaço de endereçamento ou o custo do espaço de endereçamento, deverá colocar o espaço de endereçamento entre aspas duplas ( " ). Por exemplo, as entradas de espaço de endereçamento a seguir são equivalentes:

  • "SMTP:contoso.com;1"

  • "contoso.com;1"

  • "SMTP:contoso.com"

  • contoso.com

Você pode especificar vários espaços de endereçamento, separando-os por vírgulas, como no exemplo a seguir: contoso.com,fabrikam.com. Se você especificar o tipo de espaço de endereçamento ou o custo do espaço de endereçamento, deverá colocar o espaço de endereçamento entre aspas duplas ( " ), como no exemplo a seguir: "contoso.com;2","fabrikam.com;3".

Se você especificar um tipo de espaço de endereçamento que não seja SMTP em um Conector de Envio configurado em um servidor de Transporte de Hub, as seguintes configurações serão necessárias no Conector de Envio.

  • É necessário usar um host inteligente para rotear emails, especificando um valor para o parâmetro SmartHosts.

  • Você deve definir o parâmetro DNSRoutingEnabled como $False.

Dica

Embora seja possível configurar espaços de endereçamento que não sejam SMTP em um conector de envio de um servidor de Transporte de Hub, o conector de envio usa SMTP como o mecanismo de transporte para enviar mensagens a outros servidores de mensagens. Os conectores externos em servidores de Transporte de Hub são usados para envio de mensagens para servidores de mensagens locais, como servidores de gateway de fax de terceiros, que não usem SMTP como o mecanismo de transporte principal. Para obter mais informações, consulte Conectores estrangeiros

Name

Necessário(s)

System.String

Esse parâmetro é 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".

AuthenticationCredential

Opcional

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

Opcional

System.String

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

Confirm

Optional

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 o tempo máximo que uma conexão ociosa pode permanecer aberta. O valor padrão é 10 minutos. Para especificar um valor, digite 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 é de 00:00:01 a 1.00:00:00.

Custom

Optional

System.Management.Automation.SwitchParameter

Esse parâmetro especifica o tipo de uso Custom. O tipo de uso especifica as permissões e os métodos de autenticação atribuídos ao conector de envio. Se você usar o parâmetro Custom, não poderá usar nenhum dos parâmetros a seguir:

  • Internal

  • Internet

  • Partner

  • Usage

Para obter mais informações sobre tipos de uso de conector de envio, permissões e métodos de autenticação, consulte Conectores de Envio.

DNSRoutingEnabled

Opcional

System.Boolean

Os valores válidos para o parâmetro DnsRoutingEnabled são $True ou $False. O valor padrão é $True. Se você especificar um parâmetro SmartHosts, o parâmetro DnsRoutingEnabled deverá ser $False na mesma linha de comando.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar o nome de domínio totalmente qualificado (FQDN) 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 é 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 verdadeiras:

  • O valor do parâmetro DomainSecureEnabled está definido como $True.

  • O valor do parâmetro DNSRoutingEnabled está definido como $True.

  • O valor do parâmetro IgnoreStartTLS está definido como $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.

  • Conectores de envio criados pelo usuário definidos em um servidor de Transporte de Borda

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

  • Conectores de envio padrão definidos em um servidor de Transporte de Borda

Enabled

Opcional

System.Boolean

Os valores válidos para este parâmetro são $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

Opcional

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

Opcional

System.Boolean

Os valores válidos para este parâmetro são $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

Opcional

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
Get-ExchangeServer

IgnoreSTARTTLS

Opcional

System.Boolean

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. Os valores válidos para esse parâmetro são $True e $False.

Internal

Optional

System.Management.Automation.SwitchParameter

Esse parâmetro especifica o tipo de uso Internal. O tipo de uso especifica as permissões e os métodos de autenticação atribuídos ao conector de envio. Se você usar o parâmetro Internal, não poderá usar nenhum dos parâmetros a seguir:

  • Custom

  • Internet

  • Partner

  • Usage

Para obter mais informações sobre tipos de uso de conector de envio, permissões e métodos de autenticação, consulte Conectores de Envio.

Internet

Optional

System.Management.Automation.SwitchParameter

Esse parâmetro especifica o tipo de uso Internet. O tipo de uso especifica as permissões e os métodos de autenticação atribuídos ao conector de envio. Se você usar o parâmetro Internet, não poderá usar nenhum dos parâmetros a seguir:

  • Custom

  • Internal

  • Partner

  • Usage

Para obter mais informações sobre tipos de uso de conector de envio, permissões e métodos de autenticação, consulte Conectores de Envio.

IsScopedConnector

Optional

System.Boolean

Esse parâmetro controla a disponibilidade do conector para outros servidores de Transporte de Hub. Quando o valor desse parâmetro for $False, o conector poderá ser usado por todos os servidores de Transporte de Hub da organização do Exchange. Quando o valor desse parâmetro for $True, o conector poderá ser usado apenas pelos servidores de Transporte de Hub do mesmo site do Active Directory. O valor padrão é $False.

LinkedReceiveConnector

Opcional

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

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

  • DNSRoutingEnabled $False

  • MaxMessageSize unlimited

  • Smarthosts <SmarthostID>

  • SmarthostAuthMechanism <AuthMechanism>

Ao usar o parâmetro LinkedReceiveConnector, você não deverá usar o parâmetro AddressSpace.

MaxMessageSize

Opcional

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 (kilobytes)

  • MB (megabytes)

  • GB (gigabytes)

Valores não qualificados são tratados como bytes. Valores inseridos em bytes são arredondados para o quilobyte mais próximo. Por exemplo, 1048575B é arredondado para 1MB, e 1048577 é arredondado para 1025KB. O intervalo de entrada válido para esse parâmetro é de 0 a 2147483647bytes. Para remover o limite de tamanho de mensagens em um conector de envio, digite um valor unlimited.

Partner

Optional

System.Management.Automation.SwitchParameter

Esse parâmetro especifica o tipo de uso Partner. O tipo de uso especifica as permissões e os métodos de autenticação atribuídos ao conector de envio. Se você usar o parâmetro Partner, não poderá usar nenhum dos parâmetros a seguir:

  • Custom

  • Internal

  • Internet

  • Usage

Para obter mais informações sobre tipos de uso de conector de envio, permissões e métodos de autenticação, consulte Conectores de Envio.

Port

Opcional

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

Opcional

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 local dos logs de protocolo do conector de envio para todos os conectores de envio configurados em um servidor de Transporte de Hub ou de Transporte de Borda é especificado por meio do parâmetro SendProtocolLogPath do cmdlet Set-TransportServer.

RequireTLS

Opcional

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

Opcional

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 e 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

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro é necessário se você definir o parâmetro DnsRoutingEnabled como $False, e deve ser especificado na mesma linha de comando. O parâmetro SmartHosts aceita um ou mais FQDNs, como server.contoso.com, ou um ou mais endereços IP, ou uma combinação de FQDNs e endereços IP. Separe cada valor com uma vírgula. 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

Opcional

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 em 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

Opcional

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.

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.NewSendConnector+UsageType

Este parâmetro pode ser usado para especificar as permissões e os métodos de autenticação padrão que são atribuídos ao Conector de Envio. Os valores válidos para esse parâmetro são os seguintes: Custom, Internal, Internet ou Partner. Se você não especificar um valor para o parâmetro Usage, o tipo de uso aplicará o padrão Custom.

Se você usar o parâmetro Usage, não poderá usar nenhum dos parâmetros a seguir:

  • Custom

  • Internal

  • Internet

  • Partner

Para obter mais informações sobre tipos de uso de conector de envio, permissões e métodos de autenticação, consulte Conectores de Envio.

UseExternalDNSServersEnabled

Opcional

System.Boolean

Esse parâmetro especifica se esse conector de envio deve usar a lista de DNS externo especificada que é 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.

WhatIf

Optional

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 primeiro exemplo mostra o comando que cria um novo conector de envio, que envia mensagens de email pela Internet. O exemplo mostra os parâmetros mínimos necessários para criar um conector de envio. O espaço de endereçamento está restrito para enviar mensagens apenas para os domínios Contoso.com e Microsoft.com.

O segundo exemplo mostra os comandos que criam um novo conector de envio que envia mensagens de email para Contoso.com. O servidor de email de Contoso.com requer que o servidor Exchange 2007 local faça autenticação com ele para enviar mensagens de email. Para configurar o conector de envio para usar autenticação, você deve primeiramente executar o comando Get-Credential e atribuí-lo 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 segundo exemplo, o cmdlet Get-Credential é atribuído à variável $CredentialObject. Depois que as credenciais de autenticação são atribuídas à variável $CredentialObject, o novo conector de envio pode ser criado, com o cmdlet New-SendConnector. A variável $CredentialObject é passada ao parâmetro AuthenticationCredential. Além de definir as credenciais, o parâmetro SmartHostAuthMechanism deve ser definido 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.

New-SendConnector -Name Test -AddressSpaces contoso.com,microsoft.com
$CredentialObject = Get-Credential
New-SendConnector -Name "Secure E-Mail to Contoso.com" -AddressSpaces contoso.com -AuthenticationCredential $CredentialObject -SmartHostAuthMechanism BasicAuth