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.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte 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>]
   [-TrustedOrganizations <MultiValuedProperty>]
   [-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.

Exemplos

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

Parâmetros

-AssociatedAcceptedDomains

O parâmetro AssociatedAcceptedDomains restringe os domínios de origem que usam o conector aos domínios aceitos especificados. Um valor válido é um domínio SMTP configurado como um domínio aceito em sua organização do Microsoft 365.

Vários valores, separados por vírgulas, podem ser especificados.

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

Observação: recomendamos que você não use esse parâmetro a menos que seja direcionado para isso pelo Serviço de Cliente e Suporte da Microsoft ou pela documentação específica do produto. Em vez disso, use o assistente de Configuração Híbrida para configurar o fluxo de email entre suas organizações locais e de nuvem. Para mais informações, confira Assistente de Configuração Híbrida.

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

Os valores válidos são:

  • $true: o conector é usado para o fluxo de email em organizações híbridas, portanto, cabeçalhos entre locais são preservados ou promovidos em mensagens que fluem pelo conector. Esse é o valor padrão para conectores criados pelo assistente de Configuração Híbrida. Certos cabeçalhos X-MS-Exchange-Organization-* em mensagens de saída enviadas de um lado da organização híbrida para o outro são convertidos em cabeçalhos X-MS-Exchange-CrossPremises-* e, assim, são preservados em mensagens. Cabeçalhos X-MS-Exchange-CrossPremises-* em mensagens de entrada recebidas de um lado da organização híbrida do outro são promovidos a cabeçalhos X-MS-Exchange-Organization-*. Esses cabeçalhos promovidos substituem todas as instâncias dos mesmos cabeçalhos X-MS-Exchange-Organization-* que já existem nas mensagens.
  • $false: o conector não é usado para o fluxo de email em organizações híbridas, portanto, todos os cabeçalhos entre locais são removidos das mensagens que fluem pelo 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

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
Required:False
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, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, cmdlets 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-ConnectorSource

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

  • Padrão: o conector é criado manualmente. Esse é o valor padrão.
  • HybridWizard: o conector é criado automaticamente pelo Assistente de Configuração Híbrida.
  • Migrado: o conector foi originalmente criado no Microsoft Forefront Online Protection for Exchange.

Recomendamos que você não altere esse 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

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 do conector que são 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
Required:False
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 a serem ignorados na Filtragem Aprimorada para Conectores quando o valor do parâmetro EFSkipLastIP é $false. Os valores válidos são:

  • Endereço IP único: por exemplo, 192.168.1.1.
  • Intervalo de endereços IP: por exemplo, 192.168.0.1-192.168.0.254.
  • Intervalo de endereços IP cidr (roteamento interdomínio sem classe): por exemplo, 192.168.3.1/24.

Vários valores, separados por vírgulas, podem ser especificados.

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

O parâmetro EFSkipIPs especifica o comportamento da Filtragem Aprimorada 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 Aprimorada para Conectores será desabilitada no conector. Esse é o valor padrão.
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

Esse parâmetro está reservado para uso interno da 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

Esse parâmetro está reservado para uso interno da 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

O parâmetro EFUsers especifica os destinatários aos quais a Filtragem Aprimorada para Conectores se aplica. O valor padrão está em branco ($null), o que significa que a Filtragem Aprimorada para 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Enabled

O parâmetro Enabled habilita ou desabilita o conector. Os valores válidos são:

  • $true: o conector está habilitado. Esse é o valor padrão.
  • $false: o conector está desabilitado.
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

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

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

O parâmetro Name especifica um nome descritivo para o 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

O parâmetro RequireTLS especifica se é necessário exigir transmissão TLS para todas as mensagens recebidas pelo conector. Os valores válidos são:

  • $true: rejeite as mensagens se elas não forem enviadas pelo TLS. Este é o valor padrão
  • $false: permitir mensagens se elas não forem enviadas pelo 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

O parâmetro RestrictDomainsToCertificate especifica se o valor assunto do certificado TLS é verificado antes que as mensagens possam usar o conector. Os valores válidos são:

  • $true: o email só poderá usar o conector se o valor assunto do certificado TLS usado pelo servidor de email de origem para autenticar corresponder ao valor do parâmetro TlsSenderCertificateName.
  • $false: o valor de assunto do certificado TLS que o servidor de email de origem usa para autenticar não controla se o email dessa fonte usa o conector. Esse é o valor padrão.
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

O parâmetro RestrictDomainsToIPAddresses especifica se é necessário rejeitar emails provenientes de endereços IP de origem desconhecidos. Os valores válidos são:

  • $true: rejeite automaticamente o email de domínios especificados pelo parâmetro SenderDomains se o endereço IP de origem também não for especificado pelo parâmetro SenderIPAddress.
  • $false: não rejeite automaticamente o email de domínios especificados pelo parâmetro SenderDomains com base no endereço IP de origem. Esse é o valor padrão.
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

Esse parâmetro está reservado para uso interno da 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

O parâmetro SenderDomains especifica os domínios de origem para os quais o conector aceita mensagens. Um valor válido é um domínio SMTP. Há suporte para curingas para indicar um domínio e todos os subdomínios (por exemplo, *.contoso.com), mas você não pode inserir o caractere curinga (por exemplo, domain.*.contoso.com não é válido).

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

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

O parâmetro SenderIPAddresses especifica os endereços IP IP ip remotos do qual esse conector aceita mensagens. Não há suporte para endereços IPv6. Os valores válidos são:

  • Endereço IP único: por exemplo, 192.168.1.1.
  • Intervalo de endereços IP cidr (roteamento interdomínio sem classe): por exemplo, 192.168.0.1/25. Os valores válidos da máscara de sub-rede são de /24 a /32.

Vários valores, separados por vírgulas, podem ser especificados.

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

O parâmetro TlsSenderCertificateName especifica o certificado TLS usado quando o valor do parâmetro RequireTls é $true. Um valor válido é um domínio SMTP. Há suporte para curingas para indicar um domínio e todos os subdomínios (por exemplo, *.contoso.com), mas você não pode inserir o caractere curinga (por exemplo, domain.*.contoso.com não é 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

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

  • $true: as mensagens serã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 email interno entre o Microsoft 365 e organizações locais que não têm Exchange Server 2010 ou posterior instalado. No entanto, essa configuração tem potenciais riscos de segurança (por exemplo, mensagens internas ignoram a filtragem antispam), portanto, tenha cuidado ao configurar essa configuração.
  • $false: as mensagens não são consideradas internas. Esse é o valor padrão.

Em ambientes híbridos, você não precisa usar esse parâmetro, pois o assistente de Configuração Híbrida configura automaticamente configura as configurações necessárias no conector de entrada no Microsoft 365 e no conector Enviar na organização local do Exchange (o parâmetro CloudServicesMailEnabled).

Observação: você não pode definir esse parâmetro para o valor $true se uma das seguintes condições for verdadeira:

  • O parâmetro CloudServicesMailEnabled é definido como o valor $true.
  • O valor do parâmetro ConnectorType não é 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

O parâmetro TrustedOrganizations especifica outras organizações do Microsoft 365 que são fontes de email confiáveis (por exemplo, após aquisições e fusões). Esse parâmetro funciona apenas para o fluxo de email entre duas organizações do Microsoft 365, portanto, nenhum outro parâmetro é usado.

Para inserir vários valores e substituir quaisquer entradas existentes, use a seguinte sintaxe: Value1,Value2,...ValueN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".

Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{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

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
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

Entradas

Input types

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.

Saídas

Output types

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.