Citrix Virtual Apps and Desktops 服务

迁移到云

如果您具有 Citrix Virtual Apps and Desktops 本地配置,并且希望将其移动到 Citrix Virtual Apps and Desktops 部署,或者您有希望移至另一个区域的 Citrix Virtual Apps and Desktops 服务部署,您希望备份和还原配置,或者您已达到资源限制,则现在可以使用自动配置工具来迁移全部或部分配置。

下面这个 2 分钟的视频提供了自动配置的快速浏览。

视频图标

有关自动配置的详细信息,请参阅 Tech Zone 上的 概念证明:自动配置工具

要进一步了解如何移动您的部署和准备好待迁移的配置,请参阅 Tech Zone 上的 部署指南:将 Citrix Virtual Apps and Desktops 从本地迁移到 Citrix Cloud

自动配置入门

通过适用于 Citrix Virtual Apps and Desktops 的自动配置,您可以自动从以下位置移动 Citrix Virtual Apps and Desktops 服务部署:

自动配置可将您的配置信息导出到 .yml 文件集合中,然后可以根据需要对这些文件进行编辑(用于暂存迁移)并将其导入到 Citrix Virtual Apps and Desktops 服务中。

本部分提供了执行自动配置功能所需的常见详细信息。

下载自动配置

Citrix 下载 下载并安装自动配置工具。

重要:

为防止功能出现错误,应始终使用可用的最新版本的自动配置。

升级自动配置

在自动配置中运行访问云的 cmdlet 时,当有更新版本可供下载时,该工具会提醒您。

自动化配置升级

可以按照以下步骤确保拥有最新版本:

  1. 双击自动配置图标。此时将显示 PowerShell 窗口。
  2. 运行以下命令以检查您的版本号。

    Get-CvadAcStatus

  3. 根据警告或 Citrix 下载 中列出的版本检查您的工具版本。该工具的最新版本位于此处。
  4. 下载并安装最新版本的工具。需卸载旧版本即可升级自动配置。

注意:

每次运行访问云的 cmdlet 时都会出现警报。有关 cmdlet 的详细信息,请参阅自动配置工具 cmdlet

迁移配置的必备条件

自动配置的用户必须熟练掌握以下内容:

  • Citrix Virtual Apps and Desktops 设置和管理
  • YAML 标准
  • PowerShell

用于从 Citrix Virtual Apps and Desktops 导出 配置:

  • Citrix Virtual Apps and Desktops:当前版本及其直接前代产品或 Citrix Virtual Apps and Desktops、XenApp 和 XenDesktop LTSR:所有版本
  • 一个本地 Delivery Controller 和至少一个本地 VDA
  • 装有 .NET Framework 4.7.2 或更高版本的计算机
  • 安装了 Citrix PowerShell SDK 的计算机。这将自动安装在 Delivery Controller 上。(要在本地 Delivery Controller 以外的计算机上运行,计算机必须加入域且必须安装 Citrix Studio,这样 Studio 才能安装正确的 PowerShell 管理单元。可以在 Citrix Virtual Apps and Desktops 安装介质 中找到 Studio 安装程序。)

用于将您的配置导入到 Citrix Virtual Apps and Desktops 服务中:

  • 有权访问 Citrix Cloud 的计算机。这不一定是 Delivery Controller 或加入了域的计算机。
  • 已预配 Citrix Virtual Apps and Desktops 服务。
  • 安装了 Connector 并加入到与本地设置相同的域的活动资源位置。
  • 必须允许并且可以连接到访问 Citrix Cloud 的站点。有关详细信息,请参阅Virtual Apps and Desktops 服务连接

支持迁移的对象

自动配置支持以下组件。

  • 标记
  • 委派管理员
    • 作用域
    • 角色
  • 主机连接
    • 单个资源池
    • 管理员作用域
  • 计算机目录
    • 管理员作用域
    • 计算机
    • Remote PC Access、物理、池化、已预配(MCS 除外)、已分配
  • 交付组
    • 访问策略
    • 管理员范围关联
    • 应用程序访问策略
    • 分配策略
    • 注册/桌面策略
    • 电源计划
    • 会话延迟
    • 会话预启动
    • 重新启动计划
    • 标记
  • 应用程序组
    • 管理员范围关联
    • 交付组
    • 用户和组
  • 应用程序
    • 应用程序文件夹
    • 图标
    • 应用程序
    • 代理配置的 FTA
    • 标记
  • 组策略

组件依赖关系

创建本地站点时,由于对之前的项目的依赖关系,必须按特定顺序执行创建步骤。自动配置的工作原则相同。

导入过程旨在准确执行更新,仅执行所需的更新,并验证所有更新是否都已正确进行。

必须按照创建所需依赖关系时的顺序来导入组件。以下列表标识了 ExportImportMergeNewSyncRestore 命令中可以选择的组件。这些组件按依赖顺序列出。不按依赖顺序导入可能会导致导入失败,进而导致操作失败。

  1. 标记
  2. 管理员角色和作用域(包括作用域和角色,不包括管理员)
  3. 主机连接
  4. 计算机目录
  5. 交付组(包括 StoreFront)
  6. 应用程序组
  7. 应用程序(包括应用程序文件夹)
  8. 组策略

必须按照创建所需依赖关系时的顺序来导入组件。在执行单个 cmdlet 以导入、合并或还原多个组件时,自动配置会对组件进行正确排序。

使用多个命令导入单个组件时,必须对组件进行排序,以便按照所需顺序导入依赖项。

在成功导入整个站点配置后,可以针对更新执行单独导入操作。

依赖关系详细信息

此处列出了组件及其依赖关系。组件的依赖关系必须到位,才能将其导入或合并。如果缺少依赖关系,则可能会导致导入或合并命令失败。如果导入或合并失败,日志文件的 Fixups 部分会显示缺少依赖关系。

  1. 标记
    • 无预依赖关系
  2. 委派管理员
    • 无预依赖关系
  3. 主机连接
    • CvadAcSecurity.yml 中的安全信息
  4. 计算机目录
    • Active Directory 中存在的计算机
    • 主机连接
    • 标记
  5. 交付组
    • Active Directory 中存在的计算机
    • Active Directory 中存在的用户
    • 计算机目录
    • 标记
  6. 应用程序组
    • 交付组
    • 标记
  7. 应用程序
    • 交付组
    • 应用程序组
    • 标记
  8. 组策略
    • 交付组
    • 标记

已知限制

生成客户 ID、客户端 ID 和密钥

以下步骤允许您检索客户 ID 以及创建将配置导入 Citrix Cloud 时所需的客户端 ID 和密钥。所有访问云的 cmdlet 都需要这些值。

要检索客户 ID,请执行以下操作:

  1. 登录到您的 Citrix Cloud 帐户并选择相应客户。

    客户 ID 图像 1

  2. 单击汉堡菜单,然后选择下拉菜单中的身份识别和访问管理

    客户 ID 图像 2

  3. 客户 ID 位于身份和访问管理页面上。

    客户 ID 图像 35

要检索客户端 ID密钥,请执行以下操作:

  1. 身份识别和访问管理页面上,单击 API 访问选项卡。

    客户 ID 图像 3

  2. 在该框中输入名称。此名称用于区分多个客户端 ID 和密钥。单击创建客户端以创建客户端 ID 和密钥。

    客户 ID 图像 4

  3. 成功创建客户端 ID 和密钥后,将显示以下对话框。请务必将这两个值复制到安全位置或下载包含这些信息的 .csv 文件。

    客户 ID 图像 5

  4. 已成功创建客户端 ID 和密钥。

    客户 ID 图像 6

将这些值置于安全位置,并仅与需要访问该工具或访问云 REST API 的受信任公司成员共享。客户端 ID 和密钥不会过期。如果它们被盗用,请立即使用垃圾桶图标将其删除,然后创建新的客户端 ID 和密钥。

注意:

密钥在丢失或忘记的情况下无法找回;必须创建新的客户端 ID 和密钥。

填充客户信息文件

使用 CustomerInfo.yml 文件无需在执行每个 cmdlet 时提供客户信息参数。使用 cmdlet 参数可以覆盖任何客户信息。

使用 New-CvadAcCustomerInfoFile cmdlet 创建 CustomerInfo.yml 文件。New-CvadAcCustomerInfoFile 具有以下必需的参数。

  • CustomerId – 客户的 ID。
  • ClientId – 客户的客户端 ID(在 Citrix Cloud 上创建)。
  • Secret – 客户的密钥(在 Citrix Cloud 上创建)。

New-CvadAcCustomerInfoFile -CustomerId markhof123 -ClientId 6813EEA6-46CC-4F8A-BC71-539F2DAC5984 -Secret TwBLaaaaaaaaaaaaaaaaaw==

通过使用 Set-CvadAcCustomerInfoFile cmdlet 来更新 CustomerInfo.yml 文件。

注意:

cmdlet 只会更改客户端 ID。

Set-CvadAcCustomerInfoFile -ClientId C80487EE-7113-49F8-85DD-2CFE30CC398E

下面是一个示例 CustomerInfo.yml 文件。

---
#  Created/Updated on 2020/01/29 16:46:47
CustomerId: "markhof123"
CustomerId: "markhof123"
ClientId: "6713FEA6-46CC-4F8A-BC71-539F2DDK5384"
Secret: "TwBLaaabbbaaaaaaaaaaw=="
LogFileName: "CitrixLog"
Environment: Production
AltRootUrl: ""
StopOnError: False
AlternateFolder: ""
Locale: "en-us"
Editor: “C:\Program Files\Notepad++\notepad++.exe”
Confirm: True
DisplayLog: True

填充区域映射文件

本地区域相当于云资源位置。与其他站点组件不同,您无法自动将本地区域导入到云中。相反,必须使用 ZoneMapping.yml 文件手动对其进行映射。如果区域名称与现有资源位置名称未关联,则可能会发生导入失败。

对于只有一个区域的本地站点和只有一个资源位置的云站点,自动配置工具可以进行正确的关联,这样将无需手动管理 ZoneMapping.yml 文件。

对于具有多个区域的本地站点或具有多个资源位置的云站点,ZoneMapping.yml 文件必须手动更新,以反映本地区域到云资源位置的正确映射。在尝试向云中执行任何导入操作之前,必须执行此操作。

ZoneMapping.yml 文件位于 %%HOMEPATH%\Documents\Citrix\AutoConfig 下。.yml 文件的内容是区域名称为键且资源位置名称为值的字典。

例如,将包含名为“Zone-1”的主区域和名为“Zone-2”的辅助区域的本地 Citrix Virtual Apps and Desktops 站点迁移到包含两个新创建的名为“Cloud-RL-1”和“Cloud-RL-2”的云资源位置的 Citrix Virtual Apps and Desktops 云部署。在这种情况下,ZoneMapping.yml 将按如下所示进行配置:

---
Zone-1: Cloud-RL-1

Zone-2: Cloud-RL-2

注意:

冒号与资源位置名称之间必须有一个空格。如果区域或资源位置名称中使用空格,请将名称用引号引起。

从本地迁移到云

自动配置允许您自动将本地配置移动到云站点。

迁移高级视图

迁移是从源导出数据然后将相同的数据导入目标的过程。这就是自动配置的作用。对于从本地环境迁移到云的客户,源是其本地站点和目标云站点。在最简单的形式中,首次使用迁移过程的步骤和示例 cmdlet 如下。

  1. 下载并安装自动配置工具。
  2. 导出本地数据 (Export-CvadAcToFile)。
  3. 获取访问云站点所需的安全信息。
  4. 创建包含自动配置工具使用的安全信息的客户信息文件 (New-CvadAcCustomerInfoFile)。
  5. 将本地数据导入云中(Import-CvadAcToSiteMerge-CvadAcToSiteNew-CvadAcToSite)。

连续迁移甚至更简单。

  1. 导出本地数据 (Export-CvadAcToFile)。
  2. 将本地数据导入云中(Import-CvadAcToSiteMerge-CvadAcToSiteNew-CvadAcToSite)。

以上步骤甚至可以减少到一个步骤。

  1. 导出和导入 (Sync-CvadAcSiteToSite)。

导出 Citrix Virtual Apps and Desktops 本地配置

重要:

  • 您必须附上您的 CustomerInfo.yml 文件以及您的客户 ID、客户端 ID和密钥信息。有关如何检索客户 ID、客户端 ID和密钥的详细信息,请参阅生成客户 ID、客户端 ID 和密钥。有关如何将这些信息添加到 CustomerInfo.yml 文件中的信息,请参阅填充客户信息文件
  • ZoneMapping.yml 文件必须包含将本地区域映射到云中的资源位置的信息。有关如何映射您的区域的详细信息,请参阅填充区域映射文件
  • 如果您有主机连接,则必须在 CvadAcSecurity.yml 文件中输入相应的信息。
  1. 安装自动配置。
  2. 双击自动配置图标。此时将显示 PowerShell 窗口。
  3. 运行以下命令以导出所有组件。

    Export-CvadAcToFile

首次运行任何 cmdlet 之后,系统将创建包含 .yml 配置文件和日志的 export 文件夹。该文件夹位于 %HOMEPATH%\Documents\Citrix\AutoConfig 中。每次连续导出都将创建一个子文件夹。父文件夹 %HOMEPATH%\Documents\Citrix\AutoConfig 始终包含最近导出的对象中的导出文件。

注意:

如果 Delivery Controller 上未安装自动配置,请在通过 PowerShell 使用该工具之前运行 import-module Citrix.AutoConfig.Commands。如果使用自动配置图标打开自动配置,则不需要执行此操作。

如果您遇到任何错误或异常,请参阅日志文件中的 Fixups 部分。

将配置导入 Citrix Virtual Apps and Desktops 服务中

重要:

  • 您必须附上您的 CustomerInfo.yml 文件以及您的客户 ID、客户端 ID和密钥信息。有关如何检索客户 ID、客户端 ID和密钥的详细信息,请参阅生成客户 ID、客户端 ID 和密钥。有关如何将这些信息添加到 CustomerInfo.yml 文件中的信息,请参阅填充客户信息文件
  • ZoneMapping.yml 文件必须包含将本地区域映射到云中的资源位置的信息。有关如何映射您的区域的详细信息,请参阅填充区域映射文件
  • 如果您有主机连接,则必须在 CvadAcSecurity.yml 文件中输入相应的信息。

运行导入

  1. 双击自动配置图标。此时将显示 PowerShell 窗口。
  2. 运行以下命令以导入所有组件。

    Merge-CvadAcToSite

请使用新的当前状态来验证预期状态。各种导入选项控制导入结果相同还是属于本地站点的子集。有关选项和结果状态的说明,请参阅通过命令派生的状态结果

运行该 cmdlet 之后,系统将创建包含 .yml 配置文件和日志的 export 文件夹。该文件夹位于 %HOMEPATH%\Documents\Citrix\AutoConfig 中。

如果您遇到任何错误或异常,请参阅日志文件中的 Fixups 部分。

注意:

如果 Delivery Controller 上未安装自动配置,请在通过 PowerShell 使用该工具之前运行 import-module Citrix.AutoConfig.Commands。如果使用自动配置图标打开自动配置,则不需要执行此操作。

要还原到原始 CCitrix Virtual Apps and Desktops 服务配置,请参阅备份您的 Citrix Virtual Apps and Desktops 服务配置

详细的导入操作

导入过程旨在准确执行更新,仅执行所需的更新,并验证所有更新是否正确进行。下面是所有导入操作遵循的步骤。

  1. 读取导出的 .yml 文件(预期状态)。
  2. 读取云(当前状态)。
  3. 将预导入云状态备份到 .yml 文件(如有必要,可以恢复预备份)。
  4. 评估预期状态与当前状态之间的差异。这决定了要进行哪些更新。
  5. 进行更新。
  6. 重读云(新的当前状态)。
  7. 将导入后的云状态备份到 .yml 文件(如有必要,可以恢复备份后状态)。
  8. 将新的当前状态与预期状态进行比较。
  9. 报告比较的结果。

激活站点

注意:

此功能仅在 2.0 版及更高版本上可用。在自动配置中使用 Get-CvadAcStatus 检查您的版本

本地站点和云站点中的 Delivery Controller 可以控制诸如代理桌面、应用程序和重新启动计算机等资源。当一组常见的资源由两个或更多站点控制时会出现问题。从本地站点迁移到云站点时,可能会发生这种情况。本地 Delivery Controller 和云端 Delivery Controller 都可以管理相同的一组资源。这种双重管理可能会导致资源变得不可用和无法管理,并且可能难以诊断。

站点激活允许您控制活动站点的控制位置。

使用交付组维护模式管理站点激活。当站点处于非活动状态时,交付组将处于维护模式。对于处于活动状态的站点,将从交付组中删除维护模式。

  • Set-CvadAdSiteActiveStateCloud
  • Set-CvadAdSiteActiveStateOnPrem

所有 cmdlet 都支持 IncludeByNameExcludeByName 过滤。

将控制权导入和转移到云

下面是关于如何将控制权从本地站点导入和转移到云站点的高级说明。

  1. 将本地站点导出并导入到云中。确保任何导入 cmdlet 上都不存在 –SiteActive 参数。本地站点处于活动状态,云站点处于非活动状态。默认情况下,云站点交付组处于维护模式。
  2. 验证云内容和配置。
  3. 在空闲时间,将本地站点设置为非活动状态。–SiteActive 参数必须不存在。所有本地站点交付组都处于维护模式。
    • Set-CvadAcSiteActiveStateOnPrem
  4. 将云站点设置为活动状态。–SiteActive 参数必须存在。没有云站点交付组处于维护模式。
    • Set-CvadAcSiteActiveStateCloud –SiteActive
  5. 验证云站点是否处于活动状态且本地站点处于非活动状态。

将控制权转移回本地站点

要将控制权从云站点转移到本地站点,请执行以下操作:

  1. 在空闲时间,将云站点设置为非活动状态。所有云站点交付组都处于维护模式。
    • Set-CvadAcSiteActiveStateCloud
  2. 将本地站点设置为活动状态。没有本地站点交付组处于维护模式。
    • Set-CvadAcSiteActiveStateOnPrem -SiteActive

从云迁移到云

自动配置允许您自动将云配置移动到另一个云站点,或允许您还原自己的云站点。

移动 CCitrix Virtual Apps and Desktops 服务配置有很多好处,原因如下:

  • 从一个区域迁移到另一个区域
  • 将您的站点从测试或阶段同步到生产
  • 达到资源限制

备份您的 Citrix Virtual Apps and Desktops 服务配置

注意:

在开始之前,请按照迁移配置的必备条件中的导入步骤将配置从一个云迁移到另一个云。

重要:

  • 您必须附上您的 CustomerInfo.yml 文件以及您的客户 ID、客户端 ID和密钥信息。有关如何检索客户 ID、客户端 ID和密钥的详细信息,请参阅生成客户 ID、客户端 ID 和密钥。有关如何将这些信息添加到 CustomerInfo.yml 文件中的信息,请参阅填充客户信息文件
  • ZoneMapping.yml 文件必须包含将资源区域映射到云中的信息。有关如何映射您的区域的详细信息,请参阅填充区域映射文件
  • 如果您有主机连接,则必须在 CvadAcSecurity.yml 文件中输入相应的信息。
  1. 安装自动配置。

    注意:

    对于云到云的迁移,可以在管理员有权直接访问 Internet 的计算机上安装自动配置。

  2. 双击自动配置图标。此时将显示 PowerShell 窗口。
  3. 请运行以下命令以执行备份。

    Backup-CvadAcToFile

首次运行任何 cmdlet 之后,系统将创建包含 .yml 配置文件和日志的 export 文件夹。该文件夹位于 %HOMEPATH%\Documents\Citrix\AutoConfig 中。

如果您遇到任何错误或异常,请参阅日志文件中的 Fixups 部分。

将配置还原到 Citrix Virtual Apps and Desktops 服务中

注意:

本部分紧跟备份您的 Citrix Virtual Apps and Desktops 服务配置,并在此处记录了步骤。在开始执行还原操作之前,请按照这些步骤进行操作。

运行还原

  1. 双击自动配置图标。此时将显示 PowerShell 窗口。
  2. 请运行以下命令以执行还原。

    Restore-CvadAcToSite -RestoreFolder <folder path of the backup files>

请使用新的当前状态来验证预期状态。

运行该 cmdlet 之后,系统将创建包含 .yml 配置文件和日志的 export 文件夹。该文件夹位于 %HOMEPATH%\Documents\Citrix\AutoConfig 中。

如果您遇到任何错误或异常,请参阅日志文件中的 Fixups 部分。

激活站点

站点激活允许您控制活动站点的控制位置。有关激活站点的详细信息,请参阅激活站点

备份和还原

备份和还原过程可保护您免受无意中的云站点配置更改或损坏的影响。虽然自动配置在每次进行更改时都会进行备份,但此备份反映了更改之前云站点配置的状态。保护自己需要定期备份云站点配置,并将其保存在一个安全的位置。如果发生了不希望的更改或损坏,备份可以用于在粒度或完整站点配置级别修复更改或损坏。

备份

要进行备份,请运行备份 cmdlet:Backup-CvadAcToFile

尽管备份时可以选择单个组件,但 Citrix 建议备份所有组件。备份放置在根文件夹下的唯一命名文件夹中:%HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss

Restore(还原)

可以从任何备份完成还原,以还原一个或多个组件成员、一个或多个组件或完整的云站点配置。

还原组件成员

还原一个或多个组件成员将使用 IncludeByName 功能。Restore cmdlet 随 RestoreFrom 参数以及选定的单个组件和包含列表一起调用。

要从备份中还原两个组策略,请按照以下示例进行操作:

Restore-CvadAcToSite -RestoreFrom %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss

-GroupPolicies $true -IncludeByName Policy1,Policy2

还原整个组件

还原一个组件涉及选择一个或多个组件参数。

要还原整个交付组和计算机目录组件,请按照以下示例进行操作:

Restore-CvadAcToSite -RestoreFrom %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss

-DeliveryGroups $true -MachineCatalogs $true

还原整个云站点配置

还原完整的云站点配置意味着选择要还原的所有组件。

要还原整个云站点配置,请按照以下示例进行操作:

Restore-CvadAcToSite -RestoreFrom %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss

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

注意:

此功能仅在 2.0 版及更高版本上可用。在自动配置中使用 Get-CvadAcStatus 检查您的版本

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

多站点支持在每个本地站点的基础上为组件名称添加唯一的前缀和后缀,从而确保在多个本地站点合并到单个云站点后名称的唯一性。

可以在每个本地站点的基础上为以下每个组件分配前缀和后缀。

  • AdminScope
  • AdminRole
  • ApplicationAdmin
  • ApplicationFolder
  • ApplicationGroup
  • ApplicationUser
  • DeliveryGroup
  • GroupPolicy
  • HostConnection
  • MachineCatalog
  • StoreFront
  • Tag

应用程序文件夹支持前缀、后缀和重新生根。重新生根将额外的顶层文件夹添加到应用程序的现有文件夹结构中。

前缀和后缀规则

  1. 前缀和后缀不能包含以下任何特殊字符:\ , / ; : # . * ? = < > | ( ) " ' { } [ ]
  2. 前缀和后缀可以包含尾随空格,但不能包含前导空格。
  3. 前缀和后缀必须用双引号引起才能包含尾随空格。
  4. 在导入、合并和添加时,会应用前缀和后缀。源 .yml 文件永远不会被修改。
  5. 如果适用,前缀和后缀过程会自动为相关组件名称添加前缀或后缀。例如,如果计算机目录名称以“East”作为前缀,则引用这些名称的交付组也会以“East”作为前缀。
  6. 如果组件名称以前缀或后缀开头,则不会添加前缀或后缀。组件名称不能包含两个相同的前缀或后缀。
  7. 前缀和后缀可以单独使用,也可以组合使用。
  8. 在组件上使用前缀或后缀是可选的。

注意:

完整配置界面按字母顺序显示组件。

按站点分组

使用前缀可以直观地对单个站点中的组件进行分组。每个站点都在自己的组中列出,前缀按字母顺序控制不同站点组的顺序。

按名称分组

使用后缀可以直观地对来自多个站点的类似命名组件进行分组。来自不同站点的类似命名组件看上去会交替使用。

SitePrefixes.yml 文件

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

导出、导入、合并和添加

合并在导出本地站点之后才能开始进行。要导出本地站点,请参阅从本地迁移到云

中央导出目标文件夹

本部分中介绍的方法可将多个站点导出放置到一个中央文件共享位置。SiteMerging.yml 文件、CustomerInfo.yml 文件和所有导出文件都位于该文件共享位置,允许您从独立于本地站点的一个位置进行导入。

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

直接文件共享

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

要将导出定位到特定于站点的文件夹,请使用 –TargetFolder 参数:

来自 East DDC:

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

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

来自 West DDC:

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

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

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

注意:

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

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

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

自动配置必须安装在访问云的计算机上。本地 PowerShell SDK、DDC 和 Active Directory 均未使用,因此云访问执行要求比导出要求简单。

要将 East DDC 合并到云,请执行以下操作:

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

要将 West DDC 合并到云,请执行以下操作:

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

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

East:
  SiteRootFolder: "" # Important: leave this empty
  AdminScopePrefix: "East_"
  AdminRolePrefix: "East_"
  ApplicationAdminPrefix: "East_"
  ApplicationFolderPrefix: "" # Note that a new parent root folder is used instead
  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: "" # Important: leave this empty
  AdminScopePrefix: "Western "
  AdminRolePrefix: "Western "
  ApplicationAdminPrefix: "Western "
  ApplicationFolderPrefix: "" # Note that a new parent root folder is used instead
  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。必须在共享位置执行此操作。

Set-CvadAcSitePrefixes –SiteName East –SiteRootFolder \\share.central.net\AutoConfig\SiteEast -SitePrefixesFolder \\share.central.net\AutoConfig

Set-CvadAcSitePrefixes –SiteName West –SiteRootFolder SiteWest -SitePrefixesFolder \\share.central.net\AutoConfig

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

要使用 SiteMerging.yml 文件将导出定位到特定于站点的文件夹,请执行以下操作:

来自 East DDC:

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

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

来自 West DDC:

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

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

导出 cmdlet 使用 CustomerInfo.yml 文件夹位置来查找 SiteMerging.yml 文件。就 East 而言,SiteRootFolder 是完限定的规范。它按原样使用。就 West 而言,SiteRootFolder 不是完全限定的规范。它与 CustomerInfo.yml 文件夹位置相结合,以检索 West 的完全限定文件夹位置。

要将 East DDC 合并到云,请执行以下操作:

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

要将 West DDC 合并到云,请执行以下操作:

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

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

East:
  SiteRootFolder: "\\\share.central.net\AutoConfig\SiteEast"
  AdminScopePrefix: "East_"
  AdminRolePrefix: "East_"
  ApplicationAdminPrefix: "East_"
  ApplicationFolderPrefix: "" # Note that a new parent root folder is used instead
  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: "" # Note that a new parent root folder is used instead
  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: ""

如果未使用中央文件共享方法,而导入、合并或添加是从单个 DDC 完成的,则在每个要迁移到云的 DDC 上创建和复制 SiteMerging.yml 文件。默认位置为 %HOMEPATH%\Documents\Citrix\AutoConfig。必须指定 –SiteName 参数才能选择正确的站点前缀。

合并站点

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

  1. 使用适当的 SiteName 值将初始站点合并到云。
  2. 在 Studio(本地或 Web)中查看结果。
  3. 如果结果不正确,请确定问题及其原因,更正,然后重新运行合并。如有必要,请删除云组件,然后使用 Remove-CvadAcFromSite 为选定的组件和成员从头开始执行操作。如果结果正确,则请继续。
  4. 如果初始合并正确,则将第二个站点合并到单个云站点。
  5. 重复步骤 2 和 3。
  6. 如果第二次合并正确,则将第三个站点合并到单个云站点。
  7. 重复步骤 2 和 3。
  8. 从用户的角度查看资源并验证视图是否处于所需状态。

使用站点前缀删除组件

可以通过使用 Remove-CvadAcFromSite cmdlet 的 –IncludeByName 参数上的前缀有选择地删除单个站点组件。在以下示例中,West DDC 交付组不正确。要仅删除 West 站点的交付组,请执行以下操作:

Remove-CvadAcFromSite –DeliveryGroups –IncludeByName “Western *”

要删除所有 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”

自动配置工具 cmdlet

站点管理 cmdlet

  • Export-CvadAcToFile

    导出本地设置中的配置。这是自动配置的默认导出操作。不对本地站点配置进行任何修改。导出的文件将放置在位于命名的导出子文件夹的目录 %HOMEPATH%\Documents\Citrix\AutoConfig 中。文件夹 %HOMEPATH%\Documents\Citrix\AutoConfig 始终包含最新导出的本地站点配置。

    参数:

    • 请参阅组件选择参数
    • 请参阅按对象名称过滤
    • TargetFolder - 指定导出目标文件夹。
    • Locale - 指定可以导出的人类可读文本的语言。
    • Quiet - 禁止登录控制台(仅在2.0 版或更高版本时可用)。
    • AdminAddress - 在 Delivery Controller 上未运行导出时,指定 Delivery Controller 的 DNS 或 IP 地址。
    • CheckUserAndMachines - 验证用户和计算机是否在 Active Directory 中。不在 Active Directory 中的用户和计算机可能会导致导入失败。

    返回结果:

  • Import-CvadAcToSite

    将所有本地文件导入到云端。此命令可确保云端状态与本地状态相同。此选项将删除云中存在的所有更改。导入的站点配置文件来自 %HOMEPATH%\Documents\Citrix\AutoConfig请小心使用。

    参数:

    • 请参阅组件选择参数
    • 请参阅按对象名称过滤
    • 请参阅云访问参数
    • SourceFolder - 标识 %HOMEPATH%\Documents\Citrix\AutoConfig 的替代根文件夹。
    • Locale - 指定可以导出的人类可读文本的语言。
    • Quiet - 禁止登录控制台(仅在2.0 版或更高版本时可用)。
    • DisplayLog - 在 cmdlet 完成时显示日志文件。设置为 $false 将禁止日志显示。
    • Merge - 如果设置为 $true,则仅向云站点添加组件。组件不会被删除。设置为 $false 将删除组件。
    • AddOnly - 如果设置为 $true,则仅添加新组件,不会更新或删除现有组件。设置为 $false 将允许更新和删除。当此参数为 $true 时,将忽略 Merge

    返回结果:

  • Merge-CvadAcToSite

    将本地文件合并到云端,但不删除云中的任何组件。这将保留已在云中进行的更改。如果 Citrix Cloud 中存在同名组件,此命令可以修改该组件。这是自动配置的默认导入操作。合并的站点配置文件来自 %HOMEPATH%\Documents\Citrix\AutoConfig

    参数:

    • 请参阅组件选择参数
    • 请参阅按对象名称过滤
    • 请参阅云访问参数
    • SourceFolder - 标识 %HOMEPATH%\Documents\Citrix\AutoConfig 的替代根文件夹。
    • Locale - 指定可以导出的人类可读文本的语言。
    • Quiet - 禁止登录控制台(仅在2.0 版或更高版本时可用)。
    • DisplayLog - 在 cmdlet 完成时显示日志文件。设置为 $false 将禁止日志显示。
    • AddOnly - 如果设置为 $true,则仅添加新组件,不会更新或删除现有组件。设置为 $false 将允许更新和删除。当此参数为 $true 时,将忽略 Merge

    返回结果:

  • Restore-CvadAcToSite

    将云站点还原到之前的配置。已导入的文件源自 -RestoreFolder 参数中指定的文件夹。此文件夹可用于恢复到之前的配置或用于对云站点进行备份和还原。

    参数:

    • 请参阅组件选择参数
    • 请参阅按对象名称过滤
    • 请参阅云访问参数
    • RestoreFolder - 标识包含要还原到云站点的 .yml 文件的文件夹。这必须是完全限定的文件夹规范。
    • Locale - 指定可以导出的人类可读文本的语言。
    • Quiet - 禁止登录控制台(仅在2.0 版或更高版本时可用)。
    • DisplayLog - 在 cmdlet 完成时显示日志文件。设置为 $false 将禁止日志显示。
    • Merge - 如果设置为 $true,则仅向云站点添加组件。组件不会被删除。设置为 $false 将删除组件。
    • AddOnly - 如果设置为 $true,则仅添加新组件,不会更新或删除现有组件。设置为 $false 将允许更新和删除。当此参数为 $true 时,将忽略 Merge

    返回结果:

  • New-CvadAcToSite

    将本地站点配置导入到云端,但仅添加新组件。现有云站点组件既不会更新,也不会删除。如果现有云站点组件必须保持不变,请使用此命令。

    参数:

    • 请参阅组件选择参数
    • 请参阅按对象名称过滤
    • 请参阅云访问参数
    • SourceFolder - 标识 %HOMEPATH%\Documents\Citrix\AutoConfig 的替代根文件夹。
    • Locale - 指定可以导出的人类可读文本的语言。
    • Quiet - 禁止登录控制台(仅在2.0 版或更高版本时可用)。
    • DisplayLog - 在 cmdlet 完成时显示日志文件。设置为 $false 将禁止日志显示。

    返回结果:

  • Sync-CvadAcToSite

    Sync 在一个步骤中同时执行导出和导入。

    参数:

    • 请参阅组件选择参数
    • 请参阅按对象名称过滤
    • 请参阅云访问参数
    • SourceTargetFolder - 指定导出/导入目标文件夹。
    • Locale - 指定可以导出的人类可读文本的语言。
    • AdminAddress - 在 Delivery Controller 上未运行导出时,指定 Delivery Controller 的 DNS 或 IP 地址。
    • Quiet - 禁止登录控制台(仅在2.0 版或更高版本时可用)。
    • DisplayLog - 在 cmdlet 完成时显示日志文件。设置为 $false 将禁止日志显示。
    • Merge - 如果设置为 $true,则仅向云站点添加组件。组件不会被删除。设置为 $false 将删除组件。
    • AddOnly - 如果设置为 $true,则仅添加新组件,不会更新或删除现有组件。设置为 $false 将允许更新和删除。当此参数为 $true 时,将忽略 Merge

    返回结果:

  • Backup-CvadAcToFile

    将云配置导出到 .yml 文件。此备份可以在备份和还原过程中用来恢复丢失的组件。

    参数:

    • 请参阅组件选择参数
    • 请参阅云访问参数
    • TargetFolder - 指定导出目标文件夹。
    • Locale - 指定可以导出的人类可读文本的语言。
    • Quiet - 禁止登录控制台(仅在2.0 版或更高版本时可用)。
    • DisplayLog - 在 cmdlet 完成时显示日志文件。设置为 $false 将禁止日志显示。

    返回结果:

  • Compare-CvadAcToSite

    将本地 .yml 文件与云配置进行比较,生成 ImportMergeRestore cmdlet 所做的更改的报告。

    参数:

    • 请参阅组件选择参数
    • 请参阅按对象名称过滤
    • 请参阅云访问参数
    • SourceFolder - 标识 %HOMEPATH%\Documents\Citrix\AutoConfig 的替代根文件夹。
    • Locale - 指定可以导出的人类可读文本的语言。
    • Quiet - 禁止登录控制台(仅在2.0 版或更高版本时可用)。
    • DisplayLog - 在 cmdlet 完成时显示日志文件。设置为 $false 将禁止日志显示。
    • Merge - 如果设置为 $true,则仅向云站点添加组件。组件不会被删除。设置为 $false 将删除组件。
    • AddOnly - 如果设置为 $true,则仅添加新组件,不会更新或删除现有组件。设置为 $false 将允许更新和删除。当此参数为 $true 时,将忽略 Merge

    返回结果:

  • Remove-CvadAcFromSite

    可以重置整个站点或删除组件中的成员项(例如,从目录列表中删除一个计算机目录)。当与 IncludeByName 参数结合使用以选择性地删除特定成员时,可以使用此命令。

    参数:

    返回结果:

客户信息文件 cmdlet

  • New-CvadAcCustomerInfoFile

    创建客户信息文件。默认情况下,客户信息文件位于 %HOMEPATH%\Documents\Citrix\AutoConfig 下。

    参数:

    • CustomerId - 客户的 ID(必填)。
    • ClientId - 在 Citrix Cloud 上创建的客户端 ID(必填)。
    • Secret - 在 Citrix Cloud 上创建的客户的密钥(必填)。
    • Environment - 生产或生产管控环境。
    • LogFileName - 将 CitrixLog 日志文件前缀更改为其他内容。
    • StopOnError - 第一次出现错误时停止操作。
    • AlternateRootFolder - 使用指定的文件夹作为根文件夹,代替 %HOMEPATH%\Documents\Citrix\AutoConfig
    • Locale - 使用指定的本地设置,而非从运行该工具的系统派生的区域设置。
    • Editor - 使用指定的编辑器在每个 cmdlet 完成时显示日志。Notepad.exe 为默认编辑器。此参数必须在编辑器中包含完全限定的文件规范,编辑器必须将日志文件规范作为其唯一的参数。

    返回结果:

    示例:

    New-CvadAcCustomerInfoFile -CustomerId markhof123 -ClientId 6813EEA6-46CC-4F8A-BC71-539F2DAC5984 -Secret TwBLaaaaaaaaaaaaaaaaaw==

  • Set-CvadAcCustomerInfoFile

    更新现有的客户信息文件。只更改 cmdlet 指定的参数,CustomerInfo.yml 文件中所有未指定的参数值都保持不变。

    参数:

    • CustomerId - 客户的 ID(必填)。
    • ClientId - 在 Citrix Cloud 上创建的客户端 ID(必填)。
    • Secret - 在 Citrix Cloud 上创建的客户的密钥(必填)。
    • Environment - 生产或生产管控环境。
    • LogFileName - 将 CitrixLog 日志文件前缀更改为其他内容。
    • StopOnError - 第一次出现错误时停止操作。
    • AlternateRootFolder - 使用指定的文件夹作为根文件夹,代替 %HOMEPATH%\Documents\Citrix\AutoConfig
    • Locale - 使用指定的本地设置,而非从运行该工具的系统派生的区域设置。
    • Editor - 使用指定的编辑器在每个 cmdlet 完成时显示日志。Notepad.exe 为默认编辑器。此参数必须在编辑器中包含完全限定的文件规范,编辑器必须将日志文件规范作为其唯一的参数。

    返回结果:

支持和故障排除 cmdlet

  • New-CvadAcTemplateToFile

    为选定组件创建模板文件,以便手动创建导入文件。

    参数:

    返回结果:

  • Show-CvadAcDocument - 在默认浏览器中显示此文档。

    参数:

    • 无。

    返回结果:

    • 在默认的 Web 浏览器中显示此 Web 页面。
  • Test-CvadAcConnectionWithSite

    测试与云站点的连接以验证通信连接是否正常工作。此 cmdlet 使用云访问参数或 CustomerInfo.yml 文件来指定客户连接信息。

    参数:

    返回结果:

    • 测试结果将显示在命令行上。
  • Find-CvadAcConnector

    查找现有连接器并确定其运行状态。此 cmdlet 使用 CustomerInfo.yml 文件中的信息或客户 ID 参数来查找客户的连接器。

    参数:

    • CustomerInfoFileSpec - 指向客户信息文件以覆盖默认位置和名称的文件规范。提供了 CustomerId 参数时,此参数将被忽略。
    • CustomerId - 客户的 ID,此参数将覆盖 CustomerInfo.yml 文件中的相同值。

    返回结果:

    • 结果显示在命令行中。
  • New-CvadAcZipInfoForSupport

    注意:

    New-CvadAcZipInfoForSupport cmdlet 仅在 2.0 版及更高版本上可用。在自动配置中使用 Get-CvadAcStatus 检查您的版本。

    将所有日志和 .yml 文件压缩到单个 zip 文件中,以发送给 Citrix 以获得支持。客户敏感信息(CustomerInfo.yml 和 CvadAcSecurity.yml)不包含在 zip 文件中。Icon.yml 文件也因其大小而被排除在外。zip 文件根据日期和时间戳放置在 %HOMEPATH%\Documents\Citrix\AutoConfig 中,名称为 CvadAcSupport_yyyy_mm_dd_hh_mm_ss.zip。此 zip 文件也可以作为备份。

    参数:

    • AlternateFolder - 指定要将 zip 文件保存到的备用文件夹。
    • Quiet - 禁止登录控制台(仅在2.0 版或更高版本时可用)。

    返回结果:

    • 命令提示符下会显示带有 zip 文件名和位置的 zip 文件。
  • Get-CvadAcCustomerSites

    返回所有客户站点的列表。此 cmdlet 使用云访问参数或 CustomerInfo.yml 文件来指定客户连接信息。

    参数:

    返回结果:

    • 显示找到的客户地点 ID 的列表。
  • Get-CvadAcStatus

    返回有关工具及其运行环境的信息,包括工具版本、用户是否具有执行导出操作的站点管理员权限、是否存在客户信息(客户 ID、客户端 ID 和密钥)、是否可以与站点通信、是否存在 Provisioning Services 增强的功能以及是否存在一个或多个连接器。

    参数:

    • 请参阅云访问参数
    • SiteId - 标识要连接到的站点(可选)。
    • AdminAddress - 是用于验证管理员访问级别的本地 Delivery Controller 的 DNS 或 IP 地址。如果该工具不在 Delivery Controller 上运行,则此操作是必需的。

    返回结果:

    • 显示每个项目的结果。

站点激活 cmdlet

注意:

此功能仅在 2.0 版及更高版本上可用。在自动配置中使用 Get-CvadAcStatus 检查您的版本

  • Set-CvadAcSiteActiveStateOnPrem

    将本地站点状态设置为活动或非活动状态。

    参数:

    • 请参阅云访问参数
    • SiteActive - 如果存在,则将本地站点设置为主动从所有交付组中删除维护模式。此参数不存在时,将在所有交付组上设置维护模式。
    • IncludeByName - 一个列表,用于指定在将站点活动状态设置为活动时要包括的交付组名称。支持在名称中使用“*”和“?”通配符。
    • ExcludeByName - 一个列表,用于指定在将站点活动状态设置为活动时要排除的交付组名称。支持在名称中使用“*”和“?”通配符。
    • Quiet - 禁止登录控制台
    • DisplayLog - 在 cmdlet 完成时显示日志文件。设置为 $false 将禁止日志显示。

    返回结果:

  • Set-CvadAcSiteActiveStateCloud

    将云站点状态设置为活动或非活动状态。

    参数:

    • 请参阅云访问参数
    • SiteActive - 如果存在,则将本地站点设置为主动从所有交付组中删除维护模式。此参数不存在时,将在所有交付组上设置维护模式。
    • IncludeByName - 一个列表,用于指定在将站点活动状态设置为活动时要包括的交付组名称。支持在名称中使用“*”和“?”通配符。
    • ExcludeByName - 一个列表,用于指定在将站点活动状态设置为活动时要排除的交付组名称。支持在名称中使用“*”和“?”通配符。
    • Quiet - 禁止登录控制台
    • DisplayLog - 在 cmdlet 完成时显示日志文件。设置为 $false 将禁止日志显示。

    返回结果:

站点合并 cmdlet

注意:

此功能仅在 2.0 版及更高版本上可用。在自动配置中使用 Get-CvadAcStatus 检查您的版本

有关这些 cmdlet 的站点合并和使用的详细信息,请参阅将多个站点合并到一个站点中

  • New-CvadAcSiteMergingInfo - 创建一个合并前缀/后缀信息集的站点。开始时没有必要知晓所有前缀或后缀。可以通过 Set-CvadAcSiteMergingInfo 或手动编辑 SiteMerging.yml 文件来对其进行更新。
  • Set-CvadAcSiteMergingInfo - 更新现有站点合并前缀/后缀信息集。
  • Remove-CvadAcSiteMergingInfo - 删除现有站点合并前缀/后缀信息集。

站点合并参数

  • SiteName - 用于标识特定站点的前缀/后缀集的名称。它可以与实际站点的名称匹配,但不需要匹配。SiteName 是必需的参数。注意: 这是 Remove-CvadAcSiteMergingInfo 唯一支持的参数。
  • Quiet - 禁止登录控制台(仅在2.0 版或更高版本时可用)。
  • AdminScopedPrefix - 要应用到管理员作用域的前缀。
  • ApplicationPrefix - 应用到应用程序的前缀。
  • ApplicationFolderPrefix - 应用到应用程序文件夹的前缀;ApplicationFolderPrefix 可以与 ApplicationFolderRoot 结合使用。
  • ApplicationFolderRoot - 应用程序文件夹的新根文件夹。这将创建额外的文件夹层次结构。ApplicationFolderRoot 可以与 ApplicationFolderPrefix 结合使用。
  • ApplicationGroupPrefix - 应用程序组的前缀。
  • ApplicationUserPrefix - 应用到用户看到的应用程序名称的前缀。
  • ApplicationAdminPrefix - 应用到管理员看到的应用程序名称的前缀。
  • DeliveryGroupPrefix - 要应用到交付组的前缀。
  • GroupPolicyPrefix - 要应用到策略名称的前缀。
  • HostConnectionPrefix - 要应用到主机连接的前缀。
  • MachineCatalogPrefix - 要应用到计算机目录的前缀。
  • StoreFrontPrefix - 要应用到 StoreFront 名称的前缀。
  • TagPrefix - 要应用到标记的前缀。
  • AdminScopedSuffix - 要应用到管理员作用域的后缀。
  • ApplicationSuffix - 适用于应用程序的后缀。
  • ApplicationFolderSuffix - 要应用到应用程序文件夹的后缀;ApplicationFolderSuffix 可以与 ApplicationFolderRoot 结合使用。
  • ApplicationGroupSuffix - 应用程序组的后缀。
  • ApplicationUserSuffix - 要应用到用户看到的应用程序名称的后缀。
  • ApplicationAdminSuffix - 要应用到管理员看到的应用程序名称的后缀。
  • DeliveryGroupSuffix - 要应用到交付组的后缀。
  • GroupPolicySuffix - 要应用到策略名称的后缀。
  • HostConnectionSuffix - 要应用到主机连接的后缀。
  • MachineCatalogSuffix - 要应用到计算机目录的后缀。
  • StoreFrontSuffix - 要应用到 StoreFront 名称的后缀。
  • TagSuffix - 要应用到标记的后缀。
  • SiteRootFolder - 用于导出和导入的完全限定文件夹名称;可以是本地文件夹或文件共享。

组件选择参数

以下组件可以使用支持这些组件的 cmdlet 来指定。对于包括 1.x 在内的工具版本,请在每个参数后面附带 $true。对于工具版本 2.x 或更高版本,仅指定参数。选择 All 会导致忽略其他参数。未指定组件参数时,All 选项将自动选择。

  • All
  • Tags
  • AdminRolesScopes
  • MachineCatalogs
  • DeliveryGroups
  • ApplicationGroups
  • Applications
  • GroupPolicies

按对象名称过滤

按名称包含和排除

IncludeByNameExcludeByName 参数允许按名称在 cmdlet 中包含和排除组件成员。在任何受支持的 cmdlet 中,一次只能选择一个组件(例如,交付组)。如果组件成员在这两个区域中,排除操作将覆盖任何其他参数,并且日志修复列表中将新增一个条目,以标识排除的组件和成员名称。

IncludeByNameExcludeByName 将获取组件成员名称的列表。任何名称都可以包含一个或多个通配符。支持两种类型的通配符。当任何成员名称包含特殊字符时,组件成员名称列表必须用单引号引起。

  • * 匹配任意数量的字符
  • ? 匹配单个字符

IncludeByNameExcludeByName 也可以获取包含成员列表的文件,其中每个成员都可以是直接显示的或包含通配符。该文件中的每一行都可以包含一个成员。前导空格和尾随空格将自动从成员名称中去掉。文件名前面必须带有 @ 符号,并且用单引号括起来(这是 PowerShell 的要求,因此不会重新解释 @)。除了与成员名称混用之外,还可以列出多个文件。

将写入合并名称以 DgSite1 开头且包含 Home2 的所有交付组的一个示例:

Merge-CvadAcToSite –DeliveryGroups $true –IncludeByName DgSite1*,*Home2*

按交付组名称

ByDeliveryGroupName 按应用程序和应用程序组的交付组名称进行筛选。此参数始终是一个包含列表,根据其交付组关联标识要包括的成员。

ByDeliveryGroupName 获取交付组名称的列表。任何名称都可以包含一个或多个通配符。支持两种类型的通配符。

  • * 匹配任意数量的字符
  • ? 匹配单个字符

以下示例合并引用以 EastDg 开头的所有交付组名称的所有应用程序。

Merge-CvadAcToSite –Applications –ByDeliveryGroupName EastDg*

排除已禁用

ExcludeDisabled 从导入操作中筛选出禁用的所有应用程序和应用程序组。ExcludeDisabled 默认设置为 false,这意味着无论其启用状态如何,所有应用程序和应用程序组都会导入。

按计算机名称

注意:

此功能仅在 2.0 版及更高版本上可用。在自动配置中使用 Get-CvadAcStatus 检查您的版本

ByMachineName 按计算机目录和交付组的计算机名称进行筛选。此参数始终是一个包含列表,根据其计算机名称关联标识要包括的成员。

ByMachineName 获取计算机名称列表,其中任何名称都可以包含一个或多个通配符。支持两种类型的通配符。

  • * 匹配任意数量的字符
  • ? 匹配单个字符

使用 ByMachineName 导出或导入,并且计算机名称过滤器导致计算机目录或交付组中没有计算机时,计算机目录或交付组将从导出或导入中排除。

注意:

在任何导入类型 cmdlet 中使用 ByMachineName 都会导致 AddMachinesOnly 设置为 $true

仅添加计算机

AddMachinesOnly,设置为 $true 时,指示导入操作仅将计算机添加到计算机目录或交付组。计算机不会被删除,允许进行增量添加操作。

AddMachineOnly 默认设置为 false,表示如果计算机目录或交付组 .yml 文件中不存在计算机,则将删除计算机。使用ByMachineName 时,AddMachinesOnly 设置为 $true,但可以通过将 AddMachinesOnly 设置为 false 进行覆盖。

迁移参数

修改云站点配置(ImportRestoreMergeNewSync)的 Cmdlet 还额外支持以下参数,以提高灵活性。

  • CheckMode - 执行导入操作,但进行任何更改。在导入完成之前,将报告所有预期更改。在执行实际导入之前,可以使用此命令测试导入。
  • BackupFirst - 在修改云配置之前,将云内容备份到 .yml 文件中。默认情况下此选项处于启用状态。
  • Confirm - 如果为 true,则提示用户确认是否要对云站点配置进行更改。由于具有破坏性,Remove cmdlet 会显示一条提示。如果不需要提示(例如,在自动化脚本中运行),则设置为 false。Confirm 默认设置为 true。

注意:

SecurityFileFolderSiteNameSiteActive cmdlet 仅在 2.0 版及更高版本上可用。在自动配置中使用 Get-CvadAcStatus 检查您的版本。

  • SecurityFileFolder - 这是包含 CvadSecurity.yml 文件的完全限定文件夹,该文件可能指向受身份验证控制的本地文件夹或网络共享文件夹。该工具不提示输入凭据;必须在运行该工具之前获取对受控资源的访问权限。
  • SiteName - 指定导入时要使用的站点合并前缀和后缀设置。有关详细信息,请参阅将多个站点合并到一个站点中
  • SiteActive - 指定导入的站点处于活动状态还是非活动状态。默认情况下,此参数设置为 $false,表示导入的站点处于非活动状态。

云访问参数

所有访问云的 cmdlet 都支持以下额外的参数。

注意:

可以将 CustomerId、ClientId 和 Secret 放置在 CustomerInfo.yml 文件中,也可以使用上述参数通过 cmdlet 指定。在两个位置都指定时,cmdlet 参数优先。

  • CustomerId - 已在 REST API 中使用且访问所有 REST API 所需的客户 ID。您的客户 ID 位于 Citrix Cloud 中。
  • ClientId - 在 Citrix Cloud 身份识别和访问管理网站上创建的客户端 ID。获取对所有 Rest API 进行身份验证所需的持有者令牌时,需要此信息。
  • Secret - 在 Citrix Cloud 身份识别和访问管理网站上创建的密钥。获取对所有 Rest API 进行身份验证所需的持有者令牌时,需要此信息。
  • CustomerInfoFileSpec - 指向客户信息文件以覆盖默认位置和名称的文件规范。

日志显示参数

ExportImportSyncRestoreBackupCompareRemove cmdlet 会在该操作完成时显示日志文件。您可以通过将 -DisplayLog 参数设置为 $false 以禁止显示日志。默认情况下,将使用 Notepad.exe 来显示日志文件。您可以在 CustomerInfo.yml 文件中指定不同的编辑器。

Editor: C:\Program Files\Notepad++\notepad++.exe

通过命令派生的状态结果

派生的状态可能会导致云站点上出现以下三个操作组合之一:

  • 添加、更新和删除
  • 仅添加和更新
  • 仅添加

下表显示每个 cmdlet 的派生状态以及可更改 cmdlet 的派生状态行为的可选参数。

命令 Add、Update、Delete Add、Update Add
导入 -Merge $false 默认值 -AddOnly $true
Merge 不适用 默认值 -AddOnly $true
New 不适用 不适用 默认值
Sync(同步) -Merge $false 默认值 -AddOnly $true
Restore(还原) -Merge $false 默认值 -AddOnly $true

cmdlet 返回值

ActionResult

所有 cmdlet 都将返回以下值。

public class ActionResult
{
    public bool                         Overall_Success;
    public Dictionary<string, string>   Individual_Success;
    public object                       CustomResult;
}

Overall_Success 将返回一个布尔值,以显示所有选定组件中的 cmdlet 是否均成功:true 表示成功,false 表示不成功。

Individual_Success 将返回每个主组件的一个或三个值。组件的结果可以是“成功”、“失败”或“已跳过”。“已跳过”表示未选择以供 cmdlet 执行的组件。

CustomResult 特定于 cmdlet。

CustomResult

ImportMergeRestoreSyncCompareCompare FileRemove 将返回 EvaluationResultData 单个实例的以下自定义结果信息。

注意:

ExportTemplate cmdlet 不返回自定义结果。

    public class EvaluationResultData
    {
        public Dictionary<string, Dictionary<string, ActionResultValues >> EvaluationResults;
        public int                  Added;
        public int                  Updated;
        public int                  Deleted;
        public int                  NoChange;
        public int                  TotalChanged;
        public EvaluationResults     OverallResult;
        public string               CloudBackupFolder;
        public string               SourceBackupFolder;
    }
    Where:
    public enum ActionResultValues
    {
        Add,
        Update,
        Delete,
        Identical,
        DoNothing
    }
    public enum EvaluationResults
    {
        Success,
        Failure,
        Skipped
    }

EvaluationResults 将显示一个列表,其中包含每个选定组件对应的一个条目。键是组件名称,值是每个组件成员以及对该组件成员执行的操作的列表。操作可以是 ActionResultValues 的任何一个值。

AddedUpdatedDeletedNoChange 指示按该顺序添加、更新、删除或未执行任何操作的组件成员总数。

TotalChangedAddedUpdatedDeleted 的总和。

OverallResult 是一个表示 cmdlet 结果的布尔值。True 表示所有组件均成功,false 表示处理一个或多个组件时失败。

CloudBackupFolder 是在 cmdlet 执行任何云修改操作之前,云站点配置备份的完全限定文件规范。

SourceBackupFolder 是在 cmdlet 完成执行后进行的源文件备份的完全限定文件规范。默认情况下,这些文件位于 %HOMEPATH%\Documents\Citrix\AutoConfig 中。

帮助

  • Get-Help - 我们为每个 cmdlet 均提供了 PowerShell 帮助。所有参数均与每个 cmdlet 以及相应 cmdlet 的简要说明一起记录。要访问任何 cmdlet 的帮助,请在 cmdlet 前面键入 Get-Help。例如 Get-Help Import-CvadAcToSite

其他信息

当您具有 Machine Creation Services 计算机目录时导入其他对象

目前,自动配置不支持以自动方式导入 MCS 计算机目录或其相应的交付组。但是,您仍然可以使用自动配置导入其他配置选项,例如应用程序和策略。必须使用与本地设置相同的名称创建计算机目录和交付组。在继续导入应用程序设置之前,请按照以下步骤准备环境:

  1. 在 Citrix Cloud 门户中,单击汉堡菜单,然后转到 My Services(我的服务)> Virtual Apps and Desktops 服务 > Manage(管理)。像平常一样创建您的 MCS 计算机目录。请确保目录命名的方式与现有本地目录的命名方式完全相同。

  2. 为新目录创建相应的交付组。请务必完全根据相应的本地交付组对其进行命名。

  3. 在本地环境的 Citrix Studio 中的应用程序节点中,通过选择应用程序,右键单击该应用程序,然后转到属性来确认应用程序属于匹配的交付组。

  4. 单击以确认应用程序所属的组:

    客户 ID 图像 8

  5. 在 PowerShell 中,运行合并命令并使用 byDeliveryGroupName 标志,该标志会按交付组名称筛选应用程序。

    Merge-CvadAcToSite –Applications $true –ByDeliveryGroupName <DG_name>

    客户 ID 图像 9

  6. 键入 Yes 以继续。

    客户 ID 图像 10

  7. 管理 > 完整配置中,选择左窗格中的应用程序。 刷新显示屏以确保按预期列出应用程序。选择应用程序,然后依次选择应用程序属性 > 组进行检查。

导入与 MC 相关的策略

如果需要导入与 MCS 目录或组关联的策略,请按照以下说明进行操作:

  1. 在 PowerShell 中运行 Merge-CvadAcToSite -GroupPolicies $true 命令,然后键入 yes 以继续。

    客户 ID 图像 13

    成功执行将显示与前面的屏幕截图相似的输出(添加的值)。以下屏幕截图显示了没有更改(无更改)的行的结果。

    客户 ID 图像 14

  2. 刷新管理 > 完整配置显示并在左侧窗格中选择策略

  3. 选中 Policies Assigned to(分配到的策略)选项卡,并将其与本地策略分配进行比较。

迁移到 Citrix Cloud Government

Citrix Cloud Government 环境使用不同的接入点来验证和分配访问令牌。这一独特的要求适用于访问云的任何自动配置工具。请执行以下步骤以在 Citrix Cloud Government 环境中使用自动配置。

  1. %HOMEPATH%\Documents\Citrix\AutoConfig 文件夹中,编辑 CustomerInfo.yml。
  2. 将以下行添加到 CustomerInfo.yml(如果已存在,请进行更改。)

    Environment: "ProductionGov"

自动配置现在可以在 Citrix Cloud Government 环境中使用。

主机连接

可以使用自动配置导出和导入主机连接及其关联的虚拟机管理程序。

向主机连接添加虚拟机管理程序需要特定于虚拟机管理程序类型的安全信息。出于安全考虑,无法从本地站点导出此信息。您必须手动提供该信息,以便自动配置能够成功地将主机连接和虚拟机管理程序导入云站点。

导出过程会在 %HOMEPATH%\Documents\Citrix\AutoConfig 中创建 HostSecurity.yml 文件,该文件包含特定的虚拟机管理程序类型所需的每个安全项目的占位符。在导入到云站点之前,必须更新 HostSecurity.yml 文件。在根据需要添加新的安全占位符的多次导出过程中,将保留管理员进行的更新。禁止删除安全项目。

注意:

请务必将 HostSecurity.yml 文件中输入的所有值用双引号引起。

---

HostConn1:
ConnectionType: XenServer
UserName: root
PasswordKey: rootPassword
HostCon2:
ConnectionType: AWS
ApiKey: 78AB6083-EF60-4D26-B2L5-BZ35X00DA5CH
SecretKey: TwBLaaaaaaaaaaaaaaaaaw==
Region: East

每个虚拟机管理程序的安全信息

下面列出了每种虚拟机管理程序类型所需的安全信息。

  • XenServer、Hyper-V、VMware
    • 用户名
    • 明文密码
  • Microsoft Azure
    • 订阅 ID
    • 应用程序 ID
    • 应用程序机密
  • Amazon Web Services
    • 服务帐户 ID
    • 应用程序机密
    • 地理区域

特殊安全注意事项

所有安全信息都以明文形式输入。如果不建议使用明文,则可以使用服务的管理 > 完全配置界面手动创建主机连接和关联的虚拟机管理程序。主机连接和虚拟机管理程序名称必须与其本地主机连接和虚拟机管理程序名称完全相同,以便成功导入使用主机连接的计算机目录。

自动化

自动配置工具 cmdlet 可以在无需管理员干预的情况下在自动化脚本中运行,方法是在 cmdlet 完成运行时禁止提示和显示日志结果。此外,您也可以通过使用 CustomerInfo.yml 文件来设置参数以执行相同的操作。

将以下参数添加到云修改 cmdlet 以禁止显示提示。

-Confirm $false

将以下参数添加到 cmdlet 中,以禁止在 cmdlet 完成运行时显示日志。

-DisplayLog $false

请将以下参数添加到 cmdlet 中以禁止记录到 PowerShell 命令窗口。

-Quiet

另一种方法是将以下参数置于 CustomerInfo.yml 文件中。

Confirm: False

DisplayLog: False

从 Delivery Controller 以外的 PC 导出

自动配置工具将使用多个 Citrix PowerShell SDK 将本地站点配置导出到文件中。这些 SDK 将自动安装在 Delivery Controller 上,从而无需执行额外操作即可在 Delivery Controller 上运行该工具。在非 Delivery Controller 计算机上运行时,需要安装该工具所需的 Citrix PowerShell SDK 集。此 SDK 集是 Citrix Studio 的一部分,后者可通过 Citrix Virtual Apps and Desktops 安装介质进行安装。

注意:

无法在 Cloud Connector 上运行自动配置。

Citrix Cloud 数据收集

有关 Citrix Cloud 收集的信息的信息,请参阅 Citrix Cloud 服务客户内容和日志处理

文件夹

默认文件夹根位置

所有自动配置工具操作都在根文件夹或其中的子文件夹中执行。根文件夹位于 %HOMEPATH%\Documents\Citrix\AutoConfig 中。

导出

所有导出的文件均位于这两个文件夹位置,以方便使用并提供导出历史记录。导出的内容始终位于根文件夹中。副本位于名为 Export 的子文件夹中,并显示了导出日期和时间。

根文件夹包含的永远都是导出的最新本地站点配置。每个 Export 子文件夹都包含在指定日期和时间完成的导出,并保留导出的历史记录。您可以使用任何 Export 子文件夹来配置云站点。自动配置不会删除或修改现有导出子文件夹。

导入/合并/同步/比较

ImportMergeCompare 操作始终源自位于根文件夹中的文件。每个操作都会创建一个用于将根文件夹中的文件复制到的子文件夹,从而提供云站点更改源文件的历史记录。

Restore(还原)

Restore 操作将使用现有子文件夹来配置云站点。源文件夹是通过所需的 -RestoreFolder 参数指定的。与其他命令不同,该命令不会创建新的子文件夹,因为 Restore 操作会使用现有子文件夹。还原文件夹可以是根文件夹,但仍必须通过 -RestoreFolder 参数来指定。

备份

自动配置可初始化、更新和备份云站点配置。在使用过程中,随着时间的推移,许多不同的配置可能会在云站点上发生变化。为便于长期使用和保留历史更改,自动配置采用了保留方案,以保存更改的历史记录,并作为一种还原早期状态的方法。

始终对名为 Backup 且包含备份的数据和时间的子文件夹进行云站点配置备份。自动配置不会删除或修改现有导出子文件夹。

您可以使用备份来还原特定组件或整个配置。要还原整个交付组和计算机目录组件,请使用 cmdlet:

Restore-CvadAcToSite -RestoreFrom %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss -DeliveryGroups -MachineCatalogs

注意:

上述 cmdlet 中的备份文件信息基于您自己的备份。

要还原整个云站点配置,请使用 cmdlet:

Restore-CvadAcToSite -RestoreFrom %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss

注意:

上述 cmdlet 中的备份文件信息基于您自己的备份。

更改默认根文件夹

ExportImportMergeSyncCompare 操作可以通过使用 –AlternateFolder 参数来更改默认根文件夹。每个操作子文件夹的创建和管理与之前所述的方式相同。

复制到子文件夹中的文件

所有具有“.yml”扩展名的文件都将复制到操作子文件夹中,但以下文件除外:

  • CustomerInfo.yml
  • ZoneMapping.yml
  • HostSecurity.yml

自动防故障云站点备份

在运行更改配置的操作之前,先备份当前云站点配置。此配置包括 ImportMergeSyncRestore 参数。备份始终位于操作子文件夹下方的子文件夹中。

如果使用 Restore,则备份文件夹是通过 -RestoreFrom 参数指定的文件夹的子文件夹。

日志记录

运行任何 cmdlet 都会导致创建日志文件且主历史记录日志文件中会增加一个条目。所有操作日志文件都位于备份文件夹中。所有日志文件名都以 CitrixLog 开头,然后显示自动配置操作以及 cmdlet 执行的日期和时间戳。日志不会自动删除。

主历史记录日志位于 %HOMEPATH%\Documents\Citrix\AutoConfig 中名为 History.Log 的文件中。每个 cmdlet 执行都会生成一个主日志条目,其中包含执行的日期、操作、结果、备份和日志文件位置。

日志记录详细信息

每个日志文件均包含以下内容:

  • 操作的名称以及是否已启用检查模式
  • 开始和结束日期与时间
  • 与每个组件的操作对应的多个条目,以及成功/失败通知
  • 执行的操作的摘要,包括已创建的各种对象的数量
  • 建议的修复(如果适用)
  • 备份文件夹位置(如果适用)
  • 主日志位置
  • 持续时间

诊断文件

诊断文件可帮助您确定和解决问题。以下文件是在运行其操作时创建的。它们位于 %HOMEPATH%\Documents\Citrix\AutoConfig 下特定于操作的子文件夹中。在提供信息以获取问题解决支持时,请附上这些文件。

导出

PoshSdk_yyyy_mm_dd_hh_mm_ss.ps1

此文件将枚举进行的所有代理 PowerShell SDK 调用,以将站点配置导出到文件。

导入、合并、还原、同步、备份、比较

Transaction_yyyy_mm_dd_hh_mm_ss.txt

此文件记录了每个 REST API 调用及相关信息。

RestApiContent_yyyy_mm_dd_hh_mm_ss.txt

此文件包含所有 AddUpdateDelete REST API 内容。

依赖关系引起的问题

导入和合并可能会因缺少依赖关系而失败。一些常见问题包括:

  1. 组策略缺少交付组过滤器。通常的原因是尚未导入的交付组。
  2. 应用程序无法导入或合并。通常的原因是缺少尚未导入的交付组或应用程序组。
  3. 应用程序组缺少 RestrictTo 标签。通常的原因是尚未导入的标签。
  4. 主机连接失败。通常的原因是 CvadAcSecurity.yml 文件中缺少安全信息。
  5. 计算机目录失败。通常的原因是未导入的主机连接。
  6. 计算机目录和交付组中缺少计算机。通常的原因是在 Active Directory 中找不到的计算机。
  7. 交付组中缺少用户。通常的原因是在 Active Directory 中找不到的用户。

常见问题

云站点为空

空站点表示未成功完成导入/合并/还原操作。如果尝试执行某个操作,请查看该操作生成的日志。

云站点上的项目超过预期数量

如果对云站点配置进行了增强并运行了 Merge 操作,则可能会发生这种情况。如果云站点配置之前具有值,并且导入/合并/还原操作出现问题,则也可能会发生这种情况。请尝试重新运行该操作。

云站点上的项目少于预期数量

如果对云站点配置进行了增强,并且 Import 操作的 Merge 参数被设置为 $false,从而导致出现相同的派生状态,则可能会发生这种情况。原始状态将在与导入操作相关联的自动防故障云站点备份文件夹中进行备份。要更正,请执行以下操作:

  1. 使用将 RestoreFolder 参数设置为自动防故障云站点备份文件夹的还原操作,来还原自动防故障云站点备份

  2. 使用 Merge 操作,而非 Import 操作。

云站点将在导入中断后进行编辑

如果在 –Merge 参数设置为 $false 的情况下执行了 Import 操作,从而导致导入相同的派生状态,则可能会发生这种情况。原始状态将在与导入操作相关联的自动防故障云站点备份文件夹中进行备份。要更正,请执行以下操作:

  1. 使用将 RestoreFolder 参数设置为自动防故障云站点备份文件夹的还原操作,来还原自动防故障云站点备份

  2. 使用 Merge 操作,而非 Import 操作。

云站点与当前本地站点不匹配

当完成 Merge 操作以导致出现合并的派生状态,而非在 Merge 参数设置 $false 的情况下执行 Import 以导致出现相同的派生状态时,可能会发生这种情况。在 Merge 参数设置为 $false 的情况下使用 Import 重复执行该操作。

建议

  • 请勿一次运行多个自动配置实例。运行多个并发实例会导致在云站点中产生不可预知的结果。如果发生此情况,请重新运行一个自动配置实例,以使站点恢复到预期状态。
  • 运行自动配置时,请勿在完全配置中工作。在运行自动配置时在完全配置中进行更改可能会导致在云站点中产生不可预知的结果。如果发生此情况,请重新运行一个自动配置实例,以使站点恢复到预期状态。
  • 始终以直观地方式验证完整配置中的合并/导入/还原结果,以确保云站点满足预期要求。

资源

迁移到云