Compartir a través de

Set-ForeignConnector

  • Artículo

 

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

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

Use el cmdlet Set-ForeignConnector para modificar un conector externo existente en un equipo que ejecute Microsoft Exchange Server 2007 y que tenga instalada la función del servidor Transporte de concentradores. Los conectores externos utilizan 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 denominan 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 asignados a un conector externo pueden ser SMTP o no.

Sintaxis

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

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

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. La sintaxis completa para escribir cada espacio de dirección es la siguiente: <AddressSpaceType>:<AddressSpace>;<AddressSpaceCost>

  • AddressSpaceType   El tipo de espacio de direcciones puede ser SMTP, X400, o cualquier 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 valores de tipo de dirección, puede introducir cualquier texto para el espacio de direcciones.

  • AddressSpaceCost   El intervalo de entrada válido para el coste va de 1 a 100. Un coste inferior indica una ruta mejor. Si omite el coste de un espacio de direcciones, se asumirá un coste de 1. Si escribe un espacio de direcciones no SMTP que contiene punto y coma ( ; ), deberá especificar el coste de un espacio de direcciones.

Si especifica el tipo de espacio de direcciones o el coste 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 coste 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".

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

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.

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.

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.

Instance

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.ForeignConnector

El parámetro Instance le permite pasar un objeto completo al comando que se va a procesar. Se utiliza principalmente en scripts en los que se debe 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 utilizar el conector en el mismo sitio Active Directory. El valor predeterminado es $False.

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

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.

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"