Publish-CsTopology
上一次修改主题： 2012-03-25
发布使用 Get-CsTopology cmdlet 检索到的 Microsoft Lync Server 2010 拓扑。
语法
Publish-CsTopology -FileName <String> [-BackupFileName <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-Report <String>] [-WhatIf [<SwitchParameter>]]
Publish-CsTopology -Document <XElement> [-BackupFileName <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-Report <String>] [-WhatIf [<SwitchParameter>]]
Publish-CsTopology -FinalizeUninstall <SwitchParameter> [-BackupFileName <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-Report <String>] [-WhatIf [<SwitchParameter>]]
详细说明
安装 Lync Server 2010 之后，最终将需要更改 Lync Server 基础结构；例如，可能需要添加新站点，删除现有注册器池，或者添加其他存档服务器。必须使用拓扑生成器进行这些基础结构更改。在拓扑生成器中做出更改后，可以使用同一工具发布和启用这些更改。后面两步至关重要：虽然可以使用拓扑生成器做出许多修改，但是在发布这些修改并启用新拓扑之前，这些修改不会实际生效，Lync Server 基础结构也不会实际更改。
发布更改后，会将新信息（如新站点或新服务器角色）写入中央管理存储。但是，这些新的（或新修改的）对象不会立即加入拓扑，仅当启用已更新的拓扑后，这些对象才能加入。如果在拓扑生成器中选择“发布”选项，将发生以下两个步骤：将发布更改（写入到中央管理存储），并将启用新拓扑。
建议不要再使用 Publish-CsTopology cmdlet 发布通过拓扑生成器创建的拓扑；而是应使用上一段落中说明的步骤在拓扑生成器中进行发布。这是因为拓扑生成器现在使用拓扑生成器 XML 文件格式 (.tbxml)；使用 Publish-CsTopology 无法发布此文件格式。使用 Publish-CsTopology 唯一可执行的操作是重新发布通过 Get-CsTopology cmdlet 检索到的拓扑。以这种方式发布拓扑后，需要重新配置您的简单 URL。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权运行 Publish-CsTopology cmdlet：RTCUniversalServerAdmins。但是，如果尚未委派安装权限，则必须是域管理员才能运行 Publish-CsTopology。要授予 RTCUniversalServerAdmins 实际使用 Publish-CsTopology cmdlet 的权限，必须针对运行 Lync Server 服务的每个 Active Directory 容器运行 Grant-CsSetupPermission cmdlet。请注意，此限制还适用于通过拓扑生成器启用拓扑。如果尚未通过 Set-CsSetupPermission 委派权限，则只有域管理员才可以通过拓扑生成器发布拓扑。
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
FileName |
必需 |
字符串 |
包含新拓扑信息的 XML 文件的完整路径。 |
BackupFileName |
可选 |
字符串 |
运行 Publish-CsTopology 时自动创建的备份文件的完整路径。如果未指定此参数，Publish-CsTopology 将在临时文件夹 (%temp%) 中创建类似如下的备份文件：Publish-CsTopology-Backup-[2010_10_01][08_30_00]。在该文件名中，2010_10_01 代表发布生效的日期：年 (2010)，月 (10) 和日 (01)。此外，08_30_00 代表发布生效的时间：小时 (08)，分钟 (30) 和秒 (00)。 |
Document |
可选 |
System.XML.Linq.XElement 对象 |
使您可以发布 XML 元素而不是 XML 文件。必须将此 XML 元素配置为 System.XML.Linq.XElement 对象。 |
FinalizeUninstall |
可选 |
开关参数 |
仅在卸载 Lync Server 2010 时使用。删除中央管理服务器后，使用 Publish-CsTopology 和 FinalizeUninstall 参数发布空拓扑。此参数的作用之一是删除中央管理服务器的所有 Active Directory 条目。 |
GlobalCatalog |
可选 |
字符串 |
域中的全局编录服务器的完全限定域名 (FQDN)。如果使用域中的帐户在计算机上运行 Publish-CsTopology，则不需要使用此参数。 |
GlobalSettingsDomainController |
可选 |
字符串 |
用于存储全局设置的域控制器的 FQDN。如果全局设置存储在 Active Directory 域服务 (AD DS) 的“系统”容器中，则此参数必须指向根域控制器。如果全局设置存储在“配置”容器中，则可以使用任何域控制器，并且可以省略此参数。 |
SkipPrepareCheck |
可选 |
布尔值 |
如果设置为 True ($True)，Publish-CsTopology 将跳过初始准备检查。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
Report |
可选 |
字符串 |
用于指定在该 cmdlet 运行时创建的日志文件的文件路径。例如：-Report "C:\Logs\Publish_Topology.html" |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。Publish-CsTopology 不接受通过管道传递的输入。
返回类型
无。Publish-CsTopology 会发布 Microsoft.Rtc.Management.Deploy.Internal.DefaultTopology 对象的实例。
示例
-------------------------- 示例 1 --------------------------
(Get-CsTopology -AsXml).ToString() > C:\Topologies\Topology.xml
Publish-CsTopology -FileName "C:\Topologies\Topology.xml"
示例 1 中显示的命令检索并重新发布当前拓扑。为完成这些任务，示例中的第一个命令使用 Get-CsTopology 和 AsXml 参数检索当前拓扑；然后，使用 Windows PowerShell redirection symbol > 将检索到的数据保存到名为 C:\Topologies\Topology.xml 的文件（还请注意，ToString 方法用于将检索到的拓扑转换为字符串值。）接下来，示例中的第二个命令使用 Publish-CsTopology 重新发布新检索到的拓扑。