Set-SendConnector

Artículo
08/09/2014

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