Compartir a través de

Set-ForeignConnector (RTM)

  • Artículo

 

Se aplica a: Exchange Server 2007

Última modificación del tema: 2007-06-11

Utilice el cmdlet Set-ForeignConnector para modificar un conector externo existente en un equipo en el que se ejecute Microsoft Exchange Server 2007 y que tenga instalada la función del servidor Transporte de concentradores. Un conector externo utiliza un directorio de destino en un servidor de transporte de concentradores para enviar mensajes a un servidor de mensajería local que no utilice el Protocolo simple de transferencia de correo (SMTP) como mecanismo de transporte principal. Estos servidores de mensajería se conocen como servidores de puerta de enlace externos. Los servidores de puerta de enlace de faxes de terceros son ejemplos de servidores de puerta de enlace externos. Los espacios de direcciones que se asignan a un conector externo pueden ser SMTP o no ser SMTP.

Sintaxis

Set-ForeignConnector -Identity <ForeignConnectorIdParameter> [-AddressSpaces <MultiValuedProperty>] [-Comment <String>] [-DomainController <Fqdn>] [-DropDirectory <String>] [-DropDirectoryQuota <Unlimited>] [-Enabled <$true | $false>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-RelayDsnRequired <$true | $false>] [-SourceTransportServers <MultiValuedProperty>]

Set-ForeignConnector [-AddressSpaces <MultiValuedProperty>] [-Comment <String>] [-DomainController <Fqdn>] [-DropDirectory <String>] [-DropDirectoryQuota <Unlimited>] [-Enabled <$true | $false>] [-Instance <ForeignConnector>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-RelayDsnRequired <$true | $false>] [-SourceTransportServers <MultiValuedProperty>]

Descripción detallada

El cmdlet Set-ForeignConnector modifica un conector externo existente. Los cambios de propiedades que especifique al utilizar el cmdlet Set-ForeignConnector sobrescriben los valores de propiedades existentes.

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

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

Parámetros

Parámetro Necesario Tipo Descripción

Identity

Necesario

Microsoft.Exchange.Configuration.Tasks.ForeignConnectorIdParameter

Este parámetro especifica el conector externo que desea modificar. El parámetro Identity puede adoptar cualquiera de los siguientes valores para el objeto del conector externo:

  • GUID

  • Nombre del conector

  • ServerName\ConnectorName

AddressSpaces

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Este parámetro especifica los nombres de dominio a los cuales envía mensajes el conector externo. 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 calificador ConnectorScope, el conector puede ser utilizado 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 los espacios de dirección SMTP, se puede utilizar el carácter comodín (*) de sistema de nombre de dominio (DNS), tal como se define en RFC 1035, como "*", "*.com.", o *.contoso.com", por ejemplo. Para los espacios de dirección no SMTP, se puede utilizar caracteres comodín (*) y otros caracteres, como "*contoso.com" o "@contoso", por ejemplo.

  • AddressSpaceCost   El intervalo de entrada válido para el coste va de 1 a 100. Un coste inferior indica una ruta mejor. Este parámetro es opcional. Si se omite el calificador AddressSpaceCost cuando se introduce un espacio de dirección utilizando una sintaxis completa, se presupone un costo de conector de 1.

Debe usar la sintaxis completa para el parámetro AddressSpaces únicamente en las siguientes condiciones:

  • Conectores dentro del ámbito que tienen el calificador Local

  • Espacios de dirección no SMTP

  • Espacios de dirección SMTP con un costo que no es 1

Si se escribe un nombre de dominio o una lista de nombres de dominio separada por comas para el valor del parámetro AddressSpaces, se presupone el tipo de espacio de dirección de SMTP y un costo de 1 para cada nombre de dominio.

Comment

Opcional

System.String

Este parámetro especifica un comentario opcional para el conector externo. El parámetro Comment debe escribirse entre comillas dobles, como en el siguiente ejemplo: "esto es una nota del administrador".

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.

DropDirectory

Opcional

System.String

Este parámetro especifica el nombre del directorio de destino que utiliza este conector externo. Todos los mensajes salientes que se envían a espacios de direcciones que define este conector externo se colocan en el directorio de destino especificado. La ubicación del directorio de almacenamiento para cada conector externo la controlan los dos elementos siguientes:

  • El parámetro RootDropDirectoryPath del cmdlet Set-TransportServer   Esta opción se utiliza para todos los conectores externos que existen en el servidor de transporte de concentradores. El valor del parámetro RootDropDirectoryPath puede ser una ruta de acceso local o una ruta de acceso de convención de nomenclatura universal (UNC) a un servidor remoto.

  • El parámetro DropDirectory del cmdlet Set-ForeignConnector   Este valor se establece para cada conector externo que existe en el servidor de transporte de concentradores.

De forma predeterminada, el parámetro RootDropDirectoryPath está en blanco. Esto indica que el valor de RootDropDirectoryPath es la carpeta de instalación de Exchange 2007. La carpeta de instalación predeterminada de Exchange 2007 es C:\Archivos de programa\Microsoft\Exchange Server\. De forma predeterminada, el valor del parámetro DropDirectory es el nombre del conector externo.

Si el valor del parámetro DropDirectory no contiene información de ruta de acceso absoluta, la ubicación del directorio de almacenamiento se define por la combinación del parámetro DropDirectory y el parámetro RootDropDirectoryPath. Si el valor del parámetro DropDirectory contiene información de ruta de acceso absoluta, el valor de RootDropDirectoryPath deberá ser no específico. La ubicación del directorio de almacenamiento sólo se define por el valor del parámetro DropDirectory.

El directorio de almacenamiento no se crea para usted. Por lo tanto, deberá crear manualmente cada carpeta de directorios de almacenamiento.

El directorio de destino debe tener asignados los permisos siguientes:

  • Servicio de red: Control total

  • Sistema: Control total

  • Administradores: Control total

DropDirectoryQuota

Opcional

Microsoft.Exchange.Data.Unlimited

Este parámetro especifica el tamaño máximo de todos los archivos de mensajes del directorio de destino. Cuando se alcanza el valor especificado, no se pueden copiar nuevos archivos de mensajes en el directorio de destino hasta que se envíen y eliminen los mensajes existentes. Cuando escriba un valor para el parámetro DropDirectoryQuota, califique el valor con una de las siguientes unidades:

  • B (bytes)

  • KB (kilobytes)

  • MB (megabytes)

  • GB (gigabytes)

  • TB (terabytes)

Los valores no calificados se tratan como bytes. El intervalo de entrada válido para este parámetro es de 1 a 2147483647 bytes. Si introduce el valor unlimited, no se impone ningún límite de tamaño de mensaje en el directorio de destino. El valor predeterminado es unlimited.

Enabled

Opcional

System.Boolean

Este parámetro habilita o deshabilita el conector externo. Los valores de entrada válidos son $True o $False. El valor predeterminado es $True.

Instance

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.ForeignConnector

El parámetro Instance permite pasar todo un objeto al comando para su procesamiento. Se utiliza principalmente en scripts donde hay que pasar un objeto completo al comando.

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 este conector externo. Cuando introduzca un valor para el parámetro MaxMessageSize, califique el valor con una de las siguientes unidades:

  • B (bytes)

  • KB (kilobytes)

  • MB (megabytes)

  • GB (gigabytes)

  • TB (terabytes)

Los valores no certificados se tratan como kilobytes. Si introduce el valor unlimited, no se impone ningún límite de tamaño de mensaje en este conector externo. El valor predeterminado es unlimited. El intervalo de entrada válido para este parámetro es de 0 a 2147483647 kilobytes. Si establece el valor del parámetro MaxMessageSize en 0, se deshabilita de forma eficaz el conector externo. Sin embargo, si establece el valor del parámetro MaxMessageSize en 0 cuando el valor del atributo Enabled es $True, se generarán errores de registro de eventos. El método preferido para deshabilitar el conector externo consiste en utilizar el parámetro Enabled.

Name

Opcional

System.String

Este parámetro especifica un nombre descriptivo para el conector externo.

RelayDsnRequired

Opcional

System.Boolean

Este parámetro especifica si el conector externo necesita una notificación de estado de entrega (DSN) de la retransmisión cuando se escriben mensajes en el directorio de destino. Los valores de entrada válidos de este parámetro son $True o $False. El valor predeterminado es $False.

SourceTransportServers

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Este parámetro especifica los nombres de los servidores de transporte de concentradores que utiliza este conector externo. Puede especificar múltiples servidores de transporte de concentradores separando los nombres de servidores con comas. Si dispone de un solo conector externo hospedado en varios servidores de transporte de concentradores, obtendrá tolerancia a errores y alta disponibilidad si uno de los servidores de transporte de concentradores produce un error. El valor predeterminado de este parámetro es el nombre del servidor de transporte de concentradores en el cual se instaló por primera vez este conector externo.

Ejemplo

El siguiente ejemplo de código muestra dos ejemplos que utilizan el cmdlet Set-ForeignConnector.

El primer ejemplo muestra un comando Set-ForeignConnector que modifica un conector externo existente denominado "Contoso Foreign Connector". Este comando establece el parámetro MaxMessageSize en 10 MB.

El segundo ejemplo muestra un comando Set-ForeignConnector que modifica los espacios de direcciones que atiende un conector externo denominado "Contoso Foreign Connector". Los detalles de los espacios de direcciones son los siguientes:

  • Primer espacio de direcciones:

    • Tipo de espacio de direcciones: SMTP

    • Espacio de direcciones: "*.contoso.com"

    • Coste de espacio de direcciones: 1

  • Segundo espacio de direcciones:

    • Tipo de espacio de direcciones: Lotus Notes

    • Espacio de direcciones: "*@domino"

    • Coste de espacio de direcciones: 55

Set-ForeignConnector "Contoso Foreign Connector" -MaxMessageSize 10MB
Set-ForeignConnector "Contoso Foreign Connector" -AddressSpaces ".contoso.com","Lotus Notes:*@domino;55"