Partilhar via

Set-OutboundConnector

Módulo:
Exchange PowerShell

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

Use o cmdlet Set-OutboundConnector para modificar um conector de Saída existente na sua organização baseada na nuvem.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Sintaxe

Default (Default) 

Set-OutboundConnector
    [-Identity] <OutboundConnectorIdParameter>
    [-AllAcceptedDomains <Boolean>]
    [-CloudServicesMailEnabled <Boolean>]
    [-Comment <String>]
    [-Confirm]
    [-ConnectorSource <TenantConnectorSource>]
    [-ConnectorType <TenantConnectorType>]
    [-Enabled <Boolean>]
    [-IsTransportRuleScoped <Boolean>]
    [-IsValidated <Boolean>]
    [-LastValidationTimestamp <DateTime>]
    [-Name <String>]
    [-RecipientDomains <MultiValuedProperty>]
    [-RouteAllMessagesViaOnPremises <Boolean>]
    [-SenderRewritingEnabled <Boolean>]
    [-SmartHosts <MultiValuedProperty>]
    [-TestMode <Boolean>]
    [-TlsDomain <SmtpDomainWithSubdomains>]
    [-TlsSettings <TlsAuthLevel>]
    [-UseMXRecord <Boolean>]
    [-ValidationRecipients <String[]>]
    [-WhatIf]
    [<CommonParameters>]

Description

Os conectores de Saída enviam mensagens de email para domínios remotos que exigem opções de configuração específica.

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-OutboundConnector "Contoso Outbound Connector" -UseMxRecord $false -SmartHosts 192.168.0.1

Este exemplo altera as configurações do conector de Saída existente chamado Contoso Outbound Connector para direcionar para um host inteligente no endereço IP 192.168.0.1.

Parâmetros

-AllAcceptedDomains

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro AllAcceptedDomains especifica se o conector de Saída é utilizado em organizações híbridas em que os destinatários das mensagens estão em domínios aceites da organização baseada na cloud. Os valores válidos são:

  • $true: o conector de saída é utilizado em organizações híbridas quando os destinatários de mensagens estão num domínio aceite da organização baseada na cloud. Esta definição requer OnPremises para o valor ConnectorType.
  • $false: o conector de Saída não é utilizado em organizações híbridas. Este valor é a predefinição.

Este parâmetro só é eficaz para conectores 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

-CloudServicesMailEnabled

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

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, Suplemento de segurança incorporado para caixas de correio no local

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, Suplemento de segurança incorporado para caixas de correio no local

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, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro ConnectorSource especifica como o conector é criado. Os valores válidos são:

  • Predefinição: o conector é criado manualmente. Este valor é a predefinição para conectores criados manualmente e recomendamos que não altere este valor.
  • 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.

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, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro ConnectorType especifica uma categoria para os domínios que são servidos pelo conector. Os valores válidos são:

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

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

-Enabled

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro Ativado especifica se pretende ativar ou desativar o conector de Saída. 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, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro Identity especifica o conector que você deseja modificar. Use qualquer valor que identifique o conector com exclusividade. Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • GUID

Propriedades do parâmetro

Tipo:OutboundConnectorIdParameter
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

-IsTransportRuleScoped

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro IsTransportRuleScoped especifica se o conector de Saída está associado a uma regra de transporte (também conhecida como regra de fluxo de correio). Os valores válidos são:

  • $true: o conector está associado a uma regra de transporte.
  • $false: o conector não está associado a uma regra de transporte. Este valor é a predefinição.

Pode definir o âmbito de uma regra de transporte para um conector de Saída através do parâmetro RouteMessageOutboundConnector nos cmdlets New-TransportRule ou Set-TransportRule. As mensagens que correspondem às condições da regra de transporte são encaminhadas para os respetivos destinos através do conector de Saída especificado.

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

-IsValidated

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro IsValidated especifica se o conector de Saída é validado. Os valores válidos são:

  • $true: O conector é validado,
  • $false: o conector não foi validado. Este valor é a predefinição.

Utilize o cmdlet Validate-OutboundConnector para validar o 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

-LastValidationTimestamp

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro LastValidationTimestamp especifica a data/hora em que o conector de Saída foi validado.

Para especificar um valor de data/hora para este parâmetro, use uma das opções a seguir:

  • Especifique o valor de data/hora em UTC: por exemplo, "2021-05-06 14:30:00z".
  • Especifique o valor de data/hora como uma fórmula que converte a data/hora no fuso horário local para UTC: por exemplo, (Get-Date "5/6/2021 9:30 AM").ToUniversalTime(). Para mais informações, consulte Get-Date.

Utilize o cmdlet Validate-OutboundConnector para validar o conector.

Propriedades do parâmetro

Tipo:DateTime
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

-Name

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro Name especifica o nome exclusivo do conector. O tamanho máximo é de 64 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").

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

-RecipientDomains

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro RecipientDomains especifica o domínio para o qual o conector de Saída encaminha o correio. É possível especificar vários domínios, separando-os por vírgulas.

É possível usar um caractere curinga para especificar todos os subdomínios de um determinado domínio, conforme mostrado no seguinte exemplo: *.contoso.com. Entretanto, não é possível incorporar um caractere curinga, conforme mostrado no seguinte exemplo: domain.*.contoso.com.

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

-RouteAllMessagesViaOnPremises

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro RouteAllMessagesViaOnPremises especifica que todas as mensagens fornecidas por este conector são primeiro encaminhadas através do sistema de e-mail no local. Os valores válidos são:

  • $true: as mensagens são encaminhadas através do sistema de e-mail no local. Esta definição requer OnPremises para o valor ConnectorType.
  • $false: as mensagens não são encaminhadas através do sistema de e-mail no local. Este valor é a predefinição.

Este parâmetro só é eficaz para conectores 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

-SenderRewritingEnabled

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro SenderRewritingEnabled especifica que todas as mensagens que normalmente se qualificam para a reescrita SRS são reescritas para encaminhamento através do sistema de e-mail no local. Os valores válidos são:

  • $true: as mensagens são reescritas pelo SRS conforme necessário antes de serem encaminhadas através do sistema de e-mail no local. Esta definição requer OnPremises para o valor ConnectorType.
  • $false: as mensagens não são reescritas pelo SRS antes de serem encaminhadas através do sistema de e-mail no local. Este valor é a predefinição.

Este parâmetro só é eficaz para conectores 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

-SmartHosts

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro SmartHosts especifica o anfitrião inteligente que o conector de Saída utiliza para encaminhar correio. Os valores válidos são:

  • FQDN de um servidor anfitrião inteligente, um registo de troca de correio (MX) ou um registo de endereço (A): por exemplo, mail.contoso.com.
  • Endereço IP único: por exemplo, 10.10.1.1.
  • Intervalo de endereços IP cidr (roteamento entre domínios sem classificação): por exemplo, 192.168.0.1/25.

Pode especificar vários valores separados por vírgulas: "Value1","Value2",..."ValueN".

Este parâmetro é necessário se utilizar o valor $false para o parâmetro UseMxRecord.

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

-TestMode

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro TestMode especifica se pretende ativar ou desativar o modo de teste para o Conector de saída. Os valores válidos são:

  • $true: o modo de teste está ativado.
  • $false: o modo de teste está desativado. 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

-TlsDomain

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro TlsDomain especifica o nome de domínio que o conector de Saída usa para verificar o FQDN do certificado de destino ao estabelecer uma conexão TLS segura. Um valor válido para este parâmetro é um domínio SMTP.

Os carateres universais são suportados para especificar todos os subdomínios de um domínio (por exemplo, *.contoso.com), mas não pode incorporar o caráter universal no domínio (por exemplo, domínio.*.contoso.com).

Este parâmetro só é significativo quando o valor TlsSettings é DomainValidation.

Propriedades do parâmetro

Tipo:SmtpDomainWithSubdomains
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

-TlsSettings

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro TlsSettings especifica o nível de autenticação TLS que é usado para as conexões TLS de saída estabelecidas por este conector de Saída. Os valores válidos são:

  • EncryptionOnly: O TLS é usado apenas para criptografar o canal de comunicação. Nenhuma autenticação de certificado será executada.
  • CertificateValidation: O TLS é usado para criptografar o canal e certificar que as listas de validação e revogação da cadeia de certificado são executadas.
  • DomainValidation: além da encriptação de canal e da validação de certificados, o conector de Saída também verifica se o FQDN do certificado de destino corresponde ao domínio especificado no parâmetro TlsDomain.
  • $null (em branco): este valor é a predefinição.

Propriedades do parâmetro

Tipo:TlsAuthLevel
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

-UseMXRecord

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro UseMXRecord habilita ou desabilita o roteamento DNS para o conector. Os valores válidos são:

  • $true: o conector utiliza o encaminhamento DNS (registos MX no DNS) para entregar e-mails. Este valor é a predefinição.
  • $false: o conector entrega e-mails a um ou mais anfitriões inteligentes. Esta definição requer um ou mais anfitriões inteligentes para o valor SmartHosts.

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

-ValidationRecipients

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro ValidationRecipients especifica os endereços de e-mail dos destinatários de validação do conector de Saída. Você pode especificar vários endereços de email separados por vírgulas.

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

-WhatIf

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

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.