New-OutboundConnector

Módulo:

ExchangePowerShell

Aplica-se a:

Exchange Online, Exchange Online Protection

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 em sua organização baseada em nuvem.

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>]
   [-SenderRewritingEnabled <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.

Exemplos

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

Parâmetros

-AllAcceptedDomains

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.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
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 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.

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

-Comment

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
Required:	False
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, 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.

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

-ConnectorSource

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

Type:	TenantConnectorSource
Position:	Named
Default value:	None
Required:	False
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 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.

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

-Enabled

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.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
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 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.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
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
Required:	False
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
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-RecipientDomains

O parâmetro RecipientDomains especifica os domínios aos quais 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.

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
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 pela primeira vez por meio do sistema de email local em organizações híbridas. 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.

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

-SenderRewritingEnabled

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.

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

-SmartHosts

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.

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
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
Required:	False
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. 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.

Type:	SmtpDomainWithSubdomains
Position:	Named
Default value:	None
Required:	False
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 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.

Type:	TlsAuthLevel
Position:	Named
Default value:	None
Required:	False
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 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.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

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.