Set-InboundConnector

Sintaxe

Default (Default)

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

Exemplos

Exemplo 1

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

Parâmetros

-AssociatedAcceptedDomains

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

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.

Propriedades do parâmetro

Conjuntos de parâmetros

-CloudServicesMailEnabled

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

Observação: recomendamos que você não use esse parâmetro, a menos que seja direcionado a isso pelo Suporte e Atendimento ao Cliente 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 emails 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 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 de mensagens internas X-MS-Exchange-Organization-* são tratados em mensagens 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. Esse valor é o padrã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, portanto, são preservados em 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 a cabeçalhos X-MS-Exchange-Organization-*. Esses cabeçalhos promovidos substituem quaisquer instâncias dos mesmos cabeçalhos X-MS-Exchange-Organization-* que já existem nas mensagens.
• $false: O conector não é usado para fluxo de emails em organizações híbridas, portanto, todos os cabeçalhos entre locais são removidos das mensagens que fluem pelo conector.

Propriedades do parâmetro

Conjuntos de parâmetros

-Comment

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

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

Conjuntos de parâmetros

-Confirm

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer 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 reconhecer o comando antes de continuar.

Propriedades do parâmetro

Conjuntos de parâmetros

-ConnectorSource

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

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 valor é o padrão.
• Assistente Híbrido: 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.

Propriedades do parâmetro

Conjuntos de parâmetros

-ConnectorType

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

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. Os conectores locais concedem direitos especiais a um email que corresponda ao conector e a requisitos adicionais. Por exemplo: permitir a retransmissão por meio do locatário para destinos de Internet, promover emails locais ou outros ambientes como internos (em uma configuração híbrida) ou habilitar outros fluxos de emails mais complexos.

Propriedades do parâmetro

Conjuntos de parâmetros

-EFSkipIPs

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

o parâmetro EFSkipIPs especifica os endereços IP de origem a serem ignorados na Filtragem Avançada para Conectores quando o valor do parâmetro EFSkipLastIP for $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 do Classless InterDomain Routing (CIDR): Por exemplo, 192.168.3.1/24.

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

Propriedades do parâmetro

Conjuntos de parâmetros

-EFSkipLastIP

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

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: ignore 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 valor é o padrão.

Propriedades do parâmetro

Conjuntos de parâmetros

-EFSkipMailGateway

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

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

Propriedades do parâmetro

Conjuntos de parâmetros

-EFTestMode

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

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

Propriedades do parâmetro

Conjuntos de parâmetros

-EFUsers

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

O parâmetro EFUsers especifica os destinatários aos quais a Filtragem Aprimorada para Conectores se aplica. O valor padrão é 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.

Propriedades do parâmetro

Conjuntos de parâmetros

-Enabled

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

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

• $true: O conector está habilitado. Esse valor é o padrão.
• $false: O conector está desabilitado.

Propriedades do parâmetro

Conjuntos de parâmetros

-Identity

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

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

Propriedades do parâmetro

Conjuntos de parâmetros

-Name

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

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

Propriedades do parâmetro

Conjuntos de parâmetros

-RequireTls

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

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

• $true: Rejeite mensagens se elas não forem enviadas por TLS. Esse valor é o valor padrão
• $false: Permitir mensagens se elas não forem enviadas por TLS.

Observação: este parâmetro se aplica somente aos conectores do tipo parceiro.

Propriedades do parâmetro

Conjuntos de parâmetros

-RestrictDomainsToCertificate

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

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

• $true: O Mail tem permissão para usar o conector somente se o valor Subject do certificado TLS que o servidor de email de origem usa para autenticar corresponder ao valor do parâmetro TlsSenderCertificateName.
• $false: O valor Entidade do certificado TLS que o servidor de email de origem usa para autenticar não controla se o email dessa origem usa o conector. Esse valor é o padrão.

Observação: este parâmetro se aplica somente aos conectores do tipo parceiro.

Propriedades do parâmetro

Conjuntos de parâmetros

-RestrictDomainsToIPAddresses

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

O parâmetro RestrictDomainsToIPAddresses especifica se o email deve ser rejeitado proveniente de endereços IP de origem desconhecidos para conectores do tipo parceiro. Os valores válidos são:

• $true: rejeite automaticamente emails 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 emails de domínios especificados pelo parâmetro SenderDomains com base no endereço IP de origem. Esse valor é o padrão.

Observação: este parâmetro se aplica somente aos conectores do tipo parceiro.

Propriedades do parâmetro

Conjuntos de parâmetros

-ScanAndDropRecipients

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

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

Propriedades do parâmetro

Conjuntos de parâmetros

-SenderDomains

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

O parâmetro SenderDomains especifica os domínios de origem para os quais um conector de tipo de parceiro aceita mensagens (limita o escopo de um conector de tipo de parceiro). Um valor válido é um domínio SMTP. Há suporte para caracteres curinga para indicar um domínio e todos os subdomínios (por exemplo, *.contoso.com). No entanto, não é possível 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.

Propriedades do parâmetro

Conjuntos de parâmetros

-SenderIPAddresses

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

O parâmetro SenderIPAddresses especifica os endereços IP IPV4 de origem dos quais o conector de tipo de parceiro aceita mensagens quando 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 de máscara de sub-rede são /24 a /32. @@ -435,6 +441,8 @@ Você pode especificar vários endereços IP separados por vírgulas.

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

Observação: esse parâmetro se aplica aos conectores do tipo parceiro somente se o valor do parâmetro RestrictDomainsToIPAddresses for $true.

Propriedades do parâmetro

Conjuntos de parâmetros

-TlsSenderCertificateName

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

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 caracteres curinga 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).

Propriedades do parâmetro

Conjuntos de parâmetros

-TreatMessagesAsInternal

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

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

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

Observação: você não poderá definir esse parâmetro como 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.

Propriedades do parâmetro

Conjuntos de parâmetros

-TrustedOrganizations

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

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 somente para o fluxo de emails entre duas organizações do Microsoft 365, portanto, nenhum outro parâmetro é usado.

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

Conjuntos de parâmetros

-WhatIf

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

A opção WhatIf mostra o que o comando faz sem fazer nenhuma alteração. Não é preciso especificar um valor com essa opção.

Propriedades do parâmetro

Conjuntos de parâmetros

CommonParameters

Entradas

Input types

Saídas

Output types