Enable-CsTopology
上一次修改主题： 2012-03-23
启用最近发布的 Microsoft Lync Server 2010 拓扑。在对拓扑进行更改之后，更改只有在已发布并启用时才会生效。
语法
Enable-CsTopology [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-Report <String>] [-SkipPrepareCheck <$true | $false>] [-WhatIf [<SwitchParameter>]]
详细说明
安装 Lync Server 2010 之后，最终将需要更改基础结构；例如，可能需要添加新站点，删除现有注册器池，或者添加其他存档服务器。必须使用拓扑生成器进行这些基础结构更改。在拓扑生成器中做出更改后，可以使用同一工具发布和启用这些更改。其中后两个步骤非常重要：虽然可以使用拓扑生成器做出许多修改，但是在发布这些修改并启用新拓扑之前，这些修改不会实际生效，您的基础结构也不会实际更改。
发布更改后，会将新信息（如新站点或新服务器角色）写入中央管理存储。但是，这些新的（或新修改的）对象不会立即加入拓扑，仅当启用已更新的拓扑后，这些对象才能加入。如果在拓扑生成器中选择“发布”选项，则可以同时执行这些步骤：将发布更改（写入到中央管理存储），并将启用新拓扑。
但是，有时您可能倾向于将发布更改和启用拓扑这两个步骤分开执行，这样能够确认在将新对象引入拓扑前部署已成功。要先发布拓扑更改，然后再启用这些更改，必须执行以下操作：
在拓扑生成器中发布修改后的拓扑。（由于产品的最新更改，我们建议您始终使用拓扑生成器进行发布。）
使用 Enable-CsTopology cmdlet 可使发布的更改生效。
有时，还可能需要调用 Enable-CsTopology，以启用未使用拓扑生成器进行的更改。例如，在使用 CsKerberosAccountAssignment cmdlet 修改 Kerberos Web 身份验证之后，必须运行该 cmdlet。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Enable-CsTopology cmdlet：RTCUniversalServerAdmins。但是，如果尚未委派安装权限，则必须是域管理员才能运行该 cmdlet。要授予 RTCUniversalServerAdmins 实际使用 Enable-CsTopology cmdlet 的权限，必须针对运行 Lync Server 服务的计算机所在的每个 Active Directory 容器运行 Set-CsSetupPermission cmdlet。请注意，此限制还适用于通过拓扑生成器启用拓扑。如果尚未通过 Set-CsSetupPermission 委派权限，则只有域管理员才可以通过拓扑生成器启用拓扑。
此外，您还必须是要在其中创建 Lync Server 文件共享的任何计算机上的本地管理员；要对共享文件夹设置必要的安全权限，必须满足此要求。或者，如果您对文件共享具有完全控制权限，则可以运行 Enable-CsTopology。这使该 cmdlet 可以创建共享文件夹并设置共享级别的安全权限。但是，本地管理员将需要添加共享级别的安全权限。
要验证是否已委派安装权限，请针对运行 Lync Server 服务的计算机所在的任何 Active Directory 容器运行 Test-CsSetupPermission cmdlet。
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
GlobalCatalog |
可选 |
字符串 |
域中的全局编录服务器的完全限定域名 (FQDN)。如果使用域中的帐户在计算机上运行 Enable-CsTopology，则不需要使用此参数。 |
GlobalSettingsDomainController |
可选 |
字符串 |
用于存储全局设置的域控制器的 FQDN。如果全局设置存储在 Active Directory 域服务 (AD DS) 的“系统”容器中，则此参数必须指向根域控制器。如果全局设置存储在“配置”容器中，则可以使用任何域控制器，并且可以省略此参数。 |
SkipPrepareCheck |
可选 |
布尔值 |
如果设置为 True ($True)，则 Enable-CsTopology 将跳过其初始准备检查。 |
Report |
可选 |
字符串 |
使您可指定 cmdlet 运行时创建的日志文件的文件路径。例如：-Report "C:\Logs\Enable_Topology.html" |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。Enable-CsTopology 不接受通过管道传递的输入。
返回类型
无。Enable-CsTopology 可启用 Microsoft.Rtc.Management.Deploy.Internal.DefaultTopology 对象的实例。
示例
-------------------------- 示例 1 ------------------------
Enable-CsTopology
示例 1 中显示的命令可启用最近发布的拓扑。