New-SendConnector

 

Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Última modificación del tema: 2007-09-05

Use el cmdlet New-SendConnector para crear un nuevo conector de recepción en un equipo que tenga instalada la función del servidor Transporte de concentradores o Transporte perimetral.

Sintaxis

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

Descripción detallada

Este cmdlet crea un nuevo conector de envío. Para que se le soliciten los parámetros necesarios de un nuevo conector de envío, escriba New-SendConnector. Una vez finalizada la tarea, se crea un conector de envío.

Para ejecutar el cmdlet New-SendConnector, se debe delegar la función Administrador de Exchange Server y el grupo local de administradores en la cuenta del servidor de destino.

Para ejecutar el cmdlet New-SendConnector en un equipo que tiene instalada la función del servidor Transporte perimetral, debe iniciar sesión mediante una cuenta que pertenezca al grupo local de administradores de dicho equipo.

Para obtener más información acerca de los permisos, la delegación de funciones y los derechos necesarios a fin de administrar Microsoft Exchange Server 2007, consulte Consideraciones sobre permisos.

Parámetros

Parámetro Necesario Tipo Descripción

AddressSpaces

Necesario

Microsoft.Exchange.Data.MultiValuedProperty

Se necesita este parámetro a no ser que este conector esté vinculado a un conector de recepción. Si se especifica un conector de recepción vinculado mediante el parámetro LinkedReceiveConnector, el valor del parámetro AddressSpaces debe ser $null. De lo contrario, el parámetro AddressSpaces especifica los nombres de dominio a los que envía mensajes el conector de envío. La sintaxis completa para escribir cada espacio de dirección es la siguiente: <AddressSpaceType>:<AddressSpace>;<AddressSpaceCost>

  • AddressSpaceType   En un servidor de transporte perimetral, el tipo de espacio de direcciones debe ser SMTP. En un servidor de transporte de concentradores, el tipo de espacio de direcciones puede ser SMTP, X400 u otra cadena de texto. Si omite el tipo de espacio de direcciones, se presupone un tipo de espacio de direcciones SMTP.

  • AddressSpace   Para los tipos de espacio de direcciones SMTP, el espacio de direcciones que escriba debe ser compatible con RFC 1035. Por ejemplo, *, *.com y *.contoso.com se permiten, pero *contoso.com no se permite. Para los tipos de espacio de direcciones X.400, el espacio de direcciones que escriba debe ser compatible con RFC 1685, como o=MySite;p=MyOrg;a=adatum;c=us. Para el resto de valores de tipo de dirección, puede introducir cualquier texto para el espacio de direcciones.

  • AddressSpaceCost   El intervalo de entrada válido para el costo va de 1 a 100. Un costo inferior indica una ruta mejor. Este parámetro es opcional. Si omite el costo de un espacio de direcciones, se asumirá un costo de 1. Si escribe un espacio de direcciones no SMTP que contenga un punto y coma ( ; ), deberá especificar el costo de un espacio de direcciones.

Si especifica el tipo de espacio de direcciones o el costo de un espacio de direcciones, el espacio de direcciones deberá aparecer entre comillas dobles ("). Por ejemplo, las siguientes entradas de espacio de direcciones son equivalentes:

  • "SMTP:contoso.com;1"

  • "contoso.com;1"

  • "SMTP:contoso.com"

  • contoso.com

Puede especificar varios espacios de direcciones separándolos con comas tal como se indica a continuación, por ejemplo: contoso.com,fabrikam.com. Si especifica el tipo de espacio de direcciones o el costo de un espacio de direcciones, el espacio de direcciones deberá aparecer entre comillas dobles ("), tal como se indica a continuación, por ejemplo: "contoso.com;2","fabrikam.com;3".

Si especifica un tipo de espacio de direcciones que no sea SMTP en un conector de envío configurado en un servidor de transporte de concentradores, se requieren las siguientes configuraciones en el conector de envío:

  • Debe usar un host inteligente para enrutar el correo electrónico especificando un valor para el parámetro SmartHosts.

  • Debe establecer el parámetro DNSRoutingEnabled en $False.

Nota

Aunque puede configurar espacios de direcciones que no son SMTP en un conector de envío de un servidor de transporte de concentradores, el conector de envío usa SMTP como mecanismo de transporte para enviar mensajes a otros servidores de mensajería. Los conectores externos de servidores de transporte de concentradores se usan para enviar mensajes a servidores de mensajería local, como servidores de puerta de enlace de fax terceros, que no usan SMTP como mecanismo de transporte principal. Para obtener más información, consulte Conectores externos.

Name

Necesario

System.String

Este parámetro es el nombre del conector proporcionado por el administrador. Debe agregar el parámetro Name entre comillas dobles si el nombre contiene espacios, por ejemplo: "New Send Connector".

AuthenticationCredential

Opcional

System.Management.Automation.PSCredential

Este parámetro requiere la creación y el paso de un objeto de credenciales. Este objeto de credenciales se crea mediante el cmdlet Get-Credential. Para obtener más información acerca del cmdlet Get-Credential, escriba Get-Help Get-Credential en el Shell de administración de Exchange.

Comment

Opcional

System.String

Se debe escribir el parámetro Comment entre comillas dobles, como en el siguiente ejemplo: "this is an admin note".

Confirm

Opcional

System.Management.Automation.SwitchParameter

El parámetro Confirm hace que el comando ponga en pausa el procesamiento y requiere que usted reconozca qué hará el comando antes de seguir con el procesamiento. No es necesario especificar un valor con el parámetro Confirm.

ConnectionInactivityTimeout

Opcional

Microsoft.Exchange.Data.EnhancedTimeSpan

Este parámetro especifica el tiempo máximo que puede permanecer abierta una conexión inactiva. El valor predeterminado es de 10 minutos. Para especificar un valor, especifíquelo como un intervalo de tiempo: dd.hh:mm:ss, donde d = días, h = horas, m = minutos y s = segundos. El intervalo de entrada válido para este parámetro es de 00:00:01 a 1.00:00:00.

Custom

Opcional

System.Management.Automation.SwitchParameter

Este parámetro especifica el tipo de uso de Custom. El tipo de uso especifica los métodos de permisos y autenticación que se asignan al conector de envío. Si usa el parámetro Custom, no podrá usar los parámetros siguientes:

  • Internal

  • Internet

  • Partner

  • Usage

Para obtener más información acerca de los tipos de uso del conector de envío, los permisos y los métodos de autenticación, consulte Conectores de envío.

DNSRoutingEnabled

Opcional

System.Boolean

Los valores válidos del parámetro DnsRoutingEnabled son $True o $False. El valor predeterminado es $True. Si se especifica un parámetro SmartHosts, el parámetro DnsRoutingEnabled debe ser $False en la misma línea de comando.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar el nombre de dominio completo (FQDN) del controlador de dominio que escribe este cambio de configuración en el servicio de directorio de Active Directory, incluya el parámetro DomainController en el comando. El parámetro DomainController no se admite en equipos que ejecutan la función del servidor Transporte perimetral. La función del servidor Transporte perimetral sólo lee y escribe en la instancia ADAM local.

DomainSecureEnabled

Opcional

System.Boolean

Este parámetro forma parte del proceso para habilitar la autenticación de Seguridad de nivel de transporte (TLS) para los dominios a los que ofrece servicios este conector de envío. La autenticación TLS mutua funcionará correctamente sólo si las siguientes condiciones son ciertas:

  • El valor del parámetro DomainSecureEnabled se establece en $True.

  • El valor del parámetro DNSRoutingEnabled se establece en $True.

  • El valor del parámetro IgnoreStartTLS se establece en $False.

El carácter comodín (*) no es compatible con los dominios que están configurados para la autenticación TLS mutua. También se puede definir el mismo dominio en el conector de recepción correspondiente y en el valor del parámetro TLSReceiveDomainSecureList del cmdlet Get-TransportConfig.

El valor predeterminado de DomainSecureEnabled es $False para los siguientes tipos de conectores de envío:

  • Todos los conectores de envío están definidos en un servidor de transporte de concentradores.

  • Los conectores de envío creados por el usuario están definidos en un servidor de transporte perimetral.

El valor predeterminado de DomainSecureEnabled es $True para los siguientes tipos de conectores de envío:

  • Los conectores de envío predeterminados que están definidos en un servidor de transporte perimetral

Enabled

Opcional

System.Boolean

Los valores válidos de este parámetro son $True o $False. El valor predeterminado es $True. Use el parámetro Enabled para habilitar o deshabilitar la posibilidad de que el conector procese mensajes de correo electrónico.

Force

Opcional

System.Management.Automation.SwitchParameter

Este parámetro suprime los mensajes de confirmación o advertencia que aparecen durante cambios de configuración específicos.

ForceHELO

Opcional

System.Boolean

Los valores válidos de este parámetro son $True o $False. El valor predeterminado es $False. De forma predeterminada, se usa EHLO. Si este parámetro se establece en $True, se enviará HELO en vez de EHLO.

Fqdn

Opcional

Microsoft.Exchange.Data.Fqdn

Este parámetro especifica el FQDN que se usa como el servidor de origen para los servidores de mensajería conectados que usan el conector de envío para recibir mensajes salientes. El valor de este parámetro se mostrará a los servidores de mensajería conectados cuando se requiera un nombre de servidor de origen, como en los siguientes ejemplos:

  • En el comando EHLO/HELO, cuando el conector de envío se comunica con el siguiente servidor de mensajería de saltos

  • En el campo de encabezado más reciente Received: del mensaje que se agrega al mensaje usando el siguiente servidor de mensajería de saltos, después de que el mensaje deje el servidor de transporte de concentradores o el servidor de transporte perimetral

  • Durante la autenticación TLS

El valor predeterminado del parámetro Fqdn es $Null. Esto significa que el valor predeterminado FQDN real es el FQDN del servidor de transporte de concentradores o del servidor de transporte perimetral que contiene el conector de envío.

Nota

Si el conector de envío se configura en un servidor de transporte de concentradores que también tiene la función del servidor Buzón de correo instalada, no se usará ninguno de los valores que especifique para el parámetro Fqdn. En su lugar, siempre se usará el FQDN del servidor que se muestra usando el cmdlet Get-ExchangeServer.
Para los servidores que tienen la función del servidor Transporte de concentradores y la función del servidor Buzón de correo instaladas, sólo se puede quitar el nombre del servidor de los encabezados Received: del mensaje saliente usando el cmdlet Remove-ADPermission para quitar el permiso Ms-Exch-Send-Headers-Routing de las entidades de seguridad que usa el conector. Esta acción quitará todos los encabezados Received: del mensaje cuando el mensaje deje el servidor de transporte de concentradores. Le recomendamos que no quite los encabezados Received: de los mensajes internos, ya que los encabezados Received: se usan para el cálculo del número máximo de saltos. Para obtener más información acerca del cmdlet Remove-ADPermission y del cmdlet Get-ExchangeServer, consulte los siguientes temas:
Remove-ADPermission
Get-ExchangeServer

IgnoreSTARTTLS

Opcional

System.Boolean

Este parámetro especifica si hay que omitir la opción StartTLS que ofrece un servidor de envío remoto. Este parámetro se usa con dominios remotos. Este parámetro debe establecerse en $False si el parámetro RequireTLS se establece en $True. Los valores válidos de este parámetro son $True y $False.

Internal

Opcional

System.Management.Automation.SwitchParameter

Este parámetro especifica el tipo de uso de Internal. El tipo de uso especifica los métodos de permisos y autenticación que se asignan al conector de envío. Si usa el parámetro Internal, no podrá usar los parámetros siguientes:

  • Custom

  • Internet

  • Partner

  • Usage

Para obtener más información acerca de los tipos de uso del conector de envío, los permisos y los métodos de autenticación, consulte Conectores de envío.

Internet

Opcional

System.Management.Automation.SwitchParameter

Este parámetro especifica el tipo de uso de Internet. El tipo de uso especifica los métodos de permisos y autenticación que se asignan al conector de envío. Si usa el parámetro Internet, no podrá usar los siguientes parámetros:

  • Custom

  • Internal

  • Partner

  • Usage

Para obtener más información acerca de los tipos de uso del conector de envío, los permisos y los métodos de autenticación, consulte Conectores de envío.

IsScopedConnector

Opcional

System.Boolean

Este parámetro controla la disponibilidad del conector para otros servidores de transporte de concentradores. Cuando el valor de este parámetro es $False, todos los servidores de transporte de concentradores pueden usar el conector en la organización de Exchange. Cuando el valor de este parámetro es $True, sólo los servidores de transporte de concentradores pueden usar el conector en el mismo sitio de Active Directory. El valor predeterminado es $False.

LinkedReceiveConnector

Opcional

Microsoft.Exchange.Configuration.Tasks.ReceiveConnectorIdParameter

Este parámetro obliga a que todos los mensajes recibidos por el conector de recepción especificado salgan a través de este conector de envío. El valor de LinkedReceivedConnector puede usar cualquiera de los siguientes identificadores para especificar el conector de recepción:

  • GUID

  • Nombre distintivo (DN)

  • nombreDeServidor\nombreDeConector

Cuando use el parámetro LinkReceiveConnector con el cmdlet New-SendConnector, deberá usar también los parámetros siguientes con los valores especificados:

  • DNSRoutingEnabled $False

  • MaxMessageSize unlimited

  • Smarthosts <idDeHostInteligente>

  • SmarthostAuthMechanism <mecanismoDeAutenticación>

Si usa el parámetro LinkedReceiveConnector, no deberá usar el parámetro AddressSpace.

MaxMessageSize

Opcional

Microsoft.Exchange.Data.Unlimited

Este parámetro especifica el tamaño máximo de un mensaje que se puede pasar a través de un conector. El valor predeterminado es 10MB. Cuando especifique un valor, certifique el valor con una de las siguientes unidades:

  • B (bytes)

  • KB (kilobytes)

  • MB (megabytes)

  • GB (gigabytes)

Los valores no certificados se tratan como bytes. Los valores que se introducen en bytes se redondean al kilobyte más cercano. Por ejemplo, 1048575B se redondea a  1MB y 1048577 se redondea a  1025KB. El intervalo de entrada válido para este parámetro es de 0 a 2147483647 bytes. Para quitar el límite de tamaño de mensaje de un conector de envío, introduzca el valor unlimited.

Partner

Opcional

System.Management.Automation.SwitchParameter

Este parámetro especifica el tipo de uso de Partner. El tipo de uso especifica los métodos de permisos y autenticación que se asignan al conector de envío. Si usa el parámetro Internet no puede usar los siguientes parámetros:

  • Custom

  • Internal

  • Internet

  • Usage

Para obtener más información acerca de los tipos de uso del conector de envío, los permisos y los métodos de autenticación, consulte Conectores de envío.

Port

Opcional

System.Int32

El intervalo de entrada válido para este parámetro es un número entero entre 0 y 65535. El valor predeterminado es 25. Si especifica un valor en el parámetro SmartHosts, el valor Port especifica el número de puerto que se usa para el reenvío del host inteligente. En la mayoría de las organizaciones, el número de puerto se establece en 25.

ProtocolLoggingLevel

Opcional

Microsoft.Exchange.Data.ProtocolLoggingLevel

Este parámetro habilita o deshabilita el registro de protocolo para el conector de envío especificado. Un valor Verbose habilita el registro de protocolo para el conector. Un valor None deshabilita el registro de protocolo para el conector. La ubicación de los registros de protocolo del conector de envío para todos los conectores de envío que están configurados en un servidor de transporte de concentradores o de transporte perimetral puede especificarse mediante el parámetro SendProtocolLogPath del cmdlet Set-TransportServer.

RequireTLS

Opcional

System.Boolean

Este parámetro especifica si todos los mensajes que se envían a través de este conector deben transmitirse usando TLS. El valor predeterminado es $False.

SmartHostAuthMechanism

Opcional

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

Este parámetro se usa durante la autenticación con un servidor remoto. Este parámetro se usa únicamente cuando se configura un host inteligente y el parámetro DNSRoutingEnabled se establece en $False. Los valores válidos son None, BasicAuth, BasicAuthRequireTLS, ExchangeServer y ExternalAuthoritative. Todos los valores son mutuamente excluyentes. Si selecciona BasicAuth o BasicAuthRequireTLS, debe usar el parámetro AuthenticationCredential para especificar la credencial de la autenticación.

SmartHosts

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Este parámetro es necesario si establece el parámetro DnsRoutingEnabled como $False y debe estar especificado en la misma línea de comando. El parámetro SmartHosts toma uno o varios FQDN, como server.contoso.com, o una o más direcciones IP o una combinación de FQDN y direcciones IP. Separe cada valor mediante una coma. Si especifica una dirección IP, debe especificar la dirección IP como un literal, por ejemplo: 10.10.1.1. La identidad del host inteligente puede ser el FQDN de un servidor de host inteligente, un registro de agente de intercambio de correo (MX) o un registro de dirección (A). Si se configura un FQDN como identidad del host inteligente, el servidor de origen para el conector de envío debe poder usar la resolución de nombre DNS para buscar el servidor de host inteligente.

SourceIPAddress

Opcional

System.Net.IPAddress

Este parámetro especifica la dirección IP local que se debe usar como punto final para una conexión SMTP con un servidor de mensajería remota. La dirección IP predeterminada es 0.0.0.0. Este valor indica al servidor que debe usar cualquier dirección IP local disponible. Este parámetro sólo es válido para conectores de envío configurados en servidores de transporte perimetral.

SourceTransportServers

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Este parámetro especifica los nombres de los servidores de transporte de concentradores que pueden usar este conector de envío. Puede especificar los nombres de más de un servidor de transporte de concentradores separando los nombres con comas. Este parámetro no es válido para conectores de envío configurados en servidores de transporte perimetral.

TemplateInstance

Opcional

System.Management.Automation.PSObject

Cuando se suministra un objeto existente a este parámetro, el comando usa la configuración del objeto para crear una copia idéntica del objeto en un servidor local o en uno de destino.

Usage

Opcional

Microsoft.Exchange.Management.SystemConfigurationTasks.NewSendConnector+UsageType

Este parámetro se puede usar para especificar los métodos de permisos y autenticación predeterminados que tiene asignados el conector de envío. Éstos son los valores válidos para este parámetro: Custom, Internal, Internet o Partner. Si no especifica un valor para el parámetro Usage, se usará el tipo de uso predeterminado, Custom.

Si usa el parámetro Usage, no podrá usar los siguientes parámetros:

  • Custom

  • Internal

  • Internet

  • Partner

Para obtener más información acerca de los tipos de uso del conector de envío, los permisos y los métodos de autenticación, consulte Conectores de envío.

UseExternalDNSServersEnabled

Opcional

System.Boolean

Este parámetro especifica si este conector de envío debe usar la lista de Sistema de nombre de dominio (DNS) externa que se especifica mediante el parámetro ExternalDNSServers del cmdlet Set-TransportServer. El valor predeterminado es $False. Los valores válidos de este parámetro son $True y $False.

WhatIf

Opcional

System.Management.Automation.SwitchParameter

El parámetro WhatIf indica al comando que simule las acciones que llevaría a cabo en el objeto. Mediante el uso del parámetro WhatIf, puede ver los cambios que se producirían sin tener que aplicarlos. No es necesario especificar un valor con el parámetro WhatIf.

Tipos de entrada

Tipos de valores devueltos

Errores

Error Descripción

 

 

Ejemplo

El primer ejemplo muestra el comando que crea un nuevo conector de envío que envía mensajes de correo electrónico a través de Internet. El ejemplo muestra los parámetros mínimos necesarios para crear un conector de envío. El espacio de dirección está restringido para enviar mensajes únicamente al dominio Contoso.com y al dominio Microsoft.com.

En el segundo ejemplo se muestran los comandos que crean un nuevo conector de envío que envía mensajes de correo electrónico a Contoso.com. El servidor de correo electrónico de Contoso.com requiere que el servidor local de Exchange 2007 se autentique con él para enviar mensajes de correo electrónico. Para configurar el conector de envío para que use la autenticación, primero debe ejecutar el comando Get-Credential y asignarlo a una variable. Cuando se ejecuta el comando Get-Credential, éste solicita el nombre de usuario y la contraseña de la cuenta que se usa durante la autenticación con el servidor de correo electrónico de Contoso.com.

En el segundo ejemplo se asigna el cmdlet Get-Credential a la variable $CredentialObject. Después de que se han asignado las credenciales de autenticación a la variable $CredentialObject, se puede crear el conector de envío mediante el cmdlet New-SendConnector. La variable $CredentialObject se pasa al parámetro AuthenticationCredential. Además de establecer las credenciales, se debe establecer el parámetro SmartHostAuthMechanism en BasicAuth para indicar al conector de envío que se autentique con el servidor de correo del Contoso.com usando las credenciales proporcionadas.

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