Set-InboundConnector

Esse cmdlet só está disponível no serviço baseado em nuvem.

Use o cmdlet Set-InboundConnector para alterar um conector existente de entrada em sua organização baseada em nuvem. Observação : Recomendamos que você use o módulo do PowerShell v2 do Exchange Online para se conectar ao PowerShell do Exchange Online. Para obter instruções, confira Conectar-se ao PowerShell do Exchange Online (https://docs.microsoft.com/powershell/exchange/connect-to-exchange-online-powershell).

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax (https://docs.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).

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

Os conectores de entrada aceitam mensagens de email de domínios remotos que exigem opções de configuração específicas.

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Examples

Exemplo 1

Set-InboundConnector "Contoso Inbound Connector" -RequireTls $true -TlsSenderCertificateName contoso.com

Este exemplo faz as seguintes alterações na configuração no conector de entrada existente chamado Contoso.com Inbound Connector.

Requer transmissão TLS para todas as mensagens recebidas no conector.

Requer que o certificado TLS existente que é usado para criptografar comunicações contenha o nome do domínio contoso.com

Parameters

-AssociatedAcceptedDomains

O parâmetro AssociatedAcceptedDomains especifica os domínios aceitos aos quais o conector se aplica, limitando, assim, seu escopo. Por exemplo, você pode aplicar o conector a um domínio aceito específico na sua organização, 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

Observação: Recomendamos que você não use esse parâmetro, a menos que tenha sido direcionado pelo suporte e atendimento ao cliente da Microsoft ou por documentação específica do produto. Em vez disso, use o assistente de configuração híbrida para configurar o fluxo de mensagens entre suas organizações locais e na nuvem. Para mais informações, confira Assistente de Configuração Híbrida.

O parâmetro CloudServicesMailEnabled especifica se o conector é usado para fluxo de email híbrido entre um ambiente do Exchange local e o Microsoft 365. Especificamente, esse parâmetro controla como determinados cabeçalhos internos X-MS-Exchange-Organization-Organization * são tratados em mensagens que são enviadas entre domínios aceitos nas organizações locais e na nuvem. Esses cabeçalhos são conhecidos coletivamente como cabeçalhos entre locais.

Os valores válidos são:

  • $true: o conector é usado para fluxo de emails em organizações híbridas, portanto, os cabeçalhos entre locais são preservados ou promovidos em mensagens que fluem pelo conector. Este é o valor padrão para conectores criados pelo assistente de configuração híbrida. Determinados X-MS-Exchange-Organization- * Heads nas mensagens de saída enviadas de um lado da organização híbrida para o outro são convertidos em X-MS-Exchange-CrossPremises- * Headers e, portanto, são preservados em mensagens. X-MS-Exchange-CrossPremises- * headers em mensagens de entrada recebidas em um lado da organização híbrida da outra são promovidas para X-MS-Exchange-Organization- * Headers. Esses cabeçalhos promovidos substituem todas as instâncias do mesmo X-MS-Exchange-Organization- * Headers existentes nas mensagens.

  • $false: o conector não é usado para o fluxo de emails em organizações híbridas, portanto, quaisquer cabeçalhos entre locais são removidos das mensagens que fluem pelo conector.

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

O parâmetro Comment especifica um comentário opcional. Se você especificar um valor que contenha espaços, coloque-o entre aspas ("), por exemplo: “Está é uma observação de administrador”.

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

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

  • Cmdlets destrutivos (por exemplo, Remover-* cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para esses cmdlets, você pode ignorar a solicitação de confirmação usando esta sintaxe exata: -Confirm:$false.

  • A maioria dos outros cmdlets (por exemplo, New-* e Set-*) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o 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
-Connector

O parâmetro ConnectorSource especifica como o conector foi criado. A entrada válida para esse parâmetro inclui os seguintes valores:

  • Padrão: o conector é criado manualmente.

  • HybridWizard: o conector é criado automaticamente pelo assistente de configuração híbrida.

  • Migrado: o conector foi originalmente criado no Microsoft Forefront Online Protection para Exchange.

O valor padrão para conectores que você criar é Default. Não é recomendável alterar esse valor.

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

O parâmetro ConnectorType especifica uma categoria para os domínios que são servidos pelo conector. A entrada válida para esse parâmetro inclui os seguintes valores:

  • Parceiro: os domínios de serviços de conector externos à sua organização.

  • OnPremises: O conector serve os domínios que são usados por sua organização local. Use este valor em sua organização baseada em nuvem para domínios aceitos que também são especificados pelo 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

o parâmetro EFSkipIPs especifica os endereços IP de origem para ignorar a filtragem avançada de conectores quando o valor do parâmetro EFSkipLastIP é $false. Os valores válidos são:

  • Um único endereço IP: por exemplo, 192.168.1.1.

  • Um intervalo de endereços IP: por exemplo, 192.168.0.1-192.168.0.254.

  • IP CIDR (roteamento entre domínios sem classificação): por exemplo, 192.168.3.1/24

Você pode especificar vários endereços IP ou entradas de intervalo de endereços separados por vírgulas.

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

O parâmetro EFSkipIPs especifica o comportamento da filtragem avançada para conectores. Os valores válidos são:

  • $true: somente a última fonte de mensagem é ignorada.

  • $false: ignorar os endereços IP de origem especificados pelo parâmetro EFSkipIPs. Se nenhum endereço IP for especificado, a filtragem avançada para conectores estará desabilitada no conector. Esse é o valor padrão.

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

Esse parâmetro está reservado para uso interno da Microsoft.

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

Esse parâmetro está reservado para uso interno da Microsoft.

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

O parâmetro EFUsers especifica os destinatários aos quais a filtragem avançada para conectores se aplica. O valor padrão é em branco ($null), o que significa que a filtragem avançada para os conectores é aplicada a todos os destinatários.

Você pode especificar vários endereços de email de destinatários separados por vírgulas.

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

O parâmetro Enabled habilita ou desabilita o conector. A entrada válida para esse parâmetro é $true ou $false. O valor padrão é $true.

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

O parâmetro Identity especifica o conector de entrada que você deseja alterar.

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

O parâmetro Name especifica um nome descritivo para o conector.

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

O parâmetro RequireTLS especifica que todas as mensagens recebidas por esse conector exigirão transmissão TLS. Os valores válidos para esse parâmetro são $true ou $false. O valor padrão é $false. Quando o parâmetro RequireTLS for definido como $true, todas as mensagens recebidas por esse conector exigirão transmissão TLS.

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

O parâmetro RestrictDomainsToCertificate especifica que o Microsoft 365 deve identificar mensagens de entrada qualificadas para esse conector, verificando se o servidor remoto é autenticado usando um certificado TLS que tem o TlsSenderCertificateName no assunto. Os valores válidos são $true ou $false.

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

O parâmetro RestrictDomainsToIPAddresses, quando definido como $true, rejeita automaticamente emails dos domínios especificados pelo parâmetro SenderDomains, se o email tiver origem em um endereço IP não especificado pelo parâmetro SenderIPAddresses.

A entrada válida para esse parâmetro é $true ou $false. O valor padrão é $false.

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

Esse parâmetro está reservado para uso interno da Microsoft.

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

O parâmetro SenderDomains especifica os domínios remotos cujas mensagens este conector aceita, limitando, assim, seu escopo. Você pode usar um caractere curinga para especificar todos os subdomínios de um domínio especificado, conforme mostrado no exemplo a seguir: * . contoso.com. No entanto, não é possível inserir um caractere curinga, conforme mostrado no exemplo a seguir: domain. * . contoso.com.

É possível especificar vários domínios, separando-os por vírgulas.

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

O parâmetro SenderIPAddresses especifica os endereços IP IPV4 remotos dos quais esse conector aceita mensagens. Não há suporte para endereços IPv6. Para inserir os endereços IP, use esta sintaxe:

  • IP único: por exemplo, 192.168.1.1.

  • IP CIDR: você pode usar o CIDR (roteamento entre domínios sem classificação). Por exemplo, 192.168.0.1/25.

Você pode especificar vários endereços IP, separados por vírgulas.

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

O parâmetro TlsSenderCertificateName especifica o certificado usado pelo domínio do remetente quando o parâmetro RequireTls é definido como $true. A entrada válida para o parâmetro TlsSenderCertificateName é um domínio SMTP. Você pode usar um caractere curinga para especificar todos os subdomínios de um domínio especificado, conforme mostrado no exemplo a seguir: * . contoso.com.

Não é possível inserir um caractere curinga, conforme mostrado no exemplo a seguir: domain. * . 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

O parâmetro TreatMessagesAsInternal especifica um método alternativo para identificar as mensagens enviadas de uma organização local como mensagens internas. Você só deve considerar o uso desse parâmetro quando sua organização local não usa o Exchange. Os valores válidos são:

  • $true: as mensagens são consideradas internas se o domínio do remetente corresponder a um domínio configurado no Microsoft 365. Essa configuração permite o fluxo de emails internos entre o Microsoft 365 e as organizações locais que não têm o Exchange Server 2010 ou posterior instalado. No entanto, essa configuração tem possíveis riscos de segurança (por exemplo, mensagens internas ignoram a filtragem antispam), portanto, tenha cuidado ao definir essa configuração.

  • $false: as mensagens não são consideradas internas. Esse é o valor padrão.

Em ambientes híbridos, não é necessário usar esse parâmetro, porque o assistente de configuração híbrida configura automaticamente as configurações necessárias no conector de entrada no Microsoft 365 e no conector de envio na organização do Exchange local (o parâmetro CloudServicesMailEnabled).

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

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

Inputs

Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.

Outputs

Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.