Set-AdSiteLink
Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Tópico modificado em: 2007-08-02
Use o cmdlet Set-AdSiteLink para atribuir um custo específico do Exchange a um link do site IP do Active Directory. Também é possível utilizar este cmdlet para configurar o tamanho máximo da mensagem que trafegará em um link de site de IP do Active Directory.
Sintaxe
Set-AdSiteLink -Identity <AdSiteLinkIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExchangeCost <Nullable>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-WhatIf [<SwitchParameter>]]
Set-AdSiteLink [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExchangeCost <Nullable>] [-Instance <ADSiteLink>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-WhatIf [<SwitchParameter>]]
Descrição detalhada
No Microsoft Exchange Server 2007, os computadores que têm a função de servidor Transporte de Hub instalada usam os sites do Active Directory e os custos atribuídos aos links de site de IP do Active Directory para determinar o caminho de roteamento de menor custo de cada servidor de Transporte de Hub na organização para outro servidor 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 retransmitirão mensagens 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.
No entanto, você pode configurar um site do Active Directory como um site de hub para que essas mensagens sejam roteadas para o site do hub a ser processado antes de as mensagens serem retransmitidas para o servidor de destino. Para que este comportamento de roteamento ocorra, o site de hub deverá existir ao longo do caminho de roteamento de menor custo entre dois servidores de Transporte de Hub. Você pode usar o cmdlet Set-AdSiteLink para configurar um site do Active Directory como um site de hub.
O caminho de roteamento de menor custo também será usado se uma mensagem não puder ser entregue ao site de destino. Nesse caso, as filas de entrega de mensagens nos servidores de Transporte de Hub do site acessível mais próximo ao longo do caminho de roteamento de menor custo do site de destino.
Por padrão, o Exchange 2007 determina o caminho de roteamento de menor custo, usando o custo que está atribuído ao link de site de IP do Active Directory. Você pode usar o cmdlet Set-AdSiteLink para atribuir um custo específico do Exchange ao link de site de IP do Active Directory. O custo específico do Exchange é um atributo separado, que é usado em vez do custo atribuído ao Active Directory para determinar o caminho de roteamento de menor custo.
Por padrão, o Exchange 2007 não impõe um limite máximo de tamanho para as mensagens que são retransmitidas entre os servidores de Transporte de Hub, em sites diversos do Active Directory. Se você utilizar o cmdlet Set-AdSiteLink para configurar o tamanho máximo da mensagem em um link de site de IP do Active Directory, o roteamento criará um relatório de falha na entrega (NDR) para as mensagens que possuam um tamanho superior ao limite estipulado no link de site do Active Directory, no caminho de roteamento de menor custo. Essa configuração é útil para restringir o tamanho das mensagens enviadas aos sites remotos do Active Directory, que precisam se comunicar com conexões de largura de banda baixa.
Para executar o cmdlet Set-AdSiteLink, você deve usar uma conta à qual esteja delegado o seguinte:
- Função de 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.AdSiteLinkIdParameter |
Use o parâmetro Identity para especificar o nome ou a GUID do link de site de IP para o qual deseja definir um custo específico do Exchange. |
Confirm |
Opcional |
System.Management.Automation.SwitchParameter |
O parâmetro Confirm faz com que o comando pause o processamento e exige que você confirme o que o comando fará antes que o processamento continue. Você não precisa especificar um valor com o parâmetro Confirm. |
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 processará esta consulta. |
ExchangeCost |
Opcional |
System.Nullable |
Use o parâmetro ExchangeCost para atribuir um custo específico do Exchange ao link de site de IP. O custo é usado em vez do custo atribuído pelo Active Directory quando os servidores de Transporte de Hub calculam os caminhos de roteamento de menor custo. Para limpar o valor do parâmetro ExchangeCost e reverter usando o valor do parâmetro ADCost, defina o parâmetro ExchangeCost como |
Instance |
Opcional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ADSiteLink |
Use o parâmetro Instance para passar um objeto completo para o cmdlet para ser processado. Esse parâmetro é útil em scripts em que um objeto inteiro deve ser passado para o cmdlet. |
MaxMessageSize |
Opcional |
Microsoft.Exchange.Data.Unlimited |
Use o parâmetro MaxMessageSize para especificar o tamanho máximo da mensagem que poderá trafegar no link de site de IP do Active Directory. O valor padrão é
Os valores não qualificados são considerados bytes. O intervalo de entrada válido para esse parâmetro é de |
Name |
Opcional |
System.String |
Use o parâmetro Name para atribuir um nome ao link de site de IP. O nome que você atribuir substituirá a identidade atual do link de site de IP. Você deve ser um Administrador de Empresas para modificar este valor. |
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, você poderá exibir quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. Você não precisa especificar um valor com o parâmetro WhatIf. |
Tipos de entrada
Tipos de retorno
Erros
| Erro | Descrição |
|---|---|
|
|
Exceções
| Exceções | Descrição |
|---|---|
|
|
Exemplo
O exemplo a seguir usa o cmdlet Set-AdSiteLink para atribuir um custo específico do Exchange de 25 e um limite máximo de tamanho de mensagem de 10 MB ao link de site de IP especificado.
Set-AdSiteLink -Identity DEFAULTIPSITELINK -ExchangeCost 25 -MaxMessageSize 10MB