Set-AdSiteLink

  • Referência
Módulo:
ExchangePowerShell
Aplica-se a:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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

Use o cmdlet Set-AdSiteLink para atribuir um custo específico do Exchange a um link de site IP do Active Directory. Você também pode usar esse cmdlet para configurar o tamanho máximo da mensagem que pode passar por um link de site IP do Active Directory.

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

Syntax

Set-AdSiteLink
   [-Identity] <AdSiteLinkIdParameter>
   [-Confirm]
   [-DomainController <Fqdn>]
   [-ExchangeCost <Int32>]
   [-MaxMessageSize <Unlimited>]
   [-Name <String>]
   [-WhatIf]
   [<CommonParameters>]

Description

Por padrão, Microsoft Exchange determina o caminho de roteamento de custo mínimo usando o custo atribuído ao link do site IP do Active Directory. Você pode usar o cmdlet Set-AdSiteLink para atribuir um custo específico do Exchange ao link do site IP do Active Directory. O custo específico do Exchange é um atributo separado usado em vez do custo atribuído ao Active Directory para determinar o caminho de roteamento de custo mínimo.

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico 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-AdSiteLink DEFAULT_IP_SITE_LINK -ExchangeCost 25 -MaxMessageSize 10MB

Este exemplo atribui um custo específico do Exchange de 25 ao link do site IP DEFAULT_IP_SITE_LINK e configura um limite máximo de tamanho de mensagem de 10 MB no link do site IP.

Parâmetros

-Confirm

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

  • Cmdlets destrutivos (por exemplo, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, cmdlets 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 confirmar o comando antes de continuar.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

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.

O parâmetro DomainController não é compatível com os servidores de Transporte do Microsoft Edge. Um servidor de Transporte do Microsoft Edge usa a instância local dos Serviços AD LDS para ler e gravar dados.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ExchangeCost

O parâmetro ExchangeCost especifica um custo específico do Exchange para o link do site ip. Esse custo é usado em vez do custo atribuído ao Active Directory. Para limpar o valor do parâmetro ExchangeCost e reverter para o uso do custo do link do site IP especificado no Active Directory, defina o valor do parâmetro ExchangeCost como $null.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

O parâmetro Identity especifica o nome ou o GUID do link de site IP que você deseja modificar.

Type:AdSiteLinkIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-MaxMessageSize

O parâmetro MaxMessageSize especifica o tamanho máximo de uma mensagem que pode passar pelo link do site IP do Active Directory. O valor padrão é unlimited.

Um valor válido é um número até 1,999999999 terabytes (2199023254528 bytes) ou o valor unlimited. O valor padrão é 6 gigabytes (6442450944 bytes).

  • B (bytes)
  • KB (quilobytes)
  • MB (megabytes)
  • GB (gigabytes)
  • TB (terabytes)

TB (terabytes)

O intervalo de entrada válido para este parâmetro é de 64 KB a Int64. Para remover o limite de tamanho da mensagem em um link de site IP do Active Directory, insira um valor ilimitado.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Name

O parâmetro Name especifica um nome único para o link do site IP. O nome atribuído substitui a identidade atual do link do site IP.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WhatIf

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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.