Set-OutboundConnector

O parâmetro AllAcceptedDomains especifica se o conector de saída é usado em organizações híbridas em que os destinatários de mensagens estão em domínios aceitos da organização baseada em nuvem. Os valores válidos são:

• $true: o conector de saída é usado em organizações híbridas quando os destinatários de mensagens estão em um domínio aceito da organização baseada em nuvem. Essa configuração requer OnPremises para o valor ConnectorType.
• $false: o conector de saída não é usado em organizações híbridas. Esse é o valor padrão.

Esse parâmetro é eficaz apenas para conectores OnPremises.

Observação: recomendamos que você não use esse parâmetro, a menos que seja direcionado a fazê-lo por Microsoft Serviço ao Cliente e suporte, ou por 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 do Exchange local e 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.

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

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.

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

• Padrão: o conector é criado manualmente. Esse é o valor padrão para conectores criados manualmente e recomendamos que você não altere esse valor.
• 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.

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

O parâmetro Habilitado especifica se é possível habilitar ou desabilitar o conector de saída. Os valores válidos são:

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

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

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 email). 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. Esse é o valor padrão.

Você escopo uma regra de transporte para um conector de saída usando o parâmetro RouteMessageOutboundConnector nos cmdlets New-TransportRule ou Set-TransportRule. As mensagens que correspondem às condições da regra de transporte são roteadas para seus destinos usando o conector de saída especificado.

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

• $true: o conector foi validado,
• $false: o conector não foi validado. Esse é o valor padrão.

Use o cmdlet Validate-OutboundConnector para validar o conector.

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 em UTC: Por exemplo, (Get-Date "5/6/2021 9:30 AM").ToUniversalTime(). Para mais informações, consulte Get-Date.

Use o cmdlet Validate-OutboundConnector para validar o conector.

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 (").

O parâmetro RecipientDomains especifica o domínio para o qual o conector de saída roteia o email. É 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.

O parâmetro RouteAllMessagesViaOnPremises especifica que todas as mensagens atendidas por esse conector são roteadas pela primeira vez por meio do sistema de email local. Os valores válidos são:

• $true: as mensagens são roteadas pelo sistema de email local. Essa configuração requer OnPremises para o valor ConnectorType.
• $false: as mensagens não são roteadas pelo sistema de email local. Esse é o valor padrão.

Esse parâmetro é eficaz apenas para conectores OnPremises.

O parâmetro SenderRewritingEnabled especifica que todas as mensagens que normalmente se qualificam para reescrita do SRS são reescritas para roteamento por meio do sistema de email local. Os valores válidos são:

• $true: as mensagens são reescritas pelo SRS conforme necessário antes de serem roteadas pelo sistema de email local. Essa configuração requer OnPremises para o valor ConnectorType.
• $false: as mensagens não são reescritas pelo SRS antes de serem roteadas pelo sistema de email local. Esse é o valor padrão.

Esse parâmetro é eficaz apenas para conectores OnPremises.

O parâmetro SmartHosts especifica o host inteligente que o conector de saída usa para rotear emails. Os valores válidos são:

• FQDN de um servidor host inteligente, um registro MX (troca de emails) ou um registro 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 interdomínio sem classe): por exemplo, 192.168.0.1/25.

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

Esse parâmetro será necessário se você usar o valor $false para o parâmetro UseMxRecord.

O parâmetro TestMode especifica se você deseja habilitar ou desabilitar o modo de teste para o conector de saída. Os valores válidos são:

• $true: o modo de teste está habilitado.
• $false: o modo de teste está desabilitado. Esse é o valor padrão.

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 esse parâmetro é um domínio SMTP.

Há suporte para curingas para especificar todos os subdomínios de um domínio (por exemplo, *.contoso.com), mas você não pode inserir o caractere curinga dentro do domínio (por exemplo, domain.*.contoso.com).

Esse parâmetro é significativo somente quando o valor TlsSettings é DomainValidation.

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 criptografia de canal e validação de certificado, 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): esse é o valor padrão.

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

• $true: o conector usa o roteamento DNS (registros MX no DNS) para entregar email. Esse é o valor padrão.
• $false: o conector fornece email para um ou mais hosts inteligentes. Essa configuração requer um ou mais hosts inteligentes para o valor SmartHosts.

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

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.