Set-ADSiteLink

此 cmdlet 仅适用于本地 Exchange。

使用 Set-ADSiteLink cmdlet 将特定于 Exchange 的成本分配给 Active Directory IP 站点链接。 还可以使用此 cmdlet 配置可跨 Active Directory IP 站点链接传递的最大消息大小。

有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法

语法

Default (默认值)

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

说明

默认情况下,Microsoft Exchange 使用分配给 Active Directory IP 站点链接的成本来确定成本最低的路由路径。 可以使用 Set-ADSiteLink cmdlet 将特定于 Exchange 的成本分配给 Active Directory IP 站点链接。 特定于 Exchange 的成本是用于确定最低成本路由路径的单独属性,而不是 Active Directory 分配的成本。

您必须先获得权限,然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数,但如果某些参数未包含在分配给你的权限中,则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet

示例

示例 1

Set-ADSiteLink DEFAULT_IP_SITE_LINK -ExchangeCost 25 -MaxMessageSize 10MB

本示例将 Exchange 特定成本 25 分配给 IP 站点链接DEFAULT_IP_SITE_LINK,并在 IP 站点链接上配置最大邮件大小限制 10 MB。

参数

-Confirm

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

  • 破坏性 cmdlet(例如 Remove-* cmdlets)内置有暂停,可强制要求先确认命令,然后再继续操作。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:-Confirm:$false
  • 其他大多数 cmdlet(例如 New-* 和 Set-* cmdlet)都没有内置暂停。 对于这些 cmdlet,指定不含值的 Confirm 开关会引入暂停,从而强制要求你先确认命令,然后再继续操作。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DomainController

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如,dc01.contoso.com。

边缘传输服务器上不支持 DomainController 参数。 边缘传输服务器使用活动目录轻型目录服务 (AD LDS) 的本地实例来读取和写入数据。

参数属性

类型:Fqdn
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ExchangeCost

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

ExchangeCost 参数指定 IP 站点链接的特定于 Exchange 的成本。 此成本用于代替 Active Directory 分配的成本。 若要清除 ExchangeCost 参数的值并还原使用 Active Directory 中指定的 IP 站点链接的成本,请将 ExchangeCost 参数的值设置为$null。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Identity

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

Identity 参数指定要修改的 IP 站点链接的名称或 GUID。

参数属性

类型:AdSiteLinkIdParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:1
必需:True
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-MaxMessageSize

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

MaxMessageSize 参数指定可通过 Active Directory IP 站点链接传递的消息的最大大小。 默认值为无限制。

有效值是一个数字,最大可为 1.999999999 TB(即 2199023254528 B)或值 unlimited。默认值为 6 GB(即 6442450944 B)。

  • B(字节)
  • KB(千字节)
  • MB(兆字节)
  • GB(千兆字节)
  • TB(兆兆字节)

非限定值通常被视为字节,但小值可能会向上舍入到最接近的千字节。

此参数的有效输入范围为 64 KB 到 Int64。 若要删除 Active Directory IP 站点链接上的邮件大小限制,请输入一个值无限制。

参数属性

类型:Unlimited
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Name

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

Name 参数指定 IP 站点链接的唯一名称。 分配的名称将覆盖 IP 站点链接当前的标识。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WhatIf

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

Input types

若要了解此 cmdlet 接受的输入类型,请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空,则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型(亦称为"输出类型"),请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空,则表明此 cmdlet 不返回任何数据。