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 é |
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 é |
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 é |
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