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.

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>]
   [-TrustedOrganizations <MultiValuedProperty>]
   [-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 restringe los dominios de origen que usan el conector a los dominios aceptados especificados. Un valor válido es un dominio SMTP configurado como dominio aceptado en la organización de Microsoft 365.

Puede especificar distintos valores separados por comas.

Type:MultiValuedProperty
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 por el servicio de atención al cliente y soporte técnico de Microsoft, 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 siguientes valores son entradas válidas para este parámetro:

  • Default: el conector se crea manualmente. Este es el valor predeterminado.
  • 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.

Se recomienda no cambiar este valor.

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 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
Required:False
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 se omitirán en Filtrado mejorado para conectores cuando se $false el valor del parámetro EFSkipLastIP. Los valores admitidos son:

  • Dirección IP única: por ejemplo, 192.168.1.1.
  • Intervalo de direcciones IP: por ejemplo, 192.168.0.1-192.168.0.254.
  • Intervalo de direcciones IP de enrutamiento entre dominios sin clase (CIDR): por ejemplo, 192.168.3.1/24.

Puede especificar distintos valores separados por comas.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
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 conectores. Los valores admitidos son:

  • $true: solo se omite el último origen del mensaje.
  • $false: omita las direcciones IP de origen especificadas por el parámetro EFSkipIPs. Si no se especifica ninguna dirección IP, el filtrado mejorado para conectores está deshabilitado en el conector. 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

-EFSkipMailGateway

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

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
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
Required:False
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 conectores. El valor predeterminado está en blanco ($null), lo que significa que el filtrado mejorado para 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Enabled

El parámetro Enabled habilita o deshabilita el conector. 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 de entrada que desea cambiar.

Type:InboundConnectorIdParameter
Position:1
Default value:None
Required:True
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-RequireTls

El parámetro RequireTLS especifica si se debe requerir la transmisión TLS para todos los mensajes recibidos por el conector. Los valores admitidos son:

  • $true: Rechazar mensajes si no se envían a través de TLS. Este es el valor predeterminado.
  • $false: permitir mensajes si no se envían a través de TLS.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-RestrictDomainsToCertificate

El parámetro RestrictDomainsToCertificate especifica si se comprueba el valor Subject del certificado TLS antes de que los mensajes puedan usar el conector. Los valores admitidos son:

  • $true: Mail solo puede usar el conector si el valor Subject del certificado TLS que el servidor de correo electrónico de origen usa para autenticar coincide con el valor del parámetro TlsSenderCertificateName.
  • $false: el valor Subject del certificado TLS que usa el servidor de correo electrónico de origen para autenticarse no controla si el correo de ese origen usa el conector. 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

-RestrictDomainsToIPAddresses

El parámetro RestrictDomainsToIPAddresses especifica si se debe rechazar el correo que procede de direcciones IP de origen desconocidas. Los valores admitidos son:

  • $true: rechace automáticamente el correo de los dominios especificados por el parámetro SenderDomains si el parámetro SenderIPAddress no especifica también la dirección IP de origen.
  • $false: no rechace automáticamente el correo de los dominios especificados por el parámetro SenderDomains en función de la dirección IP de origen. 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

-ScanAndDropRecipients

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

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

-SenderDomains

El parámetro SenderDomains especifica los dominios de origen para los que el conector acepta mensajes. Un valor válido es un dominio SMTP. Se admiten caracteres comodín para indicar un dominio y todos los subdominios (por ejemplo, *.contoso.com), pero no se puede insertar el carácter comodín (por ejemplo, domain.*.contoso.com no es válido).

Puede especificar varios dominios separados por comas.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
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 desde las que este conector acepta mensajes. Las direcciones IPv6 no se admiten. Los valores admitidos son:

  • Dirección IP única: por ejemplo, 192.168.1.1.
  • Intervalo de direcciones IP de enrutamiento entre dominios sin clase (CIDR): por ejemplo, 192.168.0.1/25. Los valores de máscara de subred válidos son /24 a /32.

Puede especificar distintos valores separados por comas.

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

-TlsSenderCertificateName

El parámetro TlsSenderCertificateName especifica el certificado TLS que se usa cuando se $true el valor del parámetro RequireTls. Un valor válido es un dominio SMTP. Se admiten caracteres comodín para indicar un dominio y todos los subdominios (por ejemplo, *.contoso.com), pero no se puede insertar el carácter comodín (por ejemplo, domain.*.contoso.com no es válido).

Type:TlsCertificate
Position:Named
Default value:None
Required:False
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 el uso de este parámetro cuando la organización local no use Exchange. Los valores admitidos 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 posibles riesgos de seguridad (por ejemplo, los mensajes internos omiten el filtrado antispam), por lo que tenga cuidado al configurar esta configuració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 configuración híbrida configura automáticamente las opciones necesarias en el conector de entrada de Microsoft 365 y el conector de envío en la organización local de Exchange (el parámetro CloudServicesMailEnabled).

Nota: Este parámetro no se puede establecer en el valor $true si se cumple alguna de las condiciones siguientes:

  • El parámetro CloudServicesMailEnabled se establece en el valor $true.
  • El valor del parámetro ConnectorType no es 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

-TrustedOrganizations

El parámetro TrustedOrganizations especifica otras organizaciones de Microsoft 365 que son orígenes de correo de confianza (por ejemplo, después de adquisiciones y fusiones). Este parámetro solo funciona para el flujo de correo entre dos organizaciones de Microsoft 365, por lo que no se usan otros parámetros.

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