Citrix DaaS™

查看 PDF

将多个站点合并到一个站点

May 4, 2026

投稿者:

C C

Automated Configuration 的多站点支持提供了一种将多个本地站点合并到一个云站点的方法。

多站点支持基于每个本地站点为组件名称添加唯一的前缀和后缀，确保在将多个本地站点合并到一个云站点后名称的唯一性。
可以基于每个本地站点为以下每个组件分配前缀和后缀。
AdminScope (管理范围)
AdminRole (管理角色)
ApplicationAdmin (应用程序管理员)
ApplicationFolder (应用程序文件夹)
ApplicationGroup (应用程序组)
ApplicationUser (应用程序用户)
DeliveryGroup (交付组)
GroupPolicy (组策略)
HostConnection (主机连接)
MachineCatalog (计算机目录)
StoreFront
Tag (标记)

应用程序文件夹支持添加前缀、后缀和重新根目录化。重新根目录化会为应用程序的现有文件夹结构添加一个额外的顶级文件夹。

前缀和后缀规则

前缀和后缀不能包含以下任何特殊字符：\ , / ; : # . * ? = < > | ( ) " ' { } [ ]
前缀和后缀可以包含尾随空格，但不能包含前导空格。
前缀和后缀必须用双引号引起来才能包含尾随空格。
前缀和后缀在导入、合并和添加时应用。源 .yml 文件永不修改。
前缀和后缀过程在适用时自动为依赖组件名称添加前缀或后缀。例如，如果计算机目录名称以“East”为前缀，则引用它们的交付组也将以“East”为前缀。
如果组件名称已以前缀或后缀开头，则不会添加前缀或后缀。组件名称不能包含重复的相同前缀或后缀。
前缀和后缀可以单独使用或组合使用。
在组件上使用前缀或后缀是可选的。

注意：

Studio 按字母顺序显示组件。

按站点对组件进行分组

使用前缀来可视化地对来自单个站点的组件进行分组。每个站点都列在其自己的组中，前缀按字母顺序控制不同站点组的排序。

按名称对组件进行分组

使用后缀来可视化地对来自多个站点的同名组件进行分组。来自不同站点的同名组件会视觉上交替显示。

前缀和后缀映射文件

站点前缀从 SiteMerging.yml 文件开始，该文件包含一个或多个本地站点的站点前缀和后缀映射。您可以手动管理 SiteMerging.yml 文件，也可以使用合并多个本地站点 cmdlet 部分中列出的可用 cmdlet。

导出本地站点

在导出本地站点之前，无法开始合并。要导出本地站点，请参阅导出本地配置。

集中导出目标文件夹

本节中描述的方法将多个站点导出放置到集中文件共享位置。SiteMerging.yml 文件、CustomerInfo.yml 文件和所有导出文件都位于该文件共享位置，允许您从一个位置执行导入，而独立于本地站点。

云访问操作从不引用本地站点或 Active Directory，因此允许您从任何位置执行云访问操作。

有两种方法可以实现此目的：

直接文件共享：要从直接文件共享导入、合并或添加，您必须决定要从哪台计算机执行云访问操作
使用 SiteMerging.yml 的文件共享引用：此方法使用站点前缀集中的 SiteRootFolder 成员，并降低了在导出、导入、合并或添加时错误定位文件夹的可能性。

如果您不使用集中文件共享方法，则从各个交付组控制器执行导入、合并或添加。在每个迁移到云中的交付组控制器上创建并复制 SiteMerging.yml 文件。默认位置是 %HOMEPATH%\Documents\Citrix\AutoConfig。您必须指定 –SiteName 参数以选择正确的站点前缀。

直接文件共享

导出、导入、合并和新建/添加操作提供了一个参数，用于指定除默认文件夹 %HOMEPATH%\Documents\Citrix\AutoConfig 之外的目标或源文件夹。以下示例使用 \\share.central.net 上的集中文件共享，管理员已拥有访问权限，并根据需要提供了凭据。

要将导出目标设置为特定于站点的文件夹，请使用 –TargetFolder 参数：

从东部交付组控制器™：

mkdir  \\share.central.net\AutoConfig\SiteEast

Export-CvadAcToFile   –TargetFolder   \\share.central.net\AutoConfig\SiteEast

<!--NeedCopy-->

从西部交付组控制器：

mkdir  \\share.central.net\AutoConfig\SiteWest

Export-CvadAcToFile   –TargetFolder   \\share.central.net\AutoConfig\SiteWest`

<!--NeedCopy-->

导出完成后，创建 CustomerInfo.yml 和 SiteMerging.yml 文件，并将它们放置在 \\share.central.net\AutoConfig 中。

注意：

使用此直接文件共享引用方法时，创建 SitePrefixes.yml 时请勿使用 SiteRootFolder 参数。

要从直接文件共享导入、合并或添加，您必须决定要从哪台计算机执行云访问操作。选项包括：

已安装该工具的其中一个本地交付组控制器。
托管文件共享的计算机。
另一台计算机。

Automated Configuration 必须安装在访问云的计算机上。既不使用本地 PowerShell SDK、交付组控制器，也不使用 Active Directory，因此云访问执行要求比导出要求更简单。

要将东部交付组控制器合并到云中：

Merge-CvadAcToSite –SiteName East –SourceFolder  \\share.central.net\AutoConfig\SiteEast -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml

<!--NeedCopy-->

将 West Delivery Controller 合并到云端：

Merge-CvadAcToSite –SiteName West –SourceFolder  \\share.central.net\AutoConfig\SiteWest -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml

<!--NeedCopy-->

以下是上一个示例中使用的 SitePrefixes.yml 示例文件。

    East:
      SiteRootFolder: "" # 重要提示：请将其留空
      AdminScopePrefix: "East_"
      AdminRolePrefix: "East_"
      ApplicationAdminPrefix: "East_"
      ApplicationFolderPrefix: "" # 请注意，此处使用了新的父根文件夹
      ApplicationFolderRoot: "East"
      ApplicationGroupPrefix: "East_"
      ApplicationUserPrefix: "East_"
      DeliveryGroupPrefix: "East_"
      GroupPolicyPrefix: "East_"
      HostConnectionPrefix: "East_"
      MachineCatalogPrefix: "East_"
      StoreFrontPrefix: "East_"
      TagPrefix: "East_"
      AdminScopeSuffix: "_east"
      AdminRoleSuffix: "_east"
      ApplicationAdminSuffix: "_east"
      ApplicationFolderSuffix: "_east"
      ApplicationGroupSuffix: "_east"
      ApplicationUserSuffix: "_east"
      DeliveryGroupSuffix: "_east"
      GroupPolicySuffix: "_east"
      HostConnectionSuffix: "_east"
      MachineCatalogSuffix: "_east"
      StoreFrontSuffix: "_east"
      TagSuffix: "_east"
    West:
      SiteRootFolder: "" # 重要提示：请将其留空
      AdminScopePrefix: "Western "
      AdminRolePrefix: "Western "
      ApplicationAdminPrefix: "Western "
      ApplicationFolderPrefix: "" # 请注意，此处使用了新的父根文件夹
      ApplicationFolderRoot: "Western"
      ApplicationGroupPrefix: "Western "
      ApplicationUserPrefix: "Western "
      DeliveryGroupPrefix: "Western "
      GroupPolicyPrefix: "Western "
      HostConnectionPrefix: "Western "
      MachineCatalogPrefix: "Western "
      StoreFrontPrefix: "Western "
      TagPrefix: "Western "
      AdminScopeSuffix: ""
      AdminRoleSuffix: ""
      ApplicationAdminSuffix: ""
      ApplicationFolderSuffix: ""
      ApplicationGroupSuffix: ""
      ApplicationUserSuffix: ""
      DeliveryGroupSuffix: ""
      GroupPolicySuffix: ""
      HostConnectionSuffix: ""
      MachineCatalogSuffix: ""
      StoreFrontSuffix: ""
      TagSuffix: ""

使用 SiteMerging.yml 的文件共享引用

此方法使用站点的 SiteRootFolder 前缀集成员。虽然此方法比直接文件共享方法更复杂，但它降低了在导出、导入、合并或添加时定位错误文件夹的可能性。

首先，在 SiteMerging.yml 文件中为每个站点设置 SiteRootFolder。您必须在共享位置执行此操作。

New-CvadAcSiteMergingInfo –SiteName East –SiteRootFolder \\share.central.net\AutoConfig\SiteEast -SitePrefixesFolder  \\share.central.net\AutoConfig

New-CvadAcSiteMergingInfo –SiteName West –SiteRootFolder SiteWest -SitePrefixesFolder  \\share.central.net\AutoConfig

<!--NeedCopy-->

在此示例中，East 是完全限定的文件夹规范，West 是相对文件夹规范。

要使用 SiteMerging.yml 文件将导出目标设定为特定于站点的文件夹：

从 East Delivery Controller：

mkdir  \\share.central.net\AutoConfig\SiteEast

Export-CvadAcToFile   -SiteName East -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml

<!--NeedCopy-->

从 West Delivery Controller：

mkdir  \\share.central.net\AutoConfig\SiteWest

Export-CvadAcToFile   -SiteName West -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml

<!--NeedCopy-->

导出 cmdlet 使用 CustomerInfo.yml 文件夹位置来查找 SiteMerging.yml 文件。对于 East，SiteRootFolder 是完全限定的。它按原样使用。对于 West，SiteRootFolder 不是完全限定的。它与 CustomerInfo.yml 文件夹位置结合，以检索 West 的完全限定文件夹位置。

要将 East Delivery Controller 合并到云端：

Merge-CvadAcToSite –SiteName East -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml

<!--NeedCopy-->

要将 West Delivery Controller 合并到云端：

Merge-CvadAcToSite –SiteName West -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml

<!--NeedCopy-->

以下是上一个示例中使用的 SitePrefixes.yml 示例文件。

      East:
      SiteRootFolder: "\\\\share.central.net\\AutoConfig\\SiteEast"
      AdminScopePrefix: "East_"
      AdminRolePrefix: "East_"
      ApplicationAdminPrefix: "East_"
      ApplicationFolderPrefix: "" # 请注意，此处使用了新的父根文件夹
      ApplicationFolderRoot: "East"
      ApplicationGroupPrefix: "East_"
      ApplicationUserPrefix: "East_"
      DeliveryGroupPrefix: "East_"
      GroupPolicyPrefix: "East_"
      HostConnectionPrefix: "East_"
      MachineCatalogPrefix: "East_"
      StoreFrontPrefix: "East_"
      TagPrefix: "East_"
      AdminScopeSuffix: "_east"
      AdminRoleSuffix: "_east"
      ApplicationAdminSuffix: "_east"
      ApplicationFolderSuffix: "_east"
      ApplicationGroupSuffix: "_east"
      ApplicationUserSuffix: "_east"
      DeliveryGroupSuffix: "_east" GroupPolicySuffix: "_east"
      HostConnectionSuffix: "_east"
      MachineCatalogSuffix: "_east"
      StoreFrontSuffix: "_east"
      TagSuffix: "_east"
    West:
      SiteRootFolder: "\\\\share.central.net\\AutoConfig\\SiteWest"
      AdminScopePrefix: "Western "
      AdminRolePrefix: "Western "
      ApplicationAdminPrefix: "Western "
      ApplicationFolderPrefix: "" # 请注意，此处使用了新的父根文件夹
      ApplicationFolderRoot: "Western"
      ApplicationGroupPrefix: "Western "
      ApplicationUserPrefix: "Western "
      DeliveryGroupPrefix: "Western "
      GroupPolicyPrefix: "Western "
      HostConnectionPrefix: "Western "
      MachineCatalogPrefix: "Western "
      StoreFrontPrefix: "Western "
      TagPrefix: "Western "
      AdminScopeSuffix: ""
      AdminRoleSuffix: ""
      ApplicationAdminSuffix: ""
      ApplicationFolderSuffix: ""
      ApplicationGroupSuffix: ""
      ApplicationUserSuffix: ""
      DeliveryGroupSuffix: ""
      GroupPolicySuffix: ""
      HostConnectionSuffix: ""
      MachineCatalogSuffix: ""
      StoreFrontSuffix: ""
      TagSuffix: ""

合并站点

Citrix® 建议分步执行云操作，并在执行下一个云操作之前对每个结果进行全面审查。例如，如果将三个站点合并到一个云站点：

使用适当的 SiteName 值将初始站点合并到云端。
在 Studio 中审查结果。
如果结果不正确，请确定问题及其原因，进行更正，然后重新运行合并。如有必要，请使用 Remove-CvadAcFromSite 删除云组件并从头开始，针对选定的组件和成员执行此操作。如果结果正确，请继续。
如果初始合并正确，请将第二个站点合并到单个云站点。
重复步骤 2 和 3。
如果第二次合并正确，请将第三个站点合并到单个云站点。
重复步骤 2 和 3。
从用户的角度审查资源，并验证视图是否处于所需状态。

使用站点前缀删除组件

您可以使用 Remove-CvadAcFromSite cmdlet 的 –IncludeByName 参数上的前缀选择性地删除单个站点组件。在以下示例中，West Delivery Controller 交付组不正确。要仅删除 West 站点的交付组：

Remove-CvadAcFromSite   –DeliveryGroups   –IncludeByName “Western *”

<!--NeedCopy-->

要删除所有 West 组件，请按顺序运行以下 cmdlet。

Remove-CvadAcFromSite –GroupPolicies –IncludeByName “Western *”

Remove-CvadAcFromSite –Applications –IncludeByName “Western *”

Remove-CvadAcFromSite – ApplicationGroups –IncludeByName “Western *”

Remove-CvadAcFromSite –DeliveryGroups –IncludeByName “Western *”

Remove-CvadAcFromSite –MachineCatalogs –IncludeByName “Western *”

Remove-CvadAcFromSite –HostConnections –IncludeByName “Western *”

Remove-CvadAcFromSite –Tags –IncludeByName “Western *”

要删除 East 组件的组策略，请使用后缀：

Remove-CvadAcFromSite   –GroupPolicies   –IncludeByName “*_east”

<!--NeedCopy-->

本内容的正式版本为英文版。部分 Cloud Software Group 文档内容采用了机器翻译，仅供您参考。Cloud Software Group 无法控制机器翻译的内容，这些内容可能包含错误、不准确或不合适的语言。对于从英文原文翻译成任何其他语言的内容的准确性、可靠性、适用性或正确性，或者您的 Cloud Software Group 产品或服务沿用了任何机器翻译的内容，我们均不作任何明示或暗示的保证，并且适用的最终用户许可协议或服务条款或者与 Cloud Software Group 签订的任何其他协议（产品或服务与已进行机器翻译的任何文档保持一致）下的任何保证均不适用。对于因使用机器翻译的内容而引起的任何损害或问题，Cloud Software Group 不承担任何责任。

这是否有帮助？

将多个站点合并到一个站点

May 4, 2026

投稿者:

C C

May 4, 2026

投稿者:

C C

这是否有帮助？

将多个站点合并到一个站点

前缀和后缀规则

按站点对组件进行分组

按名称对组件进行分组

前缀和后缀映射文件

导出本地站点

集中导出目标文件夹

直接文件共享

使用 SiteMerging.yml 的文件共享引用

合并站点

使用站点前缀删除组件

在本文中