Set-ForeignConnector
Este cmdlet solo está disponible en el entorno local de Exchange.
Utilice el cmdlet Set-ForeignConnector para modificar un conector externo existente en el servicio de transporte de un servidor de buzones de correo.
Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.
Syntax
Set-ForeignConnector
[-Identity] <ForeignConnectorIdParameter>
[-AddressSpaces <MultiValuedProperty>]
[-Comment <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-DropDirectory <String>]
[-DropDirectoryQuota <Unlimited>]
[-Enabled <Boolean>]
[-Force]
[-IsScopedConnector <Boolean>]
[-MaxMessageSize <Unlimited>]
[-Name <String>]
[-RelayDsnRequired <Boolean>]
[-SourceTransportServers <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>] Description
Un conector externo usa el directorio de destino de un servidor de transporte de un servidor de buzones de correo para enviar mensajes a un servidor de mensajería local que no usa 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 asignados a un conector externo pueden ser SMTP o no.
Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.
Ejemplos
Ejemplo 1
Set-ForeignConnector "Fax Connector" -MaxMessageSize 10MBEn este ejemplo se configura un límite de tamaño de mensaje de 10 MB en el conector externo existente denominado "Fax Connector".
Parámetros
-AddressSpaces
El parámetro AddressSpaces especifica los nombres de dominio a los que el conector externo envía mensajes. La sintaxis completa para escribir cada espacio de direcciones es: 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 están permitidos, pero *contoso.com no está permitido. 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 costo va de 1 a 100. Un costo inferior indica una ruta mejor. 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 un 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 ("). 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 separando los espacios de direcciones con comas, por ejemplo: contoso.com,fabrikam.com. Si especifica el tipo de espacio de direcciones o el costo del espacio de direcciones, debe incluir el espacio de direcciones entre comillas ("), por ejemplo: "contoso.com;2","fabrikam.com;3".
Para agregar o quitar uno o varios valores de espacio de direcciones sin afectar a las entradas existentes, use la sintaxis siguiente: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Comment
El parámetro Comment especifica un comentario opcional. Si especifica un valor que contenga espacios, escríbalo entre comillas ("), por ejemplo: "Esto es una nota del administrador".
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Confirm
El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el cmdlet depende de si el cmdlet requiere confirmación antes de continuar.
- Los cmdlets destructivos (por ejemplo, cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta:
-Confirm:$false. - La mayoría de los demás cmdlets (por ejemplo, los cmdlets New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el comando antes de continuar.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainController
El parámetro DomainController especifica el controlador de dominio que el cmdlet usa para leer datos de Active Directory o escribirlos. El controlador de dominio se identifica por su nombre de dominio completo (FQDN). Por ejemplo, dc01.contoso.com.
El parámetro DomainController no es compatible con los servidores de transporte perimetral. Un servidor de transporte perimetral usa la instancia local de Active Directory Lightweight Directory Services (AD LDS) para leer y escribir datos.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DropDirectory
El parámetro DropDirectory especifica el nombre del directorio de destino que usa este conector externo. Todos los mensajes salientes enviados a espacios de direcciones definidos por 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:
- Parámetro RootDropDirectoryPath en el cmdlet Set-TransportService cmdlet: todos los conectores externos que existen en el servidor de buzones de correo usan esta opción. 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.
- Parámetro DropDirectory en el cmdlet Set-ForeignConnector: este valor se establece para todos los conectores externos que existen en el servidor.
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 2010. La carpeta de instalación predeterminada de Exchange 2010 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 automáticamente. Por lo tanto, debe crear manualmente cada carpeta del directorio de entrega.
El directorio de destino debe tener asignados los permisos siguientes:
- Servicio de red: Control total
- Sistema: Control total
- Administradores: Control total
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DropDirectoryQuota
El parámetro DropDirectoryQuota 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 especifique un valor, califíquelo con una de las siguientes unidades:
- B (bytes)
- KB (kilobytes)
- MB (megabytes)
- GB (gigabytes)
- TB (terabytes)
Los valores sin calificar normalmente se tratan como bytes, pero los valores pequeños se pueden redondear al kilobyte más cercano.
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 ilimitado.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Enabled
El parámetro Enabled especifica si se habilita el conector externo. Los valores válidos son $true o $false. El valor predeterminado es $true.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Force
El modificador Force oculta los mensajes de advertencia o confirmación. No es necesario especificar un valor con este modificador.
Este modificador se puede usar para ejecutar tareas mediante programación en las que no es apropiado solicitar una entrada administrativa.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Identity
El parámetro Identity especifica el conector externo que se 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
| Type: | ForeignConnectorIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-IsScopedConnector
El parámetro IsScopedConnector especifica la disponibilidad del conector para otros servidores de buzones de correo. Cuando se $false el valor de este parámetro, todos los servidores de buzones de correo de la organización de Exchange pueden usar el conector. Cuando se $true el valor de este parámetro, los servidores de buzones de correo solo pueden usar el conector en el mismo sitio de Active Directory. El valor predeterminado es $false.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-MaxMessageSize
El parámetro MaxMessageSize especifica el tamaño máximo de mensaje que puede pasar a través de este conector externo.
Cuando especifique un valor, califíquelo con una de las siguientes unidades:
- B (bytes)
- KB (kilobytes)
- MB (megabytes)
- GB (gigabytes)
- TB (terabytes)
Los valores sin calificar normalmente se tratan como bytes, pero los valores pequeños se pueden redondear al kilobyte más cercano.
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 configura el parámetro MaxMessageSize con el valor 0, se deshabilita el conector externo. Sin embargo, si configura el parámetro MaxMessageSize con el valor 0 pero el atributo Enabled está configurado con el valor $true, se generan errores de registro de eventos. El método preferido para deshabilitar el conector externo consiste en usar el parámetro Enabled.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Name
El parámetro Name especifica un nombre descriptivo para el conector externo.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-RelayDsnRequired
El parámetro RelayDsnRequired 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-SourceTransportServers
El parámetro SourceTransportServers especifica los nombres de los servidores de buzones que usan este conector externo. Si dispone de un solo conector externo hospedado en varios servidores de buzones de correo que ejecutan el servicio de transporte, obtendrá tolerancia a errores y una alta disponibilidad si uno de los servidores genera un error. El valor predeterminado de este parámetro es el nombre del servidor de buzones de correo en el cual se instaló este conector externo por primera vez.
Para especificar varios valores y sobrescribir las entradas existentes, use la siguiente sintaxis: Value1,Value2,...ValueN. Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN".
Para agregar o quitar uno o más valores sin afectar las entradas existentes, use la siguiente sintaxis: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-WhatIf
El modificador WhatIf simula las acciones del comando. Puede usar este modificador para ver los cambios que se producirían, pero sin aplicar los cambios. No es necesario especificar un valor con este modificador.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
Entradas
Input types
Para ver los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.
Salidas
Output types
Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.