Compartilhar via


Set-AdSite

 

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2007-06-28

Use o cmdlet Set-AdSite para configurar um site de serviço de diretório do Active Directory como um site de hub para substituir o comportamento padrão de roteamento de mensagens de um computador que tenha a função de servidor Transporte de Hub instalada.

Sintaxe

Set-AdSite -Identity <AdSiteIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-HubSiteEnabled <$true | $false>] [-Name <String>] [-WhatIf [<SwitchParameter>]]

Set-AdSite [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-HubSiteEnabled <$true | $false>] [-Instance <ADSite>] [-Name <String>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

Os servidores de Transporte de Hub do Microsoft Exchange 2007 usam sites do Active Directory e os custos que são atribuídos aos links do site do Active Directory para determinar o caminho de roteamento de menor custo de cada servidor de Transporte de Hub na organização para todos os outros servidores de Transporte de Hub na organização. Depois que o caminho de roteamento de menor custo for determinado, os servidores de Transporte de Hub de origem retransmitem mensagens diretamente para os servidores de Transporte de Hub de destino. Por padrão, os servidores de Transporte de Hub que estão localizados em sites do Active Directory ao longo do caminho entre o servidor de origem e o servidor de destino não processam nem retransmitem as mensagens de maneira alguma.

Você pode usar o cmdlet Set-AdSite para substituir esse comportamento definindo um site do Active Directory como um site de hub. Quando um site de hub existir ao longo do caminho de roteamento de menor custo entre dois servidores de Transporte de Hub, as mensagens são roteadas para o site de hub para processamento, antes de serem retransmitidas para o servidor de destino.

Para executar o cmdlet Set-AdSite, você deve usar uma conta à qual esteja delegado o seguinte:

  • Função Administrador da Organização do Exchange

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Exchange 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro Necessário Tipo Descrição

Identity

Necessário

Microsoft.Exchange.Configuration.Tasks.AdSiteIdParameter

Use o parâmetro Identity para especificar a identidade do site do Active Directory que você deseja modificar. A identidade pode ser expressa como uma GUID ou usando-se o nome do site do Active Directory. Se o nome do site incluir espaços, coloque a entrada entre aspas duplas.

Confirm

Opcional

System.Management.Automation.SwitchParameter

O parâmetro Confirm faz com que o comando pause o processamento e exige que o administrador confirme o que o comando fará antes que o processamento continue. O valor padrão é $true.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Use o parâmetro DomainController para especificar o nome do host ou o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que gravará esta alteração no Active Directory.

HubSiteEnabled

Opcional

System.Boolean

Use o parâmetro HubSiteEnabled para especificar se este site funcionará como um site de hub. O valor padrão é $false.

Instance

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.ADSite

Use o parâmetro Instance para passar um objeto completo para o comando para ser processado. Ele é usado principalmente quando um objeto completo deve ser passado para o comando.

Name

Opcional

System.String

Use o parâmetro Name para modificar o nome atual do site do Active Directory. Você deve ter direitos de Administrador Corporativo para usar esse parâmetro.

WhatIf

Opcional

System.Management.Automation.SwitchParameter

O parâmetro WhatIf instrui o comando a simular as ações que ele executará no objeto. Ao usar o parâmetro WhatIf, o administrador poderá exibir quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. O valor padrão é $true.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

 

Exceções

Exceções Descrição

 

 

Exemplo

O exemplo de código a seguir define o site do Active Directory que é denominado Default-First-Site-Name como um site de hub.

Set-AdSite -Identity Default-First-Site-Name -HubSiteEnabled $true