Citrix DaaS™

查看 PDF

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

September 12, 2025

投稿者:

C C

自动化配置的多站点支持提供了一种将多个本地站点合并到单个云站点的方法。

多站点支持会根据每个本地站点为组件名称添加唯一的前缀和后缀，以确保在将多个本地站点合并到单个云站点后名称的唯一性。

可以根据每个本地站点为以下每个组件分配前缀和后缀。

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 成员，并降低了在导出、导入、合并或添加时定位错误文件夹的可能性。

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

直接文件共享

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

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

从 East Delivery Controller™：

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

Export-CvadAcToFile   –TargetFolder   \\share.central.net\AutoConfig\SiteEast
<!--NeedCopy-->

从 West Delivery Controller：

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 参数。

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

已安装该工具的其中一个本地 Delivery Controller。
托管文件共享的计算机。
另一台计算机。

必须在访问云的计算机上安装自动化配置。既不使用本地 PowerShell SDK、Delivery Controller，也不使用 Active Directory，因此云访问执行要求比导出要求更简单。

要将 East Delivery Controller 合并到云中：

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: ""
<!--NeedCopy-->

使用 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: ""
<!--NeedCopy-->

合并站点

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 不承担任何责任。

这是否有帮助？

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

September 12, 2025

投稿者:

C C

September 12, 2025

投稿者:

C C

这是否有帮助？