Set-InboundConnector

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

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

Nota: Se recomienda que use el módulo de Exchange Online PowerShell V2 para conectarse a Exchange Online PowerShell. Para obtener instrucciones, consulte Conexión a Exchange Online PowerShell.

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-InboundConnector
   [-Identity] <InboundConnectorIdParameter>
   [-AssociatedAcceptedDomains <MultiValuedProperty>]
   [-CloudServicesMailEnabled <Boolean>]
   [-Comment <String>]
   [-Confirm]
   [-ConnectorSource <TenantConnectorSource>]
   [-ConnectorType <TenantConnectorType>]
   [-EFSkipIPs <MultiValuedProperty>]
   [-EFSkipLastIP <Boolean>]
   [-EFSkipMailGateway <MultiValuedProperty>]
   [-EFTestMode <Boolean>]
   [-EFUsers <MultiValuedProperty>]
   [-Enabled <Boolean>]
   [-Name <String>]
   [-RequireTls <Boolean>]
   [-RestrictDomainsToCertificate <Boolean>]
   [-RestrictDomainsToIPAddresses <Boolean>]
   [-ScanAndDropRecipients <MultiValuedProperty>]
   [-SenderDomains <MultiValuedProperty>]
   [-SenderIPAddresses <MultiValuedProperty>]
   [-TlsSenderCertificateName <TlsCertificate>]
   [-TreatMessagesAsInternal <Boolean>]
   [-WhatIf]
   [<CommonParameters>]

Description

Los conectores de entrada aceptan mensajes de correo electrónico de dominios remotos que requieren opciones específicas de configuración.

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-InboundConnector "Contoso Inbound Connector" -RequireTls $true -TlsSenderCertificateName contoso.com

En este ejemplo se realizan los siguientes cambios de configuración al conector de entrada existente denominado Contoso.com Inbound Connector.

Se requiere transmisión de TLS para todos los mensajes entrantes en el conector.

Se requiere que el certificado TLS que se usa para cifrar comunicaciones contenga el nombre de dominio contoso.com

Parámetros

-AssociatedAcceptedDomains

El parámetro AssociatedAcceptedDomains especifica los dominios aceptados a los que se aplica el conector, limitando así su ámbito. Por ejemplo, puede aplicar el conector a un dominio específico aceptado en su organización, como contoso.com.

Type:MultiValuedProperty
Position:Named
Default value:None
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 el servicio de atención al cliente de Microsoft y la documentación específica del producto. En su lugar, use el Asistente para la configuración híbrida para configurar el flujo de correo entre las organizaciones locales y las de 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 la forma en que se controlan determinados encabezados X-MS-Exchange-Organization- * Message 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 válidos son:

  • $true: el conector se usa para el flujo de correo en organizaciones híbridas, de modo que los encabezados entre locales se conservan o se promocionan en mensajes que fluyen a través del conector. Este es el valor predeterminado para los conectores que crea el Asistente para la configuración híbrida. Algunos encabezados X-MS-Exchange-Organization-Organization * en los mensajes salientes que se envían desde un lado de la organización híbrida a otro se convierten en X-MS-Exchange-CrossPremises- * headers y, por lo tanto, se conservan en los mensajes. X-MS-Exchange-CrossPremises- * headers en los mensajes entrantes que se reciben en un lado de la organización híbrida desde el otro se promueve a X-MS-Exchange-Organization- * headers. Estos encabezados promovidos sustituyen a todas las instancias de los mismos encabezados X-MS-Exchange-Organization-Organization * que ya existen en los mensajes.
  • $false: el conector no se usa para el flujo de correo en organizaciones híbridas, de modo que los encabezados entre locales se quitan de los mensajes que fluyen a través del conector.
Type:Boolean
Position:Named
Default value:None
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
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, los cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir la solicitud de confirmación con esta sintaxis exacta: -Confirm:$false .
  • La mayoría de los otros cmdlets (por ejemplo, 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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-ConnectorSource

El parámetro ConnectorSource especifica cómo se creó el conector. Los siguientes valores son entradas válidas para este parámetro:

  • Default: el conector se crea manualmente.
  • HybridWizard: el Asistente para la configuración híbrida crea automáticamente el conector.
  • Migrated: el conector se creó originalmente en Microsoft Forefront Online Protection para Exchange.

El valor predeterminado para los conectores creados es Default. No se recomienda cambiar este valor.

Type:TenantConnectorSource
Position:Named
Default value:None
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 siguientes valores son entradas válidas para este parámetro:

  • 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. Use este valor para dominios aceptados en la organización basada en la nube, que siempre se especifican con el parámetro SenderDomains.
Type:TenantConnectorType
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-EFSkipIPs

el parámetro EFSkipIPs especifica las direcciones IP de origen que deben omitirse en el filtrado mejorado para los conectores cuando el valor del parámetro EFSkipLastIP es $false. Los valores válidos son:

  • Una dirección IP única: por ejemplo, 192.168.1.1.
  • Un intervalo de direcciones IP: por ejemplo, 192.168.0.1-192.168.0.254.
  • IP de enrutamiento de Inter-Domain sin clases (CIDR): por ejemplo, 192.168.3.1/24

Puede especificar varias direcciones IP o entradas de intervalo de direcciones separadas por comas.

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

El parámetro EFSkipIPs especifica el comportamiento del filtrado mejorado para los conectores. Los valores válidos son:

  • $true: solo se omite el último origen del mensaje.
  • $false: omitir las direcciones IP de origen especificadas por el parámetro EFSkipIPs. Si no se especifican direcciones IP, el filtrado mejorado para los conectores está deshabilitado en el conector. Este es el valor predeterminado.
Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-EFSkipMailGateway

Este parámetro está reservado para uso interno de Microsoft.

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

Este parámetro está reservado para uso interno de Microsoft.

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

El parámetro EFUsers especifica los destinatarios a los que se aplica el filtrado mejorado para los conectores. El valor predeterminado está en blanco ($null), lo que significa que el filtrado mejorado para los conectores se aplica a todos los destinatarios.

Puede especificar varias direcciones de correo electrónico de destinatarios separadas por comas.

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

El parámetro Enabled habilita o deshabilita el conector. La entrada válida para este parámetro es $true o $false. El valor predeterminado es $true.

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

El parámetro Identity especifica el conector de entrada que desea cambiar.

Type:InboundConnectorIdParameter
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-Name

El parámetro Name especifica un nombre descriptivo para el conector.

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

El parámetro RequireTLS especifica que todos los mensajes que recibe este conector requieren una transmisión TLS. Los valores válidos para este parámetro son $true o $false. El valor predeterminado es $false. Cuando el parámetro RequireTLS se establece en $true, todos los mensajes recibidos por este conector requieren una transmisión TLS.

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

El parámetro RestrictDomainsToCertificate especifica que Microsoft 365 debe identificar los mensajes entrantes válidos para este conector comprobando que el servidor remoto autentica mediante un certificado TLS que tenga el TlsSenderCertificateName en el asunto. Los valores válidos son $true o $false.

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

El parámetro RestrictDomainsToIPAddresses, si se establece en $true, acepta o rechaza automáticamente correos de los dominios especificados por el parámetro SenderDomains si el correo se origina desde una dirección IP no especificada en el parámetro SenderIPAddresses.

La entrada válida para este parámetro es $true o $false. El valor predeterminado es $false.

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

Este parámetro está reservado para uso interno de Microsoft.

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

El parámetro SenderDomains especifica los dominios remotos desde los que el conector acepta mensajes, limitando así su ámbito. Puede usar un carácter comodín para especificar todos los subdominios de un dominio especificado, 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: dominio. * . contoso.com.

Puede especificar varios dominios separados por comas.

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

El parámetro SenderIPAddresses especifica las direcciones IP IPV4 remotas de las que este conector acepta mensajes. Las direcciones IPv6 no se admiten. Para especificar las direcciones IP, use la sintaxis siguiente:

  • IP única: por ejemplo, 192.168.1.1.
  • IP CIDR: puede usar enrutamiento de interdominios sin clases (CIDR). Por ejemplo, 192.168.0.1/25.

Puede especificar varias direcciones IP separadas por comas.

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

El parámetro TlsSenderCertificateName especifica el certificado que utiliza el dominio del remitente cuando el parámetro RequireTls está establecido en $true. La entrada válida del parámetro TlsSenderCertificateName es un dominio SMTP. Puede usar un carácter comodín para especificar todos los subdominios de un dominio especificado, como se muestra en el siguiente ejemplo: * . contoso.com.

No puede insertar un carácter comodín, como se muestra en el ejemplo siguiente: dominio. * . contoso.com.

Type:TlsCertificate
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-TreatMessagesAsInternal

El parámetro TreatMessagesAsInternal especifica un método alternativo para identificar los mensajes enviados desde una organización local como mensajes internos. Solo debe considerar la posibilidad de usar este parámetro cuando la organización local no usa Exchange. Los valores válidos son:

  • $true: los mensajes se consideran internos si el dominio del remitente coincide con un dominio configurado en Microsoft 365. Esta configuración permite el flujo de correo interno entre Microsoft 365 y las organizaciones locales que no tienen instalado Exchange Server 2010 o posterior. Sin embargo, esta configuración tiene riesgos de seguridad potenciales (por ejemplo, los mensajes internos pasan por alto el filtrado contra correo no deseado), por lo que debe tener cuidado al configurar esta opción.
  • $false: los mensajes no se consideran internos. Este es el valor predeterminado.

En entornos híbridos, no es necesario usar este parámetro, ya que el Asistente para la configuración híbrida configura automáticamente la configuración necesaria en el conector de entrada de Microsoft 365 y el conector de envío en la organización de Exchange local (el parámetro CloudServicesMailEnabled).

Nota: no puede establecer este parámetro en el valor $true si alguna de las siguientes condiciones es verdadera:

  • El parámetro CloudServicesMailEnabled se establece en el valor $true.
  • El valor del parámetro ConnectorType no es local.
Type:Boolean
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

Entradas

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

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.