Compartir a través de

Set-SendConnector (RTM)

  • Artículo

 

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

Última modificación del tema: 2007-08-27

Utilice el cmdlet Set-SendConnector para modificar un conector de envío en un equipo que tenga instalada la función del servidor Transporte de concentradores o la función del servidor Transporte perimetral.

Sintaxis

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

Descripción detallada

El cmdlet Set-SendConnector modifica un conector de envío existente. Se requiere el parámetro Name al ejecutar el cmdlet Set-SendConnector. Se requiere el parámetro Identity únicamente cuando se modifica el valor del parámetro Name.

Una vez finalizada esta tarea, se modifica el conector de envío.

Para ejecutar el cmdlet Set-SendConnector, se debe delegar la función Administrador de servidor de Exchange y el grupo Administradores local en la cuenta que use en el servidor de destino.

Para ejecutar el cmdlet Set-SendConnector en un equipo que tiene instalada la función del servidor Transporte perimetral, debe iniciar sesión mediante una cuenta que sea miembro del grupo Administradores local en dicho equipo.

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

Parámetros

Parámetro Necesario Tipo Descripción

Identity

Necesario

Microsoft.Exchange.Configuration.Tasks.SendConnectorIdParameter

El parámetro Identity especifica el GUID o nombre del conector que representa el conector de envío que desea modificar

AddressSpaces

Opcional

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 de 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. Puede especificar varios espacios de direcciones separándolos con comas. La sintaxis completa para escribir cada espacio de dirección es la siguiente:

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

  • ConnectorScope   Si especifica un valor de Local, el conector solamente puede ser utilizado por otros servidores de transporte perimetral que existan en el mismo sitio de Active Directory que el servidor de transporte perimetral de origen en el que se está ejecutando el cmdlet New-SendConnector. Si omite el certificador ConnectorScope, el conector puede ser usado por todos los servidores de transporte perimetral de toda la organización de Exchange 2007.

  • AddressSpaceType   Para los espacios de dirección SMTP, este valor debe ser SMTP. Para los espacios de dirección no SMTP, este valor puede ser cualquier cadena de texto descriptiva, como "Lotus Notes".

  • AddressSpace   Para espacios de direcciones SMTP, se puede usar el carácter comodín (*) del sistema de nombres de dominio (DNS) tal como se define en RFC 1035. Por ejemplo, puede usar "*", "*.com." o *.contoso.com". Para espacios de direcciones no SMTP, puede usar caracteres comodín (*) y otros caracteres, como "*contoso.com" o "@contoso".

  • 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 se omite el certificador AddressSpaceCost cuando se introduce un espacio de dirección con una sintaxis completa, se presupone un costo de conector de 1.

Solamente necesita usar la sintaxis completa para el parámetro AddressSpaces en las siguientes condiciones:

  • Conectores dentro del ámbito que tienen el certificador Local

  • Espacios de dirección no SMTP

  • Espacios de direcciones SMTP con un costo distinto de 1

Si escribe un nombre de dominio o una lista separada por comas de nombres de dominio para el valor del parámetro AddressSpaces, se asume un tipo de espacio de direcciones SMTP y un costo de 1 para cada nombre de dominio. Los conectores de envío configurados en servidores de transporte perimetral solamente permiten espacios de direcciones SMTP. Los conectores de envío configurados en servidores de transporte de concentradores permiten espacios de direcciones SMTP y no SMTP.

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

El parámetro Comment debe ir entre comillas dobles, por ejemplo: "this is an admin note".

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.

DNSRoutingEnabled

Opcional

System.Boolean

Este parámetro especifica si se debe usar el enrutamiento del Sistema de nombres de dominio (DNS) o si se deben enviar todos los mensajes a través de un host inteligente que está configurado mediante el parámetro SmartHosts. El valor predeterminado es $True. Si desea establecer el valor en $False, primero debe establecer un valor en el parámetro SmartHosts.

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 solamente funcionará de forma correcta si se cumplen las siguientes condiciones:

  • El valor predeterminado del parámetro DomainSecureEnabled debe ser $True.

  • El valor predeterminado del parámetro DNSRoutingEnabled debe ser $True.

  • El valor predeterminado del parámetro IgnoreStartTLS debe ser $False.

El asterisco (*) no se admite en 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 para DomainSecureEnabled es $False para los siguientes tipos de conectores de envío:

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

  • Conectores de envío creados por el usuario definidos en un servidor de transporte perimetral.

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

  • Conectores de envío predeterminados definidos en un servidor de transporte perimetral.

Enabled

Opcional

System.Boolean

La entrada válida de este parámetro es $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

La entrada válida de este parámetro es $True o $False. El valor predeterminado es $False. De forma predeterminada, se usa EHLO. Si este parámetro se establece en $True, HELO se envía en lugar 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 utilizará 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 servidores que tienen tanto la función de servidor de transporte de concentradores como la función del Buzón de correo instaladas, la única manera de quitar el nombre del servidor de los encabezados Received: del mensaje saliente es usar 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 (RTM)
• Get-ExchangeServer (RTM)

IgnoreSTARTTLS

Opcional

System.Boolean

La entrada válida de este parámetro es $True o $False. 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 se establece el parámetro RequireTLS en $True. De forma predeterminada, un conector de envío con el valor del parámetro DNSRoutingEnabled establecido en $True también tiene el valor del parámetro IgnoreStartTLS establecido en $False. Esto significa que el conector de envío siempre negocia TLS si el servidor de recepción ofrece TLS. Si se establece el valor del parámetro IgnoreStartTLS en $True, el conector de envío nunca intenta negociar TLS con el servidor de recepción.

Instance

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.SmtpSendConnectorConfig

Este parámetro le permite pasar todo el objeto del comando para que sea procesado. Se usa principalmente en scripts donde hay que pasar un objeto completo al comando.

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 utilizar cualquiera de los siguientes identificadores para especificar el conector de recepción:

  • GUID

  • Nombre distintivo (DN)

  • nombreDeServidor\nombreDeConector

Cuando utilice el parámetro LinkReceiveConnector con el cmdlet Set-SendConnector, deberá utilizar también los parámetros siguientes con los valores especificados:

  • AddressSpaces $null

  • DNSRoutingEnabled $False

  • MaxMessageSize unlimited

  • Smarthosts <idDeHostInteligente>

  • SmarthostAuthMechanism <mecanismoDeAutenticación>

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. Al escribir un valor, otorgue al valor una de las siguientes unidades:

  • B (bytes)

  • KB (kilobytes)

  • MB (megabytes)

  • GB (gigabytes)

Los valores no certificados se tratan como bytes. 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, escriba el valor unlimited.

Name

Opcional

System.String

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

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 de Verbose habilita el registro de protocolo para el conector. Un valor de None deshabilita el registro de protocolo para el conector. El valor predeterminado es None. La ubicación de los registros de protocolo del conector de envío para todos los conectores de envío configurados en archivos de un servidor de transporte de concentradores o un servidor de transporte perimetral se especifica con el parámetro SendProtocolLogPath del comando 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 utiliza ú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 o 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 toma uno o varios FQDN, como server.contoso.com, o una o más direcciones IP, separadas por comas. 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.

UseExternalDNSServersEnabled

Opcional

System.Boolean

Este parámetro especifica si este conector de envío debe usar la lista de 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.

Tipos de entrada

Tipos de valores devueltos

Errores

Error Descripción

 

 

Ejemplo

En el primer ejemplo de código se muestra un comando Set-SendConnector que modifica un conector de envío existente. El comando establece el límite de MaxMessageSize en 10 MB y ConnectionInactivityTimeOut en 15 minutos.

En el segundo ejemplo se muestran los comandos que modifican un conector de envío existente para que use la autenticación cuando el conector de envío envía un mensaje de correo electrónico a Contoso.com. El servidor de correo electrónico de Contoso.com requiere que el servidor de Exchange Server 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 asignar el comando a una variable. Cuando ejecuta el comando Get-Credential, éste solicita el nombre de usuario y la contraseña de la cuenta que se usará durante la autenticación con el servidor de correo electrónico de Contoso.com.

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

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