Set-HybridConfiguration

Este cmdlet está disponível somente no Exchange local.

Use o cmdlet Set-HybridConfiguration para modificar a implantação híbrida entre sua organização local do Exchange e o Exchange Online no Microsoft 365 para empresas.

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

Sintaxe

Default (Default)

Set-HybridConfiguration

    [-ClientAccessServers <MultiValuedProperty>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Domains <MultiValuedProperty>]
    [-EdgeTransportServers <MultiValuedProperty>]
    [-ExternalIPAddresses <MultiValuedProperty>]
    [-Features <MultiValuedProperty>]
    [-Name <String>]
    [-OnPremisesSmartHost <SmtpDomain>]
    [-ReceivingTransportServers <MultiValuedProperty>]
    [-SecureMailCertificateThumbprint <String>]
    [-SendingTransportServers <MultiValuedProperty>]
    [-ServiceInstance <Int32>]
    [-TlsCertificateName <SmtpX509Identifier>]
    [-TransportServers <MultiValuedProperty>]
    [-WhatIf]
    [<CommonParameters>]

Description

O cmdlet Set-HybridConfiguration modifica os recursos de configuração híbrida, como habilitar o email seguro, designar um servidor de Caixa de Correio específico para funcionalidade híbrida ou habilitar ou desabilitar o compartilhamento de disponibilidade entre o Exchange local e o Exchange Online.

Para executar esse cmdlet, você precisa ter permissões. Embora este artigo 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

Set-HybridConfiguration -SecureMailCertificateThumbprint AC00F35CBA8359953F4126E0984B5CCAFA2F4F17

No Exchange Server 2010, este exemplo especifica que a configuração híbrida usa o certificado com o AC00F35CBA8359953F4126E0984B5CCAFA2F4F17 de impressão digital como o certificado para mensagens do Secure Mail.

Exemplo 2

Set-HybridConfiguration -Features OnlineArchive,MailTips,OWARedirection,FreeBusy,MessageTracking

Este exemplo desabilita os recursos de implantação híbrida de email seguro e transporte centralizado, mas mantém os recursos de Exchange Online Arquivo, Dicas de Email Outlook na Web, Redirecionamento, Disponibilidade e Rastreamento de Mensagens habilitados entre o Exchange local e as organizações Exchange Online.

Exemplo 3

Set-HybridConfiguration -TlsCertificateName "<I>CN=A. Datum Corporation CA-3, OU=www.adatum.com, O=A.Datum Corp, C=US<S>CN=mail.contoso.com, O=Barbara Zighetti, L=Seattle, S=WA, C=US"

Este exemplo especifica que a implantação híbrida utiliza um certificado definido de TLS, referido pela combinação de atributos de Emissor e Assunto do certificado emitido X.509 da CA.

Parâmetros

-ClientAccessServers

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Esse parâmetro está disponível somente no Exchange Server 2010.

O parâmetro ClientAccessServers especifica os servidores de Transporte de Hub no Exchange Server 2010 SP2 ou posterior que estão configurados para dar suporte a recursos de implantação híbrida. Você precisa especificar pelo menos um servidor de Acesso para Cliente que seja acessível da Internet nas portas TCP 80 e 443. Os servidores estão configurados para habilitar os seguintes recursos:

  • Proxy do Serviço de Replicação de Caixa de Correio (MRS): Habilite a configuração do serviço MRS Proxy.
  • Diretórios virtuais: hospede os sites padrão para EWS (Serviços Web do Exchange), catálogos de endereços offline e serviços ActiveSync.
  • Outlook em Qualquer Lugar: habilitado.

Você pode especificar vários servidores separados por vírgulas.

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:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Confirm

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

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

-DomainController

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.

Propriedades do parâmetro

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

-Domains

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro Domains especifica os namespaces de domínio usados na implantação híbrida. Esses domínios devem ser configurados como domínios aceitos no Exchange local ou no Exchange Online. Os domínios são usados na configuração dos relacionamentos da organização e nos conectores Enviar e Receber usados pela configuração híbrida.

É possível especificar vários domínios, separando-os por vírgulas.

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:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-EdgeTransportServers

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro EdgeTransportServers especifica os servidores de Transporte de Borda configurados para oferecer suporte aos recursos de implantação híbrida. O servidor de Transporte de Borda deve ter acessibilidade externa da Internet na porta 25. Os valores aceitos para o parâmetro EdgeTransportServers são tanto nomes curtos como extensos de computadores de um servidor de Transporte de Borda, por exemplo edge.corp.contoso.com ou EDGE. Separe os nomes de servidor com uma vírgula se estiver definindo mais de um servidor de Transporte de Borda.

Ao configurar o parâmetro EdgeTransportServers, devem-se configurar os valores do parâmetro ReceivingTransportServers e SendingTransportServers em $null.

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:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ExternalIPAddresses

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro ExternalIPAddresses é um parâmetro herdado que especifica o endereço IP de entrada acessível publicamente dos servidores de Transporte de Hub do Microsoft Exchange Server 2010.

Você deve usar esse parâmetro para alterar ou limpar apenas os valores de endereço IP do servidor de Transporte de Hub do Exchange 2010 herdado. Não há suporte para endereços IPv6.

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:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Features

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro Features especifica os recursos que podem ser habilitados para a configuração híbrida. Os valores válidos são:

  • OnlineArchive: Habilita o arquivamento do Exchange Online para usuários locais do Exchange e do Exchange Online.
  • FreeBusy: Habilita o compartilhamento de calendário livre/ocupado entre usuários locais do Exchange e do Exchange Online.
  • Dicas de Email: Habilita Dicas de Email entre usuários do Exchange local e do Exchange Online.
  • MessageTracking: Habilita o rastreamento de mensagens entre o Exchange local e o Exchange Online.
  • OWARedirection: Habilita o redirecionamento automático do Outlook na Web (anteriormente conhecido como Outlook Web App ou OWA) para o Exchange local ou o Exchange Online, dependendo de onde a caixa de correio do usuário está localizada.
  • SecureMail: Permite o transporte seguro de mensagens por meio do protocolo TLS entre o Exchange no local e o Exchange Online.
  • Centralizado: permite que os servidores Exchange locais lidem com todo o transporte de mensagens entre o Exchange local e o Exchange Online, incluindo a entrega de mensagens para a Internet para ambas as organizações. Se você não usar esse valor, o Exchange local e o Exchange Online serão responsáveis pela entrega de suas próprias mensagens de Internet.
  • Fotos: permite o compartilhamento de dados de fotos do usuário entre o Exchange local e o Exchange Online. Este recurso funciona em conjunto com o parâmetro PhotosEnabled nos cmdlets de OrganizationRelationship em uma implantação híbrida. Se você usar esse valor, o parâmetro PhotosEnabled será definido automaticamente como $true. Se você não usar esse valor, o parâmetro PhotosEnabled será definido automaticamente como $false.

Vários valores, separados por vírgulas, podem ser especificados. Quando você usa o assistente de Configuração Híbrida, todos os recursos são habilitados por padrão.

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:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Name

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Esse parâmetro foi preterido e não é mais usado.

Pode haver apenas um objeto HybridConfiguration em uma organização do Exchange.

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

-OnPremisesSmartHost

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro OnPremisesSmartHost especifica o FQDN do servidor da Caixa de Correio do Exchange local usado para transporte seguro de mail entre o Exchange local e o Exchange Online.

Propriedades do parâmetro

Tipo:SmtpDomain
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ReceivingTransportServers

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro ReceivingTransportServers especifica os servidores de Caixa de Correio definidos na configuração do conector de saída no Exchange Online. Os valores válidos são:

  • O FQDN do servidor de Caixa de Correio (por exemplo, mbx.corp.contoso.com).
  • O nome do host do servidor de Caixa de Correio (por exemplo, MBX).

Você pode especificar vários servidores especificados por vírgulas.

Os servidores especificados recebem mensagens de email seguras do Exchange Online para o Exchange local em uma implantação híbrida. Você precisa especificar pelo menos um servidor de Caixa de Correio acessível publicamente para habilitar o email seguro.

O valor desse parâmetro deve estar em branco ($null) quando você usa o parâmetro EdgeTransportServers .

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:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-SecureMailCertificateThumbprint

Aplicável: Exchange Server 2010

O parâmetro SecureMailCertificateThumbprint especifica a impressão digital do certificado X.509 a ser usado como o certificado para o transporte seguro de mensagens de implantação híbrida. Esse certificado não pode ser autoassinado, deve ser obtido de uma autoridade de certificação confiável e deve ser instalado em todos os servidores de Transporte de Hub definidos no parâmetro TransportServers.

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:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-SendingTransportServers

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro SendingTransportServers especifica os servidores de Caixa de Correio definidos na configuração do conector de entrada no Exchange Online. Os valores válidos são:

  • O FQDN do servidor de Caixa de Correio (por exemplo, mbx.corp.contoso.com).
  • O nome do host do servidor de Caixa de Correio (por exemplo, MBX).

Você pode especificar vários servidores especificados por vírgulas.

Os servidores especificados enviam mensagens de email seguras do Exchange local para o Exchange Online em uma implantação híbrida. Você precisa especificar pelo menos um servidor de Caixa de Correio acessível publicamente para habilitar o email seguro.

O valor desse parâmetro deve estar em branco ($null) quando você usa o parâmetro EdgeTransportServers .

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:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ServiceInstance

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Esse parâmetro é significativo apenas no Office 365 operado pela 21Vianet na China.

Para configurar manualmente uma implantação híbrida com o Office 365 operado pela 21Vianet na China, defina o valor desse parâmetro como 1. Caso contrário, o valor padrão será 0.

Todas as outras organizações do Microsoft 365 devem usar o assistente de Configuração Híbrida para configurar uma implantação híbrida.

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-TlsCertificateName

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro TlsCertificateName especifica o certificado X.509 a ser usado para a criptografia TLS. A sintaxe válida para este parâmetro é "<I>X.500Issuer<S>X.500Subject":

  • X.500Issuer: O valor no campo Emissor do certificado.
  • X.500Subject: O valor no campo Assunto do certificado.

Você pode encontrar esses valores executando o cmdlet Get-ExchangeCertificate.

Ou, depois de executar Get-ExchangeCertificate para localizar o valor da impressão digital do certificado, use o valor da impressão digital no comando $TLSCert = Get-ExchangeCertificate -Thumbprint <Thumbprint>, execute o comando $TLSCertName = "<I>$($TLSCert.Issuer)<S>$($TLSCert.Subject)"e, em seguida, use o valor $TLSCertName para esse parâmetro.

Propriedades do parâmetro

Tipo:SmtpX509Identifier
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-TransportServers

Aplicável: Exchange Server 2010

O parâmetro TransportServers especifica os servidores de Transporte de Hub no Exchange Server 2010 SP2 ou posterior que estão configurados para dar suporte a recursos de implantação híbrida.

Você precisa especificar pelo menos um servidor de Transporte de Hub que seja acessível da Internet para email seguro entre o Exchange local e o Exchange Online.

Você pode especificar vários servidores separados por vírgulas.

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:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-WhatIf

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

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 dá suporte aos 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.