Compartilhar via


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.

Sintaxe

Default (Padrão)

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 artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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

Aplicável: Exchange Online, Proteção do Exchange Online

O parâmetro AssociatedAcceptedDomains restringe os domínios de origem que utilizam o conector para os domínios aceites especificados. Um valor válido é um domínio SMTP configurado como um domínio aceite na sua organização do Microsoft 365.

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

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-CloudServicesMailEnabled

Aplicável: Exchange Online, Proteção do Exchange Online

Nota: recomendamos que não utilize este parâmetro, a menos que seja direcionado para o fazer pelo Suporte e Suporte ao Cliente da Microsoft ou por documentação específica do produto. Em vez disso, utilize o assistente de Configuração Híbrida para configurar o fluxo de correio entre as organizações no local e na cloud. Para mais informações, confira Assistente de Configuração Híbrida.

O parâmetro CloudServicesMailEnabled especifica se o conector é utilizado para o fluxo de correio híbrido entre um ambiente do Exchange no local e o Microsoft 365. Especificamente, este parâmetro controla a forma como determinados cabeçalhos de mensagens internos X-MS-Exchange-Organization-* são processados em mensagens enviadas entre domínios aceites nas organizações no local e na cloud. Estes cabeçalhos são coletivamente conhecidos como cabeçalhos em vários locais.

Os valores válidos são:

  • $true: o conector é utilizado para o fluxo de correio em organizações híbridas, pelo que os cabeçalhos em vários locais são preservados ou promovidos em mensagens que fluem através do conector. Este valor é a predefinição para conectores criados pelo assistente de Configuração Híbrida. Determinados 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 são assim preservados nas mensagens. Os cabeçalhos X-MS-Exchange-CrossPremises-* em mensagens de entrada recebidas de um lado da organização híbrida do outro são promovidos para cabeçalhos X-MS-Exchange-Organization-*. Estes 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 é utilizado para o fluxo de correio em organizações híbridas, pelo que todos os cabeçalhos em vários locais são removidos das mensagens que fluem através do conector.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Comment

Aplicável: Exchange Online, Proteção do Exchange Online

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

Aplicável: Exchange Online, Proteção do Exchange Online

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 estes cmdlets, você pode pular o pedido 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.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ConnectorSource

Aplicável: Exchange Online, Proteção do Exchange Online

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

  • Predefinição: o conector é criado manualmente. Este valor é a predefinição.
  • 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.

Recomendamos que não altere este valor.

Propriedades do parâmetro

Tipo:TenantConnectorSource
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ConnectorType

Aplicável: Exchange Online, Proteção do Exchange Online

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 dos serviços de conectores externos à sua organização.
  • OnPremises: O conector serve os domínios que são usados por sua organização local. Os conectores OnPremises concedem direitos especiais a um e-mail que corresponda ao conector e aos requisitos adicionais. Por exemplo: permitir o reencaminhamento através do inquilino para destinos da Internet, promover e-mails a partir do local ou de outros ambientes como internos (numa configuração híbrida) ou ativar outros fluxos de correio mais complexos.

Propriedades do parâmetro

Tipo:TenantConnectorType
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-EFSkipIPs

Aplicável: Exchange Online, Proteção do Exchange Online

o parâmetro EFSkipIPs especifica os endereços IP de origem a ignorar na Filtragem Avançada 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 de Encaminhamento InterDomínio Sem Classe (CIDR): por exemplo, 192.168.3.1/24.

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

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-EFSkipLastIP

Aplicável: Exchange Online, Proteção do Exchange Online

O parâmetro EFSkipIPs especifica o comportamento da Filtragem Avançada para Conectores. Os valores válidos são:

  • $true: apenas a última origem da mensagem é ignorada.
  • $false: ignore os endereços IP de origem especificados pelo parâmetro EFSkipIPs. Se não forem especificados endereços IP, a Filtragem Avançada para Conectores será desativada no conector. Este valor é a predefinição.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-EFSkipMailGateway

Aplicável: Exchange Online, Proteção do Exchange Online

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

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-EFTestMode

Aplicável: Exchange Online, Proteção do Exchange Online

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

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-EFUsers

Aplicável: Exchange Online, Proteção do Exchange Online

O parâmetro EFUsers especifica os destinatários aos quais se aplica a Filtragem Avançada para Conectores. O valor predefinido está em branco ($null), o que significa que a Filtragem Avançada de Conectores é aplicada a todos os destinatários.

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

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Enabled

Aplicável: Exchange Online, Proteção do Exchange Online

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

  • $true: o conector está ativado. Este valor é a predefinição.
  • $false: o conector está desativado.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Identity

Aplicável: Exchange Online, Proteção do Exchange Online

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

Propriedades do parâmetro

Tipo:InboundConnectorIdParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Name

Aplicável: Exchange Online, Proteção do Exchange Online

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RequireTls

Aplicável: Exchange Online, Proteção do Exchange Online

O parâmetro RequireTLS especifica se deve exigir a transmissão TLS para todas as mensagens recebidas por um conector de Tipo de parceiro. Os valores válidos são:

  • $true: rejeitar mensagens se não forem enviadas através do TLS. Este valor é a predefinição
  • $false: permitir mensagens se não forem enviadas através do TLS.

Nota: este parâmetro aplica-se apenas aos conectores do Tipo de parceiro.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RestrictDomainsToCertificate

Aplicável: Exchange Online, Proteção do Exchange Online

O parâmetro RestrictDomainsToCertificate especifica se o valor Do Requerente do certificado TLS é verificado antes de as mensagens poderem utilizar o conector do Tipo de parceiro. Os valores válidos são:

  • $true: o Correio só pode utilizar o conector se o valor Assunto do certificado TLS que o servidor de e-mail de origem utiliza para autenticar corresponder ao valor do parâmetro TlsSenderCertificateName.
  • $false: o valor assunto do certificado TLS que o servidor de e-mail de origem utiliza para autenticar não controla se o correio dessa origem utiliza o conector. Este valor é a predefinição.

Nota: este parâmetro aplica-se apenas aos conectores do Tipo de parceiro.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RestrictDomainsToIPAddresses

Aplicável: Exchange Online, Proteção do Exchange Online

O parâmetro RestrictDomainsToIPAddresses especifica se pretende rejeitar correio proveniente de endereços IP de origem desconhecidos para conectores de tipo de parceiro. Os valores válidos são:

  • $true: rejeite automaticamente o correio de domínios especificados pelo parâmetro SenderDomains se o endereço IP de origem não for também especificado pelo parâmetro SenderIPAddress.
  • $false: não rejeite automaticamente o correio de domínios especificados pelo parâmetro SenderDomains com base no endereço IP de origem. Este valor é a predefinição.

Nota: este parâmetro aplica-se apenas aos conectores do Tipo de parceiro.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ScanAndDropRecipients

Aplicável: Exchange Online, Proteção do Exchange Online

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

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SenderDomains

Aplicável: Exchange Online, Proteção do Exchange Online

O parâmetro SenderDomains especifica os domínios de origem para os quais um conector de Tipo de parceiro aceita mensagens (limita o âmbito de um conector de Tipo de parceiro). Um valor válido é um domínio SMTP. Os carateres universais são suportados para indicar um domínio e todos os subdomínios (por exemplo, *.contoso.com). No entanto, não pode incorporar o caráter universal (por exemplo, ___domain.*.contoso.com não é válido).

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

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SenderIPAddresses

Aplicável: Exchange Online, Proteção do Exchange Online

O parâmetro SenderIPAddresses especifica os endereços IP IPV4 de origem que o conector tipo de parceiro aceita mensagens a partir do momento em que o valor do parâmetro RestrictDomainsToIPAddresses é $true. Os valores válidos são:

  • Endereço IP único: por exemplo, 192.168.1.1.
  • Intervalo de endereços IP cidr (roteamento entre domínios sem classificação): por exemplo, 192.168.0.1/25. Os valores válidos da máscara de sub-rede são /24 a /32. @@ -435,6 +441,8 @@ Pode especificar vários endereços IP separados por vírgulas.

Não há suporte para endereços IPv6.

Nota: este parâmetro aplica-se apenas aos conectores do Tipo de parceiro se o valor do parâmetro RestrictDomainsToIPAddresses for $true.

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-TlsSenderCertificateName

Aplicável: Exchange Online, Proteção do Exchange Online

O parâmetro TlsSenderCertificateName especifica o certificado TLS utilizado quando o valor do parâmetro RequireTls é $true. Um valor válido é um domínio SMTP. Os carateres universais são suportados para indicar um domínio e todos os subdomínios (por exemplo, *.contoso.com), mas não pode incorporar o caráter universal (por exemplo, domínio.*.contoso.com não é válido).

Propriedades do parâmetro

Tipo:TlsCertificate
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-TreatMessagesAsInternal

Aplicável: Exchange Online, Proteção do Exchange Online

O parâmetro TreatMessagesAsInternal especifica um método alternativo para identificar mensagens enviadas de uma organização no local como mensagens internas. Só deve considerar a utilização deste parâmetro quando a sua organização no local não utilizar 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. Esta definição permite o fluxo de correio interno entre o Microsoft 365 e as organizações no local que não têm Exchange Server 2010 ou posterior instalado. No entanto, esta definição tem potenciais riscos de segurança (por exemplo, as mensagens internas ignoram a filtragem antispam), por isso, tenha cuidado ao configurar esta definição.
  • $false: as mensagens não são consideradas internas. Este valor é a predefinição.

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

Nota: não pode definir este parâmetro para o valor $true se uma das seguintes condições for verdadeira:

  • O parâmetro CloudServicesMailEnabled está definido como o valor $true.
  • O valor do parâmetro ConnectorType não é OnPremises.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-TrustedOrganizations

Aplicável: Exchange Online, Proteção do Exchange Online

O parâmetro TrustedOrganizations especifica outras organizações do Microsoft 365 que são origens de correio fidedignas (por exemplo, após aquisições e fusões). Este parâmetro funciona apenas para o fluxo de correio entre duas organizações do Microsoft 365, pelo que não são utilizados outros parâmetros.

Para inserir vários valores e substituir as 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"...}.

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

Aplicável: Exchange Online, Proteção do Exchange Online

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.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.

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.