New-OutboundConnector

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

Use o cmdlet New-OutboundConnector para criar um novo conector de saída na sua organização baseada na nuvem.

Observação: Recomendamos que você use o módulo do PowerShell v2 do Exchange Online para se conectar ao PowerShell do Exchange Online. Para obter instruções, confira Conectar-se ao PowerShell do Exchange Online.

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

Syntax

New-OutboundConnector
   [-Name] <String>
   [-AllAcceptedDomains <Boolean>]
   [-CloudServicesMailEnabled <Boolean>]
   [-Comment <String>]
   [-Confirm]
   [-ConnectorSource <TenantConnectorSource>]
   [-ConnectorType <TenantConnectorType>]
   [-Enabled <Boolean>]
   [-IsTransportRuleScoped <Boolean>]
   [-LinkForModifiedConnector <Guid>]
   [-RecipientDomains <MultiValuedProperty>]
   [-RouteAllMessagesViaOnPremises <Boolean>]
   [-SmartHosts <MultiValuedProperty>]
   [-TestMode <Boolean>]
   [-TlsDomain <SmtpDomainWithSubdomains>]
   [-TlsSettings <TlsAuthLevel>]
   [-UseMXRecord <Boolean>]
   [-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 tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. 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.

Examples

Exemplo 1

New-OutboundConnector -Name "Contoso Outbound Connector" -RecipientDomains *.contoso.com -TlsSettings DomainValidation -TlsDomain *.contoso.com

Este exemplo cria o conector de saída chamado contoso Outbound Connector com as seguintes propriedades:

  • Ele envia mensagens para destinatários no domínio contoso.com e todos os subdomínios.

  • Ele usa criptografia TLS e verificação de certificado para emails roteados para o domínio contoso.com e todos os subdomínios

Parameters

-AllAcceptedDomains

O parâmetro AllAcceptedDomains especifica se o conector de saída é usado em organizações híbridas nas quais os destinatários da mensagem estão em domínios aceitos da organização baseada na 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 na nuvem. Você só pode usar esse valor quando o valor do parâmetro ConnectorType for onlocal.

  • $false: o conector de saída não é usado em organizações híbridas. Esse é o valor padrão.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-CloudServicesMailEnabled

Observação: Recomendamos que você não use esse parâmetro, a menos que tenha sido direcionado pelo suporte e atendimento ao cliente da Microsoft ou por documentação específica do produto. Em vez disso, use o assistente de configuração híbrida para configurar o fluxo de mensagens 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 fluxo de email híbrido entre um ambiente do Exchange local e o Microsoft 365. Especificamente, esse parâmetro controla como determinados cabeçalhos internos X-MS-Exchange-Organization-Organization * são tratados em mensagens que são 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. Este é o valor padrão para conectores criados pelo assistente de configuração híbrida. Determinados X-MS-Exchange-Organization- * Heads nas mensagens de saída enviadas de um lado da organização híbrida para o outro são convertidos em X-MS-Exchange-CrossPremises- * Headers e, portanto, são preservados em mensagens. X-MS-Exchange-CrossPremises- * headers em mensagens de entrada recebidas em um lado da organização híbrida da outra são promovidas para X-MS-Exchange-Organization- * Headers. Esses cabeçalhos promovidos substituem todas as instâncias do mesmo X-MS-Exchange-Organization- * Headers existentes nas mensagens.

  • $false: o conector não é usado para o fluxo de emails em organizações híbridas, portanto, quaisquer cabeçalhos entre locais são removidos das mensagens que fluem pelo conector.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-Comentário

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-Confirm

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 esses cmdlets, você pode ignorar a solicitação 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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-Connector

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 quando você usa esse cmdlet 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 para Exchange.

Type:TenantConnectorSource
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-ConnectorType

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 de conector externos à sua organização.

  • OnPremises: O conector serve os domínios que são usados por sua organização local.

Type:TenantConnectorType
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-Habilitado

O parâmetro Enabled especifica se é para 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.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-IsTransportRuleScoped

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-LinkForModifiedConnector

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

Type:Guid
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-Name

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

Type:String
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-RecipientDomains

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

Você pode usar um caractere curinga para especificar todos os subdomínios de um domínio especificado, conforme mostrado no exemplo a seguir: * . contoso.com. No entanto, não é possível inserir um caractere curinga, conforme mostrado no exemplo a seguir: domain. * . contoso.com.

Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-RouteAllMessagesViaOnPremises

O parâmetro RouteAllMessagesViaOnPremises especifica que todas as mensagens atendidas por esse conector são roteadas primeiro pelo sistema de mensagens local em organizações híbridas. Os valores válidos são:

  • $true: as mensagens são roteadas através do sistema de mensagens local. Essa configuração exige que você defina o parâmetro ConnectorType como o valor onlocal no mesmo comando.

  • $false: as mensagens não são roteadas através do sistema de mensagens local. Esse é o valor padrão.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-SmartHosts

O parâmetro SmartHosts especifica os hosts inteligentes que o conector de Saída usará no roteamento de email. Esse parâmetro é necessário se você definir o parâmetro UseMxRecord como $false e deve ser especificado na mesma linha de comando. O parâmetro SmartHosts aceita um ou mais FQDNs, como server.contoso.com, ou um ou mais endereços IP, ou uma combinação de FQDNs e endereços IP. Separe cada valor com uma vírgula. Se você digitar um endereço IP, poderá digitá-lo literalmente, por exemplo: 10.10.1.1, ou usar o CIDR (Roteamento entre Domínios sem Classificação), por exemplo, 192.168.0.1/25. A identidade do host inteligente pode ser o FQDN de um servidor de host inteligente, um registro MX (troca de mensagens) ou um registro A (endereço).

Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-Testmode

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.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-TlsDomain

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. Esse parâmetro somente é usado o parâmetro TlsSettings estiver definido como DomainValidation. A entrada válida para o parâmetro TlsDomain é um domínio SMTP. Você pode usar um caractere curinga para especificar todos os subdomínios de um domínio especificado, conforme mostrado no exemplo a seguir: * . contoso.com. No entanto, não é possível inserir um caractere curinga, conforme mostrado no exemplo a seguir: domain. * . contoso.com

Type:SmtpDomainWithSubdomains
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-TlsSettings

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 de 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): Este é o valor padrão.

Type:TlsAuthLevel
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-UseMXRecord

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

  • $true: o conector usa roteamento DNS (registros MX no DNS) para entregar emails. Esse é o valor padrão.

  • $false: o conector entrega emails a um ou mais hosts inteligentes. Ao usar esse valor, você também precisará especificar os hosts inteligentes usando o parâmetro SmartHosts no mesmo comando.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-WhatIf

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.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

Inputs

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.

Outputs

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.