Compartir a través de

Set-SendConnector

  • Artículo

 

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

Ú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>] [-Confirm [<SwitchParameter>]] [-ConnectionInactivityTimeOut <EnhancedTimeSpan>] [-DNSRoutingEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-ForceHELO <$true | $false>] [-Fqdn <Fqdn>] [-IgnoreSTARTTLS <$true | $false>] [-IsScopedConnector <$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>] [-WhatIf [<SwitchParameter>]]

Set-SendConnector [-AddressSpaces <MultiValuedProperty>] [-AuthenticationCredential <PSCredential>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-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>] [-IsScopedConnector <$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>] [-WhatIf [<SwitchParameter>]]

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 local de administradores 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 local de administradores 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. 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 los valores de tipo de dirección, puede escribir 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 el carácter de punto y coma ( ; ), deberá especificar el costo del 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, como a continuación, por ejemplo: contoso.com,fabrikam.com. Si especifica el tipo de espacio de dirección o el costo de un espacio de dirección, el espacio de dirección deberá aparecer entre comillas dobles ( " ) como se muestra 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 utilizar 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.

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".

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.

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

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.

IsScopedConnector

Opcional

System.Boolean

Este parámetro controla la disponibilidad del conector con otros servidores de transporte de concentradores. Cuando el valor de este parámetro es $False, todos los servidores de transporte de concentradores pueden utilizar 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 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 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. Los valores que se escriben 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, 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 Seguridad del nivel de transporte (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.

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

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