New-SendConnector (RTM)
Se aplica a: Exchange Server 2007 SP1, Exchange Server 2007
Última modificación del tema: 2007-08-27
Utilice el cmdlet New-SendConnector para crear un nuevo 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
New-SendConnector -Name <String> -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>] [-MaxMessageSize <Unlimited>] [-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>]
New-SendConnector -Name <String> [-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>] [-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>]
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, introduzca 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 servidor de Exchange y el grupo de administradores locales para el servidor de destino.
Para ejecutar el cmdlet New-SendConnector en un equipo con la función del servidor Transporte perimetral instalada, debe iniciar sesión mediante una cuenta que pertenezca al grupo local Administradores de 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 |
---|---|---|---|
AddressSpaces |
Necesario |
Microsoft.Exchange.Data.MultiValuedProperty |
Este parámetro es necesario a menos que este conector esté vinculado a un conector de recepción mediante el parámetro LinkedReceiveConnector. 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>
Debe usar la sintaxis completa para el parámetro AddressSpaces únicamente en las siguientes condiciones:
Puede especificar varios espacios de direcciones separándolos con comas, como a continuación, por ejemplo: 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:
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. |
Nombre |
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: |
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 |
Comment |
Opcional |
System.String |
Se debe escribir el parámetro Comment entre comillas dobles, como en el siguiente ejemplo: |
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, escriba el valor como un marco temporal: 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 |
DNSRoutingEnabled |
Opcional |
System.Boolean |
Los valores válidos del parámetro DnsRoutingEnabled son |
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 la Seguridad de nivel de transporte (TLS) para los dominios a los que ofrece servicios este conector de envío. La autenticación TLS mutua sólo funcionará correctamente si se cumplen las siguientes condiciones:
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 de DomainSecureEnabled es
El valor predeterminado de DomainSecureEnabled es
|
Enabled |
Opcional |
System.Boolean |
Los valores válidos de este parámetro son |
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 |
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:
El valor predeterminado del parámetro Fqdn es 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. |
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 |
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:
Cuando utilice el parámetro LinkReceiveConnector con el cmdlet New-SendConnector, deberá usar también los parámetros siguientes con los valores especificados:
Si usa el parámetro LinkedReceiveConnector, no deberá usar el parámetro AddressSpace. |
MaxMessageSize |
Opcional |
Microsoft.Exchange.Data.Unlimited |
El parámetro MaxMessageSize especifica el tamaño máximo de un mensaje que pasa a través de un conector. También puede sobrecargar este parámetro introduciendo
Los valores no certificados se tratan como bytes. Los valores que se introducen en bytes se redondean al kilobyte más cercano. Por ejemplo, |
Port |
Opcional |
System.Int32 |
El intervalo de entrada válido para este parámetro es un número entero entre |
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 |
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 |
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 |
SmartHosts |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
Este parámetro es necesario si establece el parámetro DnsRoutingEnabled como |
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 |
SourceTransportServers |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
Este parámetro especifica los nombres de los servidor concentrador de transporte que pueden usar este conector de envío. Puede especificar los nombres de más de un servidor concentrador de transporte 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 un objeto existente se suministra a este parámetro, el comando usa la configuración de ese objeto para crear una copia idéntica del objeto en un servidor local o de destino. |
Usage |
Opcional |
Microsoft.Exchange.Management.SystemConfigurationTasks.NewSendConnector+UsageType |
Este parámetro le ayuda a configurar los valores predeterminados del conector dependiendo de cómo se lo utilice. Estos son los valores válidos para este parámetro: |
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 |
Tipos de entrada
Tipos de retorno
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, este 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