Set-OutboundConnector

Este cmdlet solo está disponible en el servicio basado en la nube.

Use el cmdlet Set-OutboundConnector para cambiar un conector de salida existente en la organización basada en la nube.

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-OutboundConnector
   [-Identity] <OutboundConnectorIdParameter>
   [-AllAcceptedDomains <Boolean>]
   [-CloudServicesMailEnabled <Boolean>]
   [-Comment <String>]
   [-Confirm]
   [-ConnectorSource <TenantConnectorSource>]
   [-ConnectorType <TenantConnectorType>]
   [-Enabled <Boolean>]
   [-IsTransportRuleScoped <Boolean>]
   [-IsValidated <Boolean>]
   [-LastValidationTimestamp <DateTime>]
   [-Name <String>]
   [-RecipientDomains <MultiValuedProperty>]
   [-RouteAllMessagesViaOnPremises <Boolean>]
   [-SenderRewritingEnabled <Boolean>]
   [-SmartHosts <MultiValuedProperty>]
   [-TestMode <Boolean>]
   [-TlsDomain <SmtpDomainWithSubdomains>]
   [-TlsSettings <TlsAuthLevel>]
   [-UseMXRecord <Boolean>]
   [-ValidationRecipients <String[]>]
   [-WhatIf]
   [<CommonParameters>]

Description

Los conectores de salida envían mensajes a dominios remotos que requieren opciones de configuración específicas.

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-OutboundConnector "Contoso Outbound Connector" -UseMxRecord $false -SmartHosts 192.168.0.1

En este ejemplo se cambia la configuración del conector de salida existente denominado "Contoso Outbound Connector" para enrutar a un host inteligente en la dirección IP 192.168.0.1.

Parámetros

-AllAcceptedDomains

El parámetro AllAcceptedDomains especifica si el conector de salida se usa en organizaciones híbridas donde los destinatarios de mensajes están en dominios aceptados de la organización basada en la nube. Los valores admitidos son:

  • $true: el conector de salida se usa en organizaciones híbridas cuando los destinatarios del mensaje están en un dominio aceptado de la organización basada en la nube. Esta configuración requiere OnPremises para el valor ConnectorType.
  • $false: el conector de salida no se usa en organizaciones híbridas. Este es el valor predeterminado.

Este parámetro solo es efectivo para los conectores OnPremises.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-CloudServicesMailEnabled

Nota: Le recomendamos que no use este parámetro a menos que se le indique que lo haga Microsoft servicio al cliente y soporte técnico, o por documentación específica del producto. En su lugar, use el Asistente para configuración híbrida para configurar el flujo de correo entre las organizaciones locales y en la nube. Para obtener más información, vea Asistente de configuración híbrida.

El parámetro CloudServicesMailEnabled especifica si el conector se usa para el flujo de correo híbrido entre un entorno de Exchange local y Microsoft 365. En concreto, este parámetro controla cómo se controlan determinados encabezados de mensaje X-MS-Exchange-Organization-* internos en los mensajes que se envían entre dominios aceptados en las organizaciones locales y en la nube. Estos encabezados se conocen colectivamente como encabezados entre locales.

Los valores admitidos son:

  • $true: El conector se usa para el flujo de correo en organizaciones híbridas, por lo que los encabezados entre locales se conservan o promueven en los mensajes que fluyen a través del conector. Este es el valor predeterminado para los conectores creados por el Asistente para configuración híbrida. Determinados encabezados X-MS-Exchange-Organization-* de los mensajes salientes que se envían desde un lado de la organización híbrida al otro se convierten en encabezados X-MS-Exchange-CrossPremises-* y, por tanto, se conservan en los mensajes. Los encabezados X-MS-Exchange-CrossPremises-* de los mensajes entrantes que se reciben en un lado de la organización híbrida desde el otro se promueven a encabezados X-MS-Exchange-Organization-*. Estos encabezados promocionados reemplazan cualquier instancia de los mismos encabezados X-MS-Exchange-Organization-* que ya existen en los mensajes.
  • $false: El conector no se usa para el flujo de correo en organizaciones híbridas, por lo que los encabezados entre locales se quitan de los mensajes que fluyen a través del conector.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-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 Online, Exchange Online Protection

-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 Online, Exchange Online Protection

-ConnectorSource

El parámetro ConnectorSource especifica cómo se crea el conector. Los valores admitidos son:

  • Default: el conector se crea manualmente. Este es el valor predeterminado para los conectores creados manualmente y se recomienda no cambiar este valor.
  • HybridWizard: el conector se crea automáticamente mediante el asistente de configuración híbrida.
  • Migrated: el conector se creó originalmente en Microsoft Forefront Online Protection para Exchange.
Type:TenantConnectorSource
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-ConnectorType

El parámetro ConnectorType especifica una categoría para los dominios a los que ofrece servicios este conector. Los valores admitidos son:

  • Partner: dominios de servicios del conector que son externos a su organización.
  • OnPremises: dominios de servicios del conector que se usan en la organización local.
Type:TenantConnectorType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Enabled

El parámetro Enabled especifica si se va a habilitar o deshabilitar el conector de salida. Los valores admitidos son:

  • $true: el conector está habilitado. Este es el valor predeterminado.
  • $false: el conector está deshabilitado.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Identity

El parámetro Identity especifica el conector que desea cambiar. Puede usar cualquier valor que identifique de forma exclusiva el conector. Por ejemplo:

  • Nombre
  • Nombre completo (DN)
  • GUID
Type:OutboundConnectorIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-IsTransportRuleScoped

El parámetro IsTransportRuleScoped especifica si el conector de salida está asociado a una regla de transporte (también conocida como regla de flujo de correo). Los valores admitidos son:

  • $true: El conector está asociado a una regla de transporte.
  • $false: El conector no está asociado a una regla de transporte. Este es el valor predeterminado.

El ámbito de una regla de transporte a un conector de salida se usa el parámetro RouteMessageOutboundConnector en los cmdlets New-TransportRule o Set-TransportRule. Los mensajes que coinciden con las condiciones de la regla de transporte se enrutan a sus destinos mediante el conector de salida especificado.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-IsValidated

El parámetro IsValidated especifica si se ha validado el conector de salida. Los valores admitidos son:

  • $true: Se ha validado el conector,
  • $false: el conector no se ha validado. Este es el valor predeterminado.

Use el cmdlet Validate-OutboundConnector para validar el conector.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-LastValidationTimestamp

El parámetro LastValidationTimestamp especifica la fecha y hora en que se validó el conector de salida.

Para especificar un valor de fecha y hora para este parámetro, use una de las siguientes opciones:

  • Especifique el valor de fecha y hora en UTC: por ejemplo, "2021-05-06 14:30:00z".
  • Especifique el valor de fecha y hora como una fórmula que convierta la fecha y hora de la zona horaria local en UTC: por ejemplo, (Get-Date "5/6/2021 9:30 AM").ToUniversalTime(). Para obtener más información, vea Get-Date.

Use el cmdlet Validate-OutboundConnector para validar el conector.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Name

El parámetro Name especifica el nombre único del conector. La longitud máxima es de 64 caracteres. Si el valor contiene espacios, escríbalo entre comillas (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-RecipientDomains

El parámetro RecipientDomains especifica el dominio al que el conector de salida enruta el correo. Puede especificar varios dominios separados por comas.

Puede usar un carácter comodín para especificar todos los subdominios de un dominio concreto, tal como se muestra en el siguiente ejemplo: *.contoso.com. Sin embargo, no puede insertar un carácter comodín, como se muestra en el ejemplo siguiente: domain.*.contoso.com.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-RouteAllMessagesViaOnPremises

El parámetro RouteAllMessagesViaOnPremises especifica que todos los mensajes que proporciona este conector se enrutan primero a través del sistema de correo electrónico local. Los valores admitidos son:

  • $true: los mensajes se enrutan a través del sistema de correo electrónico local. Esta configuración requiere OnPremises para el valor ConnectorType.
  • $false: los mensajes no se enrutan a través del sistema de correo electrónico local. Este es el valor predeterminado.

Este parámetro solo es efectivo para los conectores OnPremises.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-SenderRewritingEnabled

El parámetro SenderRewritingEnabled especifica que todos los mensajes que normalmente califican para la reescritura de SRS se vuelven a escribir para el enrutamiento a través del sistema de correo electrónico local. Los valores admitidos son:

  • $true: SRS vuelve a escribir los mensajes según sea necesario antes de enrutarse a través del sistema de correo electrónico local. Esta configuración requiere OnPremises para el valor ConnectorType.
  • $false: SRS no vuelve a escribir los mensajes antes de enrutarse a través del sistema de correo electrónico local. Este es el valor predeterminado.

Este parámetro solo es efectivo para los conectores OnPremises.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-SmartHosts

El parámetro SmartHosts especifica el host inteligente que el conector de salida usa para enrutar el correo. Los valores admitidos son:

  • FQDN de un servidor host inteligente, un registro de intercambio de correo (MX) o un registro de dirección (A): por ejemplo, mail.contoso.com.
  • Dirección IP única: por ejemplo, 10.10.1.1.
  • Intervalo de direcciones IP de enrutamiento entre dominios sin clase (CIDR): por ejemplo, 192.168.0.1/25.

Puede especificar varios valores separados por comas: "Value1","Value2",..."ValueN".

Este parámetro es necesario si usa el valor $false para el parámetro UseMxRecord.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-TestMode

El parámetro TestMode especifica si desea habilitar o deshabilitar el modo de prueba para el conector de salida. Los valores admitidos son:

  • $true: El modo de prueba está habilitado.
  • $false: el modo de prueba está deshabilitado. Este es el valor predeterminado.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-TlsDomain

El parámetro TlsDomain especifica el nombre de dominio que utiliza el conector de salida para verificar el FQDN del certificado de destino al establecer una conexión protegida con TLS. Un valor válido para este parámetro es un dominio SMTP.

Se admiten caracteres comodín para especificar todos los subdominios de un dominio (por ejemplo, *.contoso.com), pero no se puede insertar el carácter comodín en el dominio (por ejemplo, dominio.*.contoso.com).

Este parámetro solo es significativo cuando el valor de TlsSettings es DomainValidation.

Type:SmtpDomainWithSubdomains
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-TlsSettings

El parámetro TlsSettings especifica el nivel de autenticación de TLS que se utiliza en las conexiones de TLS salientes establecidas por este conector de salida. Los valores admitidos son:

  • EncryptionOnly: TLS sólo se utiliza para cifrar el canal de comunicación. No se realiza ninguna autenticación de certificados.
  • CertificateValidation: TLS se utiliza para cifrar el canal, y se realizan comprobaciones de las listas de validación y revocación de cadenas de certificados.
  • DomainValidation: además del cifrado de canal y la validación de certificados, el conector de salida también comprueba que el FQDN del certificado de destino coincide con el dominio especificado en el parámetro TlsDomain.
  • $null (en blanco): este es el valor predeterminado.
Type:TlsAuthLevel
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-UseMXRecord

El parámetro UseMXRecord habilita o deshabilita el enrutamiento de DNS para el conector. Los valores admitidos son:

  • $true: El conector usa el enrutamiento DNS (registros MX en DNS) para entregar correo electrónico. Este es el valor predeterminado.
  • $false: el conector entrega correo electrónico a uno o varios hosts inteligentes. Esta configuración requiere uno o más hosts inteligentes para el valor SmartHosts.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-ValidationRecipients

El parámetro ValidationRecipients especifica las direcciones de correo electrónico de los destinatarios de validación para el conector de salida. Puede especificar varias direcciones de correo electrónico separadas por comas.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-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 Online, Exchange Online Protection

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.