Set-OutboundConnector

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>]
    [-MtaStsMode <MtaStsMode>]
    [-Name <String>]
    [-RecipientDomains <MultiValuedProperty>]
    [-RouteAllMessagesViaOnPremises <Boolean>]
    [-SenderRewritingEnabled <Boolean>]
    [-SmartHosts <MultiValuedProperty>]
    [-SmtpDaneMode <SmtpDaneMode>]
    [-TestMode <Boolean>]
    [-TlsDomain <SmtpDomainWithSubdomains>]
    [-TlsSettings <TlsAuthLevel>]
    [-UseMXRecord <Boolean>]
    [-ValidationRecipients <String[]>]
    [-WhatIf]
    [<CommonParameters>]

Description

Exemplos

Exemplo 1

Set-OutboundConnector "Contoso Outbound Connector" -UseMxRecord $false -SmartHosts 192.168.0.1

Parâmetros

-AllAcceptedDomains

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

O parâmetro AllAcceptedDomains especifica se o conector de saída é usado em organizações híbridas onde os destinatários das 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 da mensagem 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 valor é o padrão.

Esse parâmetro é eficaz somente para conectores locais.

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. Os valores válidos são:

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

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

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 especifica se o conector de saída deve ser habilitado. 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 que você deseja modificar. Use qualquer valor que identifique o conector com exclusividade. Por exemplo:

• Nome
• DN (nome diferenciado)
• GUID

Propriedades do parâmetro

Conjuntos de parâmetros

-IsTransportRuleScoped

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

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

Você define o escopo de 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.

Propriedades do parâmetro

Conjuntos de parâmetros

-IsValidated

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

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

Use o cmdlet Validate-OutboundConnector para validar o conector.

Propriedades do parâmetro

Conjuntos de parâmetros

-LastValidationTimestamp

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

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.

Propriedades do parâmetro

Conjuntos de parâmetros

-MtaStsMode

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

O parâmetro MtaStsMode fornece controle do administrador sobre a validação MTA-STS (Segurança de Transporte Estrito do MTA) de saída para emails enviados pelo conector de saída. As organizações podem escolher com que rigor aplicar o MTA-STS ao enviar emails para domínios externos. Os valores válidos são:

• Oportunista: esse valor é o padrão. O conector usa o MTA-STS de forma oportunista.

  • Se o domínio de destino não for compatível com MTA-STS, a mensagem será enviada usando as configurações do conector ou as configurações padrão do Exchange Online.

  • Se o domínio de destino oferecer suporte a MTA-STS, mas a validação falhar enquanto o modo de política estiver definido como Impor, o Exchange Online colocará a mensagem na fila e tentará repetir a entrega por 24 horas. Se a validação não for aprovada dentro de 24 horas, a mensagem será descartada.

• Nenhum: as mensagens sempre tentam ser entregues sem verificar o MTA-STS. A segurança dos emails enviados pelo conector é reduzida (não é possível proteger contra ataques de downgrade ou redirecionamento MX falsificado). Esse valor pode resultar em mensagens desse conector sendo interceptadas ou redirecionadas para entidades mal-intencionadas.

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 o nome exclusivo para o conector. O tamanho máximo é de 64 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").

Propriedades do parâmetro

Conjuntos de parâmetros

-RecipientDomains

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

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

Conjuntos de parâmetros

-RouteAllMessagesViaOnPremises

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

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

• $true: As mensagens são roteadas por meio do 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 valor é o padrão.

Esse parâmetro é eficaz somente para conectores locais.

Propriedades do parâmetro

Conjuntos de parâmetros

-SenderRewritingEnabled

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

O parâmetro SenderRewritingEnabled especifica que todas as mensagens que normalmente se qualificam para reescrita de 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 valor é o padrão.

Esse parâmetro é eficaz somente para conectores locais.

Propriedades do parâmetro

Conjuntos de parâmetros

-SmartHosts

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

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 mensagens) 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 entre domínios sem classificação): 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.

Propriedades do parâmetro

Conjuntos de parâmetros

-SmtpDaneMode

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

O parâmetro SmtpDaneMode fornece controle de administrador sobre a validação de Autenticação de Entidades Nomeadas (DANE) baseada em DNS SMTP de saída para email enviado pelo conector de saída. As organizações podem escolher com que rigor aplicar o SMTP DANE ao enviar emails para domínios externos. Os valores válidos são:

• Oportunista: esse valor é o padrão. O conector usa SMTP DANE com DNSSEC oportunisticamente em mensagens enviadas por meio do conector.

  • Se o domínio de destino não der suporte a SMTP DANE com DNSSEC, a mensagem será enviada usando as configurações do conector ou as configurações padrão do Exchange Online.

  • Se o domínio de destino oferecer suporte a SMTP DANE com DNSSEC, mas as validações de DNSSEC ou SMTP DANE falharem, o Exchange Online colocará a mensagem na fila e tentará repetir a entrega por 24 horas enquanto tenta voltar para um registro MX secundário. Se a validação não for aprovada em 24 horas e não houver nenhum registro MX secundário, a mensagem será descartada.

• Obrigatório: o conector impõe o SMTP DANE com DNSSEC em todas as mensagens enviadas por meio do conector. Se o domínio de destino não der suporte a SMTP DANE com DNSSEC ou a validação falhar a qualquer momento, o Exchange Online enfileirará a mensagem e tentará repetir a entrega por 24 horas. A mensagem eventualmente será descartada se o domínio de destino não oferecer suporte a SMTP DANE com DNSSEC ou oferecer suporte ao protocolo, mas continuar a falhar na validação.

• Nenhum: as mensagens sempre tentam ser entregues sem verificar o SMTP DANE com o DNSSEC. A segurança dos emails enviados pelo conector é reduzida (não é possível proteger contra ataques de downgrade ou redirecionamento MX falsificado). Esse valor pode resultar em mensagens desse conector sendo interceptadas ou redirecionadas para entidades mal-intencionadas.

Propriedades do parâmetro

Conjuntos de parâmetros

-TestMode

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

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

Propriedades do parâmetro

Conjuntos de parâmetros

-TlsDomain

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

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 caracteres curinga para especificar todos os subdomínios de um domínio (por exemplo, *.contoso.com), mas você não pode incorporar o caractere curinga no domínio (por exemplo, domain.*.contoso.com).

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

Propriedades do parâmetro

Conjuntos de parâmetros

-TlsSettings

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

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

Propriedades do parâmetro

Conjuntos de parâmetros

-UseMXRecord

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

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 enviar email. Esse valor é o padrão.
• $false: O conector entrega email para um ou mais hosts inteligentes. Essa configuração requer um ou mais hosts inteligentes para o valor SmartHosts.

Propriedades do parâmetro

Conjuntos de parâmetros

-ValidationRecipients

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

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.

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