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