管理计算机目录
注意:
本文介绍如何使用完整配置界面和 PowerShell 命令管理目录。如果您使用“快速部署”界面创建了目录,并继续使用该界面管理目录,然后按照在快速部署中管理目录进行操作。
简介
可以在计算机目录中添加或删除计算机,以及重命名、更改说明或管理目录的 Active Directory 计算机帐户。
目录维护还可以包括的任务包括确保每台计算机都安装最新的操作系统更新、防病毒软件更新、操作系统升级或配置更改。
- 包含使用 Machine Creation Services (MCS) 创建的池随机目录通过更新在目录中使用的映像,然后更新计算机来维护计算机。此方法可让您有效地更新大量用户计算机。
- 对于包含永久分配的静态计算机的目录,您可以管理这些目录当前使用的映像或模板,但只能使用新映像或模板创建以后添加到目录中的计算机。
- 对于 Remote PC Access 目录,您可以在“完整配置”管理界面之外管理用户计算机的更新。请使用第三方软件分发工具以单独或集中的方式执行此操作。
有关创建和管理与主机虚拟机管理程序和云服务的连接的信息,请参阅创建和管理连接和资源。
注意:
MCS 不支持 Windows 10 IoT 核心版和 Windows 10 IoT 企业版。请参阅 Microsoft 站点以了解详细信息。
关于永久实例
更新包含永久性计算机的 MCS 目录的主映像时,添加到该目录的任何新计算机都将使用更新后的映像。现有计算机继续使用原始主映像。更新映像的过程与更新任何其他类型的目录的方式相同。请注意以下事项:
- 使用永久性磁盘目录时,预先存在的计算机不会更新到新的映像,但是添加到该目录中的任何新计算机将使用新映像。
- 对于非永久性磁盘目录,只有在 Studio 或 PowerShell 中重新启动计算机时,下次才会更新计算机映像。如果从 Studio 外部的虚拟机管理程序重新启动计算机,则不会重置磁盘。
- 对于不会永久存在的目录,如果您希望不同的计算机使用不同的映像,则映像必须位于单独的目录中。
管理计算机目录
可以通过两种方式管理计算机目录:
使用完整配置界面
本节详细介绍了如何使用完整配置界面管理目录:
- 查看目录详细信息
- 向目录中添加计算机
- 从目录中删除计算机
- 编辑目录
- 重命名目录
- 删除目录
- 管理目录中的 Active Directory 计算机帐户
- 更改目录的主映像
- 更改功能级别或撤消更改
- 克隆目录
- 使用文件夹整理目录
- 为 VDA 配置自动升级
- 管理目录的配置集
- 重试创建目录
- (仅限非 Citrix 预置的 VDA)生成和管理注册令牌
查看目录详细信息
- 使用搜索功能查找特定的计算机目录。有关说明,请参阅搜索实例。
- 根据需要从搜索结果中选择一个目录。
- 有关目录列的说明,请参见下表。
- 单击底部详细信息窗格中的选项卡,了解有关此目录的详细信息。
列 | 说明 |
---|---|
计算机目录
|
目录的名称和分配类型。分配类型包括:
|
计算机类型
|
目录中的计算机支持的会话类型。可能的值包括:
|
计算机计数 | 目录中的计算机数量和预配方法。可能的预配方法包括:Machine Creation Services(MCS 计算机)、手动和 Citrix Provisioning 服务。 |
分配的数量 | 目录中分配给交付组的计算机数量。 |
Folder | 目录在计算机目录树中的位置。它显示该目录所在的文件夹的名称(包括尾部的反斜杠),或者如果该目录位于根级别,则为 - 。 |
VDA 升级 | VDA 升级状态。可能的值包括:“未配置”、“已计划”、“可用”和“最新”。 |
映像状态 | 目录的映像更新状态。仅适用于非永久性计算机目录。可能的值包括:“已完全更新”、“已部分更新”、“待更新”、“正在准备” |
向目录中添加计算机
开始之前:
- 确保虚拟化主机(虚拟机管理程序或云服务提供程序)具有足够多的处理器、内存和存储空间来容纳更多的计算机。
- 确保有足够多的未使用 Active Directory 计算机帐户。如果要使用现有帐户,可以添加的计算机数受可用帐户数限制。
- 如果使用“完整配置”管理界面为更多计算机创建 Active Directory 计算机帐户,必须具有相应的域管理员权限。
提示:
如果用于将计算机添加到计算机目录的 Citrix DaaS 帐户的 AD 权限受限,请在登录到… 中添加您打算使用的所有 Cloud Connector 屏幕。
向目录中添加计算机:
- 在管理 > 完整配置中,选择左窗格中的计算机目录。
- 选择计算机目录,然后在操作栏中选择添加计算机。
- 在虚拟机页面上,选择要添加的虚拟机数量。
-
在“计算机身份”页面上,按如下方式配置设置:
-
从列表中选择标识。
-
如果适用,请指示是创建帐户还是使用现有帐户,并指出这些帐户的位置(域)。
如果现有 Active Directory 帐户的数量不足,无法容纳要添加的 VM 数量,请选择要在其中创建帐户的域和位置。
如果您使用现有 Active Directory 帐户,请浏览到这些帐户或选择“导入”并指定一个包含帐户名的
.csv
文件。确保所有要添加的计算机都有足够的帐户。“完整配置”界面管理这些帐户。允许界面重置所有帐户的密码或者指定帐户密码,所有帐户的密码都必须相同。 -
如果其他目录使用此身份池,则无法使用完整配置将其更改为其他池。改用 Set-ProvScheme PowerShell cmdlet。有关详细信息,请参阅 Citrix Virtual Apps and Desktops SDK 文档。
-
指定帐户命名方案,并使用井号来表示将显示连续数字或字母的位置。例如,命名方案 PC-Sales-##(可以选择 0-9)将生成名为 PC-Sales-01、PC-Sales-02、PC-Sales-03 等的计算机帐户。
-
或者,您可以指定帐户名称的开头。
指定帐户名称的开头时,请注意以下情况:如果起始数字或字母已被使用,则创建的第一个帐户将使用最接近的未使用数字或字母命名。
请参阅管理计算机名称的序列号 ,通过 PowerShell 命令自定义使用 MCS 部署的计算机的序列号。
-
- 在域凭据页面上,选择输入凭据,然后输入具有足够权限的用户凭据以创建计算机帐户。
系统会将计算机创建过程作为后台进程来执行,创建许多计算机时,需要很长时间才能完成。即使关闭“完整配置”管理界面,计算机创建也会继续进行。
使用 CSV 文件将计算机批量添加到目录
可以使用 CSV 文件批量添加计算机。该功能适用于所有目录,但通过 MCS 置备的目录除外。
要将计算机批量添加到目录中,请完成以下步骤:
- 在管理 > 完整配置中,选择左窗格中的计算机目录。
- 选择计算机目录,然后在操作栏中选择添加计算机。此时将显示添加计算机窗口。
- 选择添加 CSV 文件。此时将显示批量添加计算机窗口。
- 选择下载 CSV 模板。
- 填写模板文件。
- 拖动或浏览到该文件进行上载。
- 选择验证可对导入执行验证检查。
- 选择导入以完成该过程。
使用 CSV 文件添加计算机时的注意事项
注意:
- 对于非 Active Directory 用户,必须按以下格式键入其名称:
<identity provider>:<user name>
。示例:AzureAD:username
。- VM 名称区分大小写。输入 VM 路径时,请确保正确输入了 VM 名称。
编辑 CSV 模板文件时,请谨记以下几点:
-
通过该功能,您可以更加灵活地通过 CSV 文件批量添加计算机。在该文件中,您可以仅添加计算机(用于用户自动分配)或将计算机与用户分配一起添加。请按以下格式键入数据:
-
对于计算机帐户和用户名 (samName) 对:
- Domain\ComputerName1, Domain\Username1
- Domain\ComputerName2, Domain\Username1;Domain\Username2
- Domain\ComputerName3, AzureAD:username
-
仅适用于计算机帐户:
- Domain\ComputerName1
- Domain\ComputerName2
-
对于 VM 和用户名对:
- XDHyp:\Connections\ConnectionName\RegionName\vm.folder\VMName1.vm,Domain\ComputerName1,Domain\Username1
- XDHyp:\Connections\ConnectionName\RegionName\vm.folder\VMName2.vm,Domain\ComputerName2,Domain\Username2
-
仅适用于 VM:
- XDHyp:\Connections\ConnectionName\RegionName\vm.folder\VMName1.vm,Domain\ComputerName1
- XDHyp:\Connections\ConnectionName\RegionName\vm.folder\VMName2.vm,Domain\ComputerName2
例如:
XDHyp:\Connections\xpace-scale\East US.region\vm.folder\wsvdaV3-2.vm
其中,
-
xpace-scale
是 ConnectionName:您在 完整配置 > 托管 > 添加连接和资源中输入的连接的名称。有关详细信息,请参阅 创建连接和资源。 -
East US.region
是 RegionName:扩展名为.region
的区域的名称。 -
wsvdaV3-2.vm
是 VMName:扩展名为.vm
的虚拟机的名称。
-
-
文件可以包含的最大计算机数为 1000。要导入 1000 多台计算机,请将其分布在不同的文件中,然后逐个导入这些文件。我们建议您导入的计算机数不超过 1000。否则,目录创建可能需要很长时间才能完成。
您也可以在同一“添加计算机”页面上从目录中导出计算机。然后,在批量添加计算机时,可以将计算机的导出 CSV 用作模板。要导出计算机,请执行以下操作:
- 在管理 > 完整配置中,选择左窗格中的计算机目录。
- 选择计算机目录,然后在操作栏中选择添加计算机。此时将显示添加计算机窗口。
- 选择 导出到 CSV 文件。将下载包含计算机列表的 CSV 文件。
- 打开 CSV 文件以根据需要添加或编辑计算机。要使用保存的 CSV 文件批量添加计算机,请参阅上一节 使用 CSV 文件将计算机批量添加到目录。
注意:
此功能不适用于 Remote PC Access 和 MCS 配置的目录。
仅支持在相同类型的目录之间导出和导入 CSV 文件中的计算机。
使用 WebSocket VDA 注册工具将计算机注册到目录中
WebSocket VDA 注册工具便于对 VDA 计算机进行基于令牌的注册。此工具通过使用注册令牌将 VDA 添加到计算机目录来帮助您将连接转换为 WebSocket 连接。
注意:
此工具旨在注册尚未注册到任何计算机目录中的 VDA 计算机。
按照说明运行注册工具:
- 登录 VDA。
- 在
C:\Program Files\Citrix\Virtual Desktop Agent\Web Socket Vda Enrollment Tool
中找到工具EnrollMachine.exe
。 - 使用相应的输入参数运行该工具。例如,
EnrollMachine.exe -websocket_token_string:xxxxxxxxx
下表描述了注册工具的输入参数:
参数名称 | 必需 | 说明 | 示例 |
---|---|---|---|
-websocket_token_stdin |
是
|
读取注册令牌。 | .\EnrollMachine.exe -websocket_token_stdin |
-websocket_token_string |
直接从命令行参数读取注册令牌。 | .\EnrollMachine.exe -websocket_token_string:<token> |
|
-websocket_token_file:[token-file-path] |
从提供的路径读取注册令牌。 | .\EnrollMachine.exe -websocket_token_file:C:\token\test2.txt |
|
log:[log-file-path] |
否 | 显示注册工具日志。 | .\EnrollMachine.exe log:[C:\ProgramData\Citrix\EnrollMachine\EnrollMachine.txt] |
-help |
否 | 显示简短的帮助文本。 | .\EnrollMachine.exe -help |
成功注册后,您将在工具和日志中收到一条成功消息。确保登录到完整配置以验证 VDA 计算机是否已添加到目录中以及计算机的状态是否已注册。
故障排除
默认情况下,您可以在以下位置找到注册工具的日志:
C:\ProgramData\Citrix\EnrollMachine\EnrollMachine.txt
如果您为日志指定了不同的路径,则可以使用 log:[log-file-path]
来检索日志。
下表列出了注册工具返回的代码:
代码 | 字符串 | 说明 |
---|---|---|
0 | 成功 | VDA 已成功添加到计算机目录中。 |
-1 | InvalidArgument | 注册令牌中的输入参数无效。 |
-2 | BrokerAgentNotFound | 找不到 Broker Agent Service。 |
-3 | TokenInvalid | 输入的令牌无效。 |
-4 | TokenMissingRequiredClaims | 缺少令牌所需的申领,例如 CustomerId 或注册 URI。 |
-5 | InternalError | 出现了一般错误。 |
-6 | TimedOut | 任务已超时。 |
-7 | FailedToDetermineMachineADJoinedStatus | 返回计算机 AD 已加入状态的服务失败。 |
-8 | ADMachineFailedToFindSid | 返回 AD 计算机 Sid 的服务出现故障。 |
-9 | EnrollRequestFailed | 由于 HTTP 错误,请求失败。 |
-10 | EnrollResponseMissingRequiredFields | 注册工具的响应缺少参数 VirtualSiteId 。 |
-11 | InsufficientPermission | 您没有运行任务所需的权限。 |
-12 | FailedToDetermineMachineAadJoinedStatus | 检查计算机 AD 加入状态的服务会引发错误。 |
-13 | AadMachineFailedToFindDeviceId | 系统添加的附加参数 AAD device id 为空。 |
-14 | AadDeviceIdNotValid | 系统添加的附加参数 AAD device id 不是有效的 GUID。 |
-15 | NoValidMacAddress | MAC 地址无效。 |
-16 | FailedToGetComputerHostNameForVdaInstanceName | 无法获取用于设置附加参数 VdaInstanceName 的计算机主机名。 |
-17 | VirtualDesktopAgentRegistryKeyFailedToOpen | 无法打开 VDA 注册表项来写入 Delivery Controller 列表。 |
-18 | 失败的令牌已达到最大数量 | 失败的令牌已达到最大数量。 |
从目录中删除计算机
从计算机目录中删除计算机后,用户将无法再访问,因此,删除计算机之前,请确保:
- 用户数据已备份或者不再需要。
- 所有用户均已注销。打开维护模式将停止连接到计算机的新连接。
- 计算机已关闭电源。
从目录中删除计算机:
- 在管理 > 完整配置中,选择左窗格中的计算机目录。
- 选择一个目录,然后在操作栏中选择查看计算机。
- 选择一个或多个计算机,然后在操作栏中选择删除。
- 如果您要从目录中删除永久计算机,请选择是将其从虚拟机管理程序还是云服务中删除。如果您选择删除它们,请指明是保留、禁用还是删除他们的 Active Directory 帐户。
从 Azure Resource Manager 目录中删除永久计算机时,即使您选择保留这些计算机和关联资源组,也会从 Azure 中删除它们。
当您从目录中删除非永久性计算机时,它们会自动从虚拟机管理程序或云服务中删除。
编辑目录
- 在管理 > 完整配置中,选择左窗格中的计算机目录。
- 选择一个目录,然后在操作栏中选择编辑计算机目录。
- 在作用域页面上,更改作用域。
-
在 NIC 页面上,执行以下操作:
- 要更改 NIC 的子网映射,请从“关联网络”字段中选择一个网络。
- 要添加子网映射,请选择添加 NIC,从“关联网络”字段中选择一个网络,然后单击“保存”。
只有那些存在于与目录关联的主机中的子网才会出现在“关联网络”字段中。
在没有计算机配置文件的情况下,只能将 NIC 添加到 Azure 计算机目录中。
注意:
- 对于 AWS 计算机目录,您不能将同一个子网映射到多个 NIC。
- 对于带有计算机配置文件的计算机目录,目录上的 NIC 数量必须等于计算机配置文件上的 NIC 数量。
- IBM Cloud 虚拟机管理程序不支持此功能。
- 只有 Nutanix 虚拟机管理程序的 Nutanix Prism Element 支持此功能。
- 在 VDA 升级页面上,更改或选择要升级到的 VDA 版本。有关详细信息,请参阅 VDA 升级。
-
您可能会看到其他页面,具体取决于目录类型。
对于使用 Azure Resource Manager 映像创建的目录,以下页面可见。请记住,您所做的更改仅适用于稍后添加到目录的计算机。现有计算机保持不变。
-
在虚拟机页面上,更改要在其中创建计算机的计算机大小和可用性区域。
注意:
- 仅显示目录支持的计算机大小。
- 如有必要,请选择仅显示在其他计算机目录中使用的计算机规模以筛选计算机大小列表。
-
在计算机配置文件页面上,选择是使用计算机配置文件还是更改计算机配置文件。
-
(仅当目录配置了专用组主机时)在 专用主机组 页面上,选择是否更改主机组。
-
在“存储和许可类型”页面上,选择是否更改存储类型、许可类型和 Azure 电脑库设置(仅在使用“将准备好的图像放入 Azure 图库”时可用)。
注意:
如果新选择的设置不支持当前的计算机大小,则会出现一个警告对话框,通知您更改该设置将重置计算机大小设置。如果您选择继续, 虚拟机 菜单旁边会出现一个红点,提示您选择新的计算机大小。
有关页面上可用的设置的详细信息,请参阅使用 Azure Resource Manager 映像创建计算机目录。
对于 Remote PC Access 目录,以下页面可见:
- 在电源管理页面上,更改电源管理设置以及选择电源管理连接。
- 在组织单位页面上,添加或删除 Active Directory OU。
-
- 在说明页面上,更改目录说明。
- 单击“应用”以应用所做的更改,然后单击“保存”退出。
重命名目录
- 在管理 > 完整配置中,选择左窗格中的计算机目录。
- 选择一个目录,然后在操作栏中选择重命名计算机目录。
- 输入新名称。
删除目录
删除编录之前,请确保:
- 所有用户均已注销,没有正在运行已断开连接的会话。
- 该目录中的所有计算机均已打开维护模式,以便无法建立新连接。
- 该目录中的所有计算机均已关闭。
- 该目录未与交付组关联。即,交付组不包含该目录中的计算机。
要删除目录,请执行以下操作:
- 在管理 > 完整配置中,选择左窗格中的计算机目录。
- 选择一个目录,然后在操作栏中选择删除计算机目录。
- 如果目录包含永久计算机,请指明是从虚拟机管理程序还是云服务中删除这些计算机。如果您选择这样做,请选择是保留、禁用还是删除他们的 Active Directory 计算机帐户。
- 如有必要,请选择“隐藏进度”以在后台运行删除。
注意:
- 删除 Azure Resource Manager 目录时,关联的计算机和资源组将从 Azure 中删除,即使您选择保留它们也是如此。
- 当您删除包含非永久计算机的目录时,这些计算机将从虚拟机管理程序或云服务中删除。
- 如果在删除目录期间无法访问虚拟机管理程序或云服务,则目录和虚拟机删除都会失败。如果需要,您可以选择仅从 Citrix 站点数据库中删除 VM 记录。为此,请在“计算机目录”节点中选择 计算机目录 ,然后执行“故障排除”选项卡上显示的删除操作。请记住,此操作会使主机上的虚拟机保持不变。
管理目录中的 Active Directory 计算机帐户
要管理计算机目录中的 Active Directory 帐户,可以:
- 从单会话和多会话目录中删除 Active Directory 计算机帐户,从而释放未使用的计算机帐户。之后,这些帐户便可用于其他计算机。
- 添加帐户,以便在向此目录添加更多计算机时,有可用的计算机帐户。请勿在 OU 名称中使用正斜杠 (/)。
管理 Active Directory 帐户:
- 在管理 > 完整配置中,选择左窗格中的计算机目录。
- 选择一个目录,然后在操作栏中选择管理 AD 帐户。
-
选择是添加还是删除计算机帐户。如果添加帐户,请指定帐户密码的处理方式:重置所有密码还是输入一个适用于所有帐户的密码。
如果不知道当前的帐户密码,则可能需要重置密码;必须具有重置密码的权限。如果输入密码,该密码会在系统导入帐户时发生变化。如果删除某个帐户,请选择要在 Active Directory 中保留、禁用还是删除该帐户。
还可以指示从目录中删除计算机或删除目录时要保留、禁用还是删除 Active Directory 帐户。
更改目录的主映像
我们建议您在更改目录的主映像之前保存映像的副本或快照。数据库会保留每个计算机目录中使用映像的历史记录。如果用户在部署到其桌面的新映像时遇到问题,则可以将其回滚到以前的版本,从而最大限度地减少用户停机时间。不要对映像进行删除、移动或重命名。否则,您将无法回滚主映像。
重要:
更改永久目录的主映像时,请考虑以下几点:只有稍后添加到目录的计算机才会使用新映像创建。我们不会将新映像发布到目录中的现有计算机上。
更新计算机后,计算机将自动重新启动。
更新或创建映像
在更改目录的主映像之前,请通过更新现有映像或创建映像在主机虚拟机管理程序上准备新映像。
- 在您的虚拟机管理程序或云服务提供程序上,创建当前 VM 的快照并为该快照提供一个有意义的名称。此快照可用于回滚主映像。
- 如有需要,请打开映像的电源并登录。
- 安装更新或对映像做任何必要的更改。
- 如果映像使用个人虚拟磁盘,请更新清单。
- 关闭 VM 的电源。
- 拍摄 VM 的快照,为快照指定一个有意义的名称,以便在更改主映像时识别。
注意:
尽管您可以使用管理界面创建快照,但我们建议您使用虚拟机管理程序管理控制台创建快照,然后在完整配置管理界面中选择该快照。使用此方法可以提供有意义的名称及说明,而非自动生成的名称。对于 GPU 映像,只能通过 XenServer 的 XenCenter 控制台进行更改。
更改主映像
要向目录中的所有计算机推出新的主映像,请执行以下操作:
- 在管理 > 完整配置中,选择左窗格中的计算机目录。
- 选择一个目录,然后在操作栏中选择更改主映像。
-
在映像页面上,选择要前滚的主机和映像。
提示:
对于 MCS 创建的目录,可以通过为映像添加注释来对其映像进行注释。注释最多可以包含 500 个字符。每次更改主映像时,无论您是否添加注释,都会创建与注释相关的条目。如果您在未添加注释的情况下更新目录,该条目将显示为空 (-)。要查看映像的注释历史记录,请选择目录,在下方窗格中单击模板属性,然后单击查看附注历史记录。
-
在回滚策略页面上,选择何时使用新映像更改计算机目录中的计算机:下次关闭时或立即更改。
注意:
前滚策略页面不适用于永久 VM,因为部署仅适用于非永久 VM。
-
确认摘要页面上的信息,然后选择完成。每台计算机都在更新后自动重新启动。
要跟踪更新进度,请在 计算机目录中找到目录 ,以查看内联进度条和分步进度图。对于非永久目录,您可以通过“图像更新”列跟踪其 图像更新 状态,包括 已完全更新、 部分更新、 待更新和 准备图片。
提示:
要显示“映像更新”列,请在操作栏中选择“要显示的列”图标,选择“计算机目录”>“映像状态”,然后单击“保存”。
如果要使用 PowerShell SDK 更新目录,可以指定一个虚拟机管理程序模板 (VMTemplates
),作为映像或映像的快照的替换选项。
前滚策略
下次关机时更改映像将立即影响当前未使用的任何计算机,即没有活动用户会话的计算机。正在使用的系统在当前活动会话结束时接收更新。
注意:
部署策略仅适用于非永久 VM。
请注意以下事项:
- 在适用的计算机上完成更新之前,无法启动新会话。
- 对于单会话计算机,计算机未在使用或用户未登录时,将立即更新计算机。
- 对于包含子计算机的多会话操作系统,重新引导不会自动发生。必须手动将其关闭并重新启动。
提示:
可以通过主机连接的高级设置来限制要重新引导的计算机数量。使用这些设置可以修改针对给定目录执行的操作;高级设置因虚拟机管理程序而异。
回滚主映像
推出更新后的映像或新映像后,可以将其回滚。如果新更新的计算机出现问题,可能有必要进行回滚。回滚时,目录中的计算机将回滚到上一个工作映像。需要较新映像的任何新功能将不再可用。与前滚一样,回滚计算机也需要重新启动。
- 在管理 > 完整配置中,选择左窗格中的计算机目录。
- 选择目录,然后在操作栏中选择“回滚主映像”。
- 按前滚操作所述,指定对计算机应用早期映像的时间。
回滚仅适用于需要还原的计算机。对于尚未更改为新映像或更新映像的计算机(例如,用户未注销的计算机),用户不会收到通知消息,也不会被强制注销。
要跟踪回滚进度,请在 计算机目录中找到该目录 ,以查看内联进度条和分步进度图。
在某些情况下无法回滚,包括以下情况。(回滚主映像选项不可见)。
- 您没有回滚权限。
- 该目录不是使用 MCS 创建的。
- 该目录是使用操作系统磁盘的映像创建的。
- 用于创建该目录的快照已损坏。
- 用户对该目录中的计算机进行的更改不会保留。
- 该目录中的计算机处于运行状态。
更改功能级别或撤消更改
将计算机上的 VDA 升级到新版本后,更改计算机目录的功能级别。我们建议将所有 VDA 升级到最新版本,以访问所有最新功能。
在更改计算机目录的功能级别之前:
- 启动升级后的计算机,以便它们在 Citrix DaaS 中注册。这样,管理界面便可以确定目录中的计算机是否需要升级。
要更改目录的功能级别,请执行以下操作:
- 在管理 > 完整配置中,选择左窗格中的计算机目录。
- 选择目录。下部窗格中的详细信息选项卡会显示版本信息。
- 选择“更改功能级别”。如果管理界面检测到目录需要更改功能级别,则会显示一条消息。按照提示进行操作。如果一台或多台计算机无法更改,则会显示一条消息说明原因。确保所有计算机都能正常运行。我们建议您在单击“更改”之前解决这些问题。
目录升级完成后,您可以选择目录,然后在操作栏中选择“撤消功能级别更改”,将计算机还原为其先前的 VDA 版本。
克隆目录
在克隆目录之前,请注意以下事项:
- 无法更改与操作系统和计算机管理关联的设置。克隆的目录从原始目录继承这些设置。
- 克隆目录可能需要一些时间才能完成。如有必要,请选择隐藏进度以在后台运行克隆。
- 克隆的目录继承了原始目录的名称,并带有后缀
Copy
。可以更改此名称。请参阅重命名目录。 - 克隆完成后,请务必将克隆的目录分配给交付组。
- 您可以通过克隆来创建空目录。在目录克隆期间,您可以将 MCS 配置的目录的计算机数量设置为零,而对于非 MCS 配置的目录,可以不添加任何计算机。
- 在管理 > 完整配置中,选择左窗格中的计算机目录。
- 选择一个目录,然后在操作栏中选择克隆。
- 在克隆选定的计算机目录窗口中,查看克隆的目录的设置并配置适用的设置。选择下一步进入下一页。
- 在摘要页面上,查看设置的摘要,然后选择完成开始克隆。
- 如有必要,请选择隐藏进度以在后台运行克隆。
使用文件夹整理目录
可以创建文件夹来整理目录以便于轻松访问。例如,您可以按映像类型或组织结构整理目录。
提示:
通过单击操作栏右上角的文件夹图标,您可以为计算机目录节点设置首选的默认视图(文件夹或列表视图)。
必需的角色
默认情况下,您需要具有以下内置角色才能创建和管理目录文件夹:云管理员、完全权限管理员或计算机目录管理员。如有必要,您可以自定义用于创建和管理目录文件夹的角色。有关详细信息,请参阅 必需权限。
创建目录文件夹
在开始之前,请先计划如何整理您的目录。请注意以下事项:
- 最多可以嵌套五级深度的文件夹(不包括默认的根文件夹)。
- 目录文件夹可以包含目录和子文件夹。
- 完全配置 中的所有节点(例如 计算机目录 和 应用程序 节点)在后端共享一个文件夹树。为避免在重命名或移动文件夹时与其他节点发生名称冲突,我们建议您为不同节点中的第一级文件夹指定不同的名称。
要创建目录文件夹,请执行以下步骤:
- 在管理 > 完整配置中,选择左窗格中的计算机目录。
- 在文件夹层次结构中,选择一个文件夹,然后在操作栏中选择创建文件夹。
- 输入新文件夹的名称,然后单击完成。
提示:
如果您在非预期位置创建文件夹,则可以将其拖动到正确的位置。
移动目录
可以在文件夹之间移动目录。详细步骤如下所示:
- 在管理 > 完整配置中,选择左窗格中的计算机目录。
- 按文件夹查看目录。也可以打开文件夹层次结构上方的查看全部以一次查看所有目录。
- 右键单击某个目录,然后选择移动计算机目录。
- 选择要将目录移动到的文件夹,然后单击完成。
提示:
可以将目录拖到某个文件夹。
管理目录文件夹
可以删除、重命名和移动目录文件夹。
仅当文件夹及其子文件夹不包含目录时,才能删除该文件夹。
要管理文件夹,请执行以下步骤:
- 在管理 > 完整配置中,选择左窗格中的计算机目录。
-
在文件夹层次结构中,选择一个文件夹,然后根据需要在 操作 栏中选择一个操作:
- 要重命名文件夹,请选择重命名文件夹。
- 要删除文件夹,请选择删除文件夹。
- 要移动文件夹,请选择移动文件夹。
- 按照屏幕上的说明完成其余步骤。
所需的权限
下表列出了对目录文件夹执行操作所需的权限。
操作 | 所需的权限 |
---|---|
创建目录文件夹 | 创建计算机目录文件夹 |
删除目录文件夹 | 移除计算机目录文件夹 |
移动目录文件夹 | 移动计算机目录文件夹 |
重命名目录文件夹 | 编辑计算机目录文件夹 |
将目录移至文件夹 | 编辑计算机目录文件夹和编辑计算机目录属性 |
为 VDA 配置自动升级
重要:
- 为确保平稳升级,在将 VDA 升级到 CR 或 LTSR CU 版本之前,请确保满足必备条件并查看已知问题。请参阅使用完整配置界面升级 VDA。
- 将 LTSR VDA 升级到 LTSR 累积更新 (CU) 版本时,请确保在 VDA 上运行的 VDA 升级代理版本为 7.36.0.7 或更高版本。有关详细信息,请参阅 使用完整配置界面升级 VDA。
- 只要从早期版本切换到更高版本,就可以在 CR VDA 和 LTSR VDA 之间切换。您无法从更高版本切换到较早的版本,因为这被视为降级。例如,您无法从 2212 CR 降级到 2203 LTSR(任何 CU),但可以从 2112 CR 升级到 2203 LTSR(任何 CU)。
- 也可以使用 PowerShell 升级 VDA。请参阅使用 PowerShell 升级 VDA。
使用该功能,您可以执行以下操作:
- 逐个目录升级 VDA
- 编辑或取消计划的 VDA 升级
- 在创建目录后配置 VDA 升级设置
- 以每台计算机为单位升级 VDA
注意:
- 计划目录的 VDA 升级时,只有安装了 VDA 升级代理的目录中的 VDA 才能升级。
- 当计算机处于维护模式或在计算机上运行会话时,升级 VDA 将失败。
支持的计算机类型
此功能适用于以下计算机类型:
- MCS 配置的永久计算机(已加入 AD、已加入 Azure AD 和未加入域)。在目录创建过程中,您可以使用计算机管理页面上的 Citrix Machine Creation Services 进行部署。
- Remote PC Access 计算机
- 适用于 Windows 365 计算机的 Citrix HDX Plus
- 其他使用非 Citrix 预配服务或技术预配的永久性计算机。在目录创建过程中,您可以使用“计算机管理”页面上的其他服务或技术,将这些计算机添加到 DaaS 中进行管理。
有关 Citrix Machine Creation Services 和其他服务或技术选项的详细信息,请参阅计算机管理。
注意:
对于 MCS 配置的计算机,仅支持静态永久性计算机。不支持随机计算机,即使它们是永久性的。
逐个目录升级 VDA
注意:
在为目录安排 VDA 升级时,请注意,该目录中的所有计算机都将包含在升级作用域内。因此,我们建议在启动升级之前备份这些计算机。
为目录启用 VDA 升级后,您可以立即升级目录中的 VDA 或计划目录的升级。为此,请按照以下步骤操作:
- 在管理 > 完整配置中,选择计算机目录。
-
选择目录,然后从上下文菜单或操作栏中 升级 VDA。(右键单击可显示上下文菜单。)出现 VDA 升级窗口。
-
选择是否升级部署中的其他组件。除了升级之外,您还可以选择安装某些组件。如果某个组件需要配置,则必须单击“配置”按钮并配置该组件的设置才能继续。配置完成后,您可以单击“编辑”来更改配置。
重要:
- 要使用附加组件功能,请确保您的 VDA Upgrade Agent 为 7.34 或更高版本,该版本包含在 VDA 安装程序版本 2206 或更高版本中。
注意:
- 如果您选择不升级组件,则该组件在您的部署中将保持不变。
- 有关其他组件的完整列表,请参阅安装 VDA。
- 单击下一步。
-
选择是否启用任何列出的功能。单击下一步。
注意:
默认情况下,“启用还原清理”复选框处于选中状态。我们建议启用还原功能。启用该功能后,将在升级开始之前创建系统还原点。成功安装 VDA 后,还原点将被删除。有关详细信息,请参阅 安装或升级失败时还原。
-
选择是立即升级 VDA 还是按计划时间升级 VDA。
-
要立即升级 VDA,请选择 立即升级 ,然后指定持续时间。
持续时间是以小时为单位的时间,在此时间之后 VDA 升级服务停止启动其他升级。正在进行的升级将运行至完成。在此期间,当 VDA 符合条件时,DaaS 会开始升级(例如,不再有活动会话)。
必须升级的 VDA 越多,持续时间越长。我们建议选择较大的值(例如 12 小时)。否则,可能仍会有 VDA 无法在此窗口内升级 DaaS,具体取决于 VDA 的数量。
-
要计划升级,请选择 稍后 升级,然后指定升级的时间。
您只能为接下来的七天安排升级。您计划的升级仅适用于目录中当前的计算机。如果您稍后向目录中添加了计算机,但也希望对其进行升级,请取消计划的升级,然后重新创建计划。
-
-
选择“失败限制后停止升级(技术预览版)”选项。
行为插图
-
故障阈值和并发级别必须大于零。
-
故障阈值和并发级别必须小于或等于计划升级的计算机总数
故障阈值 并发级别 行为 已提供 未提供或输入 0 应用 FailureThreshold,并像以前一样由负载平衡器决定 ConcucrrencyLevel。 未提供或输入 0 已提供 FailureThreshold 默认为 10000(每个目录的最大计算机数),并使用 ConcucrrencyLevel 进行批处理。 未提供或输入 0 未提供或输入 0 默认行为适用于负载平衡器更新的并发级别。 -
-
输入故障阈值。
注意:
故障阈值是故障次数,在此之后,VUS 将暂停升级代理未选择的后续批次中的任何待升级安装。
-
输入并发度。
注意:
并行升级是指在升级窗口内的任何时候可以并行升级的虚拟机数量。
-
单击下一步。
注意:
ExitOnError 与“启用还原”或“启用还原和清理”不兼容,可能无法按预期运行。
- 在“摘要”页面上查看您的选择,然后单击“完成”以应用您的设置并退出窗口。
注意:
- 只有在为目录启用 VDA 升级后,升级 VDA 选项才可用。要启用 VDA 升级,请编辑目录。
- 在推出升级时,目录中的所有计算机都将置于维护模式。升级最多可能需要 30 分钟才能开始,并且只会在指定的时间段内执行。
在 计算机目录 节点上,“VDA 升级”列提供了目录的 VDA 升级信息。可能会出现以下信息:
提示:
要显示 VDA 升级列,请在操作栏中选择要显示的列,选择计算机目录 > VDA 升级,然后单击保存。
- 可用:有新的 VDA 版本可用。
- 已计划:已计划 VDA 升级。
- 未配置:未为目录启用 VDA 升级时显示。
- 最新:目录的 VDA 是最新的。
- 未知:无法获取 VDA 升级所需的信息。有多种可能的原因:
您还可以查看目录的 VDA 升级状态。为此,请单击目录,然后在“详细信息”选项卡上查看 VDA 升级状态 信息。可能会出现以下信息:
- 未计划:您已为目录启用 VDA 升级,但尚未设置升级计划。
-
已计划:您已为目录创建了升级计划。例如,如果将计划设置为
09:00 PM, December 14, 2030
开始,则会显示如下信息:December 14, 2030 09:00 PM UTC
的计划。 - 进行中:VDA 升级已启动。
- 已取消:您已取消计划的升级。
- 失败:目录包含一台或多台 VDA 升级未成功的计算机。
- 成功:目录中的所有 VDA 均已成功升级。
您还可以使用针对目录的建议操作对 VDA 升级问题进行故障排除。为此,请单击目录,然后转到“故障排除”选项卡。
要快速细化到具有特定 VDA 升级状态的目录,可以使用筛选器。有关详细信息,请参阅在“完整配置”管理界面中使用搜索。
请注意以下事项:
- VDA 升级或 VDA 升级状态过滤器仅可用于以下过滤器:名称和计算机目录。
- 使用 VDA 升级或 VDA 升级状态过滤器时,右上角的错误和警告将变为不可用。
编辑或取消计划的 VDA 升级
为目录安排升级后,您可能需要编辑或取消计划的升级。为此,请按照以下步骤操作:
- 在管理 > 完整配置中,选择计算机目录。
- 选择目录,然后在操作栏中选择编辑计划的 VDA 升级。将出现“编辑 VDA 升级”窗口,显示有关已安装的 VDA 版本和要升级到的 VDA 版本的信息。
-
选择是编辑还是取消计划的升级。
- 要取消升级,请单击“取消计划的升级”。请记住:取消计划的升级不会强制停止正在进行的升级。
- 单击“完成”退出窗口。
通过编辑目录配置 VDA 升级设置
创建目录后,可以通过编辑目录来配置 VDA 升级设置。在开始编辑之前,请考虑以下事项:
-
验证目录中的所有计算机是否都在同一 VDA(CR 或 LTSR)轨道上。否则,某些 VDA 升级将失败。例如,如果您选择 最新 LTSR VDA,则 CR VDA 升级将失败。
-
目录中某些计算机的升级可能已经开始。您无法修改已在进行的升级。正在进行的升级仍在继续。那些尚未启动的版本将升级到指定版本。
以每台计算机为单位升级 VDA
为目录启用 VDA 升级后,您可以逐个或批量升级该目录的 VDA。为此,请按照以下步骤操作:
- 从“管理”>“完整配置”中,选择“搜索”。
-
选择一台或多台计算机,然后从上下文菜单或操作栏中升级 VDA。(右键单击可显示上下文菜单。)
注意:
- 要使“升级 VDA”选项可用,请确保已为选定计算机所在的目录启用 VDA 升级,并且这些计算机安装了 VDA 升级代理。要为其启用 VDA 升级,请编辑目录。
- 在推出升级时,计算机将被置于维护模式。升级最多可能需要 30 分钟才能开始。
- 如果您选择的计算机包含 VDA 升级不可用或升级处于挂起状态(已计划、正在进行或等待升级)的计算机,我们将跳过这些计算机的升级。
在“搜索”节点上,可以添加“VDA 升级”列。有关如何添加自定义列的信息,请参阅 自定义要显示的列。该列很有用。它为计算机提供了 VDA 升级信息。可能会出现以下信息:
- 可用:有新的 VDA 版本可用。
- 已计划:已计划 VDA 升级。
- 未配置:未为计算机启用 VDA 升级时显示。
- 最新:VDA 是最新的。
- 未知:尚无有关 VDA 升级的信息。
您还可以查看计算机的 VDA 升级状态。为此,请单击计算机,然后在“详细信息”选项卡上查看 VDA 升级状态 信息。可能会出现以下信息:
- 未知:无法获取 VDA 升级所需的信息。有多种可能的原因:
-
已计划:您已设置升级计划。例如,如果将计划设置为
09:00 PM, December 14, 2030
开始,则会显示如下信息:December 14, 2030 09:00 PM UTC
的计划。 - 等待升级:计算机处于维护模式,等待升级。(请确保用户已注销会话,以便升级可以继续。)
- 进行中:VDA 升级已启动。
- 升级失败:尝试升级 VDA 失败。
- 验证失败:尝试验证 VDA 升级设置失败。
- 已取消:计算机的升级已被取消。
- 成功:VDA 已成功升级。
您还可以使用针对计算机的建议操作对 VDA 升级问题进行故障排除。为此,请单击计算机,然后转到“故障排除”选项卡。
要快速深入查看具有特定 VDA 升级状态的计算机,可以使用过滤器。有关详细信息,请参阅在“完整配置”管理界面中使用搜索。请注意以下事项:
- VDA 升级或 VDA 升级状态过滤器仅可用于以下过滤器:名称和计算机目录。
- 使用 VDA 升级或 VDA 升级状态过滤器时,右上角的错误和警告将变为不可用。
管理目录的配置集
在开始之前,请确保已设置 WEM 服务部署。有关详细信息,请参阅 Workspace Environment Management 服务入门。
注意:
默认情况下,如果您具有云管理员、完全访问权限管理员或计算机目录管理员角色,则可以管理目录的配置集。如有必要,您可以通过向角色授予“管理配置集”权限来允许他们管理配置集。
将目录绑定到配置集
重要:
如果您的 Citrix DaaS 和 WEM 服务实例不在同一区域中,则无法将目录绑定到配置集。在这种情况下,请将您的 WEM 服务迁移到与 Citrix DaaS 相同的区域。
要将目录绑定到配置集,请执行以下步骤:
-
在管理 > 完整配置中,选择计算机目录。
-
选择计算机目录,然后在操作栏中选择管理配置集。此时将显示管理配置集窗口。
-
选择要将目录绑定到的 WEM 配置集。
注意:
如果选定的配置集不包含与 WEM 的基本配置相关的设置,则会出现将基本设置应用到配置集选项。我们建议您选择用于将基本设置应用到配置集的选项。
-
单击保存以保存更改。
切换到其他配置集
要切换到目录的其他配置集,请执行以下步骤:
- 在管理 > 完整配置中,选择计算机目录。
- 选择计算机目录,然后在操作栏中选择管理配置集。此时将显示管理配置集窗口。
- 选择要将目录绑定到的其他 WEM 配置集。
- 单击保存以保存更改。
从配置集取消绑定目录
要从配置集解除目录的绑定,请执行以下步骤:
- 在管理 > 完整配置中,选择计算机目录。
- 选择计算机目录,然后在操作栏中选择管理配置集。此时将显示管理配置集窗口。
- 单击所选配置集右侧的 X 图标。
- 单击保存以保存更改。
重试创建目录
注意:
此功能仅适用于 MCS 目录。
故障目录标有错误图标。要查看详细信息,请转到每个目录的故障排除选项卡。在重试创建目录之前,请注意以下注意事项:
- 请先查看故障排除信息并解决问题。该信息描述了发现的问题并提供了解决这些问题的建议。
- 无法更改与操作系统和计算机管理关联的设置。该目录继承了原始目录中的这些设置。
- 创作可能需要一些时间才能完成。如有必要,请选择隐藏进度以在后台运行创作。
要重试创建目录,请执行以下操作:
- 在管理 > 完整配置中,选择左窗格中的计算机目录。
- 选择目录,然后转到其“故障排除”选项卡。
- 单击“重试”超链接重试创建目录。
- 在出现的向导中,根据需要更改设置。如果无需进行更改,则可以直接转到“摘要”页面。
- 完成后,选择“完成”开始创建。
(仅限非 Citrix 预置的 VDA)生成和管理注册令牌
在您决定对非 Citrix 配置的计算机采用基于令牌的注册后,请根据每台计算机目录生成令牌,然后与 VDA 安装管理员共享。
注册令牌具有以下特点:
- 注册范围:1 到 100 台 VDA 计算机
- 有效期:最长 14 天
要使用完整配置为目录生成令牌,请执行以下步骤:
- 在“完整配置”>“计算机目录”中,找到非 MCS 配置的目录,该目录的“计算机数量”列中显示了“预配方法:手动”。
- 右键单击目录,然后选择“管理注册令牌”。
- 在出现的生成注册令牌页面上,提供以下令牌信息:
- 键入令牌的名称。
- 输入其有效期。期限不得超过 14 天。该令牌仅在指定时间段内有效。
- (可选)选择主机连接,对使用令牌注册的 VDA 进行电源管理。选项包括该目录区域下的所有主机连接。
- 输入令牌使用限制(介于 1—100 之间)。
- 单击 Generate(生成)。
-
在出现的“成功生成令牌”窗口中,复制令牌并将其保存在安全的地方,或单击“下载”将其下载到“下载”文件夹。
令牌记录出现在令牌列表中。
-
与 VDA 安装管理员共享令牌。
有关如何在计算机上安装 VDA 和令牌的更多信息,请参阅安装 VDA。
管理令牌
您可以通过两种方式撤消令牌并使其不可用于 VDA 注册:
- 撤销:撤销令牌,但将其保留在列表中以用于记录目的。
- 删除:撤消令牌并将其从列表中删除。
注意:
过期的令牌将在 14 天内自动删除。
使用 PowerShell
本部分内容详细介绍了如何使用 PowerShell 管理目录:
- 使用 PowerShell 检查 VDA 升级状态和 VDA 版本
- 管理计算机名称的序列号
- 启用一次性重新启动计划
- 向映像中添加描述
- 重置操作系统磁盘
- 修复活跃计算机帐户的身份信息
- 更改现有计算机目录的网络设置
- 管理计算机目录的版本
- 更改现有计算机目录的缓存配置
- 将非基于计算机配置文件的计算机目录转换为基于计算机配置文件的计算机目录
- 检索与目录关联的警告和错误
- 删除没有虚拟机管理程序访问权限的计算机
- 通过本地文件共享访问功能支持 VDA 更新
使用 PowerShell 检查 VDA 升级状态和 VDA 版本
使用 Get-VusCatalog
PowerShell 命令检查 VDA 升级状态。假设目录名称为 wuhanTestMC1
。可以在命令提示符下键入以下内容:
PS C:\> Get-VusCatalog -Name wuhanTestMC1
在此示例中,UpgradeState
为 UpgradeAvailable
,表示已为目录启用 VDA 升级。StateId
为 UpgradeSuccessful
,表示该目录已成功升级到 2112.0.0.32068 (UpgradeVersion
)。
使用 Get-BrokerMachine
PowerShell 命令获取当前 VDA 版本。
使用 Get-VusAvailableVdaVersion
PowerShell 命令获取最新的 VDA 版本。
管理计算机名称的序列号
要通过 PowerShell 命令自定义使用 MCS 部署的计算机的序列号,请执行以下操作:
- 以管理员身份在 Delivery Controller 上打开 PowerShell。
- 运行命令
asnp citrix*
加载 Citrix 模块。 -
运行以下命令检查目录身份池的起始次数:
Get-AcctIdentityPool -IdentityPoolName xxx <!--NeedCopy-->
IdentityPoolName
是目录的名称。 -
如果要将此计数设置为其他值,请运行以下命令并将 StartCount 指定为 X:
Set-AcctIdentityPool -IdentityPoolName xxx -StartCount X <!--NeedCopy-->
- 将计算机添加到目录中,以便按所需数量创建计算机。
-
创建计算机后,运行以下命令将其设置回原始值 Y:
Set-AcctIdentityPool -IdentityPoolName xxx -StartCount Y <!--NeedCopy-->
启用一次性重启计划
如果要使用 PowerShell 启用一次性重新启动计划,请使用以下 BrokerCatalogRebootSchedule
PowerShell 命令创建、修改和删除重新启动计划:
Get-BrokerCatalogRebootSchedule
New-BrokerCatalogRebootSchedule
Set-BrokerCatalogRebootSchedule
Remove-BrokerCatalogRebootSchedule
Rename-BrokerCatalogRebootSchedule
示例:
-
为目录中名为 BankTellers 的 VM 创建重新启动计划,该计划将于 2022 年 2 月 3 日凌晨 2 点到凌晨 4 点之间开始。
New-BrokerCatalogRebootSchedule -Name BankTellers -CatalogName BankTellers -StartDate "2022-02-03" -StartTime "02:00" -Enabled $true -RebootDuration 120 <!--NeedCopy-->
-
为目录中 UID 为 17 的 VM 创建重新启动计划,该计划将于 2022 年 2 月 3 日凌晨 1 点到凌晨 5 点之间开始。在重启前十分钟,每个 VM 都设置为在每个用户会话中显示一个消息框,标题为:警告:重启待定以及消息保存您的工作。
New-BrokerCatalogRebootSchedule -Name 'Update reboot' -CatalogUid 17 -StartDate "2022-02-03" -StartTime "01:00" -Enabled $true -RebootDuration 240 -WarningTitle "WARNING: Reboot pending" -WarningMessage "Save your work" -WarningDuration 10 <!--NeedCopy-->
-
要重命名目录,请重新启动名为“旧名称改为新名称”的时间表。
Rename-BrokerCatalogRebootSchedule -Name "Old Name" -NewName "New Name" <!--NeedCopy-->
-
显示 UID 为 1 的所有目录重新启动计划,然后将 UID 为 1 的目录重新启动计划重命名为新名称。
Get-BrokerCatalogRebootSchedule -Uid 1 | Rename-BrokerCatalogRebootSchedule -NewName "New Name" -PassThru <!--NeedCopy-->
-
将名为会计的目录重启计划设置为在每台 VM 重启前十分钟显示标题为“警告:待重启”的消息,以及消息“保存您的工作”。该消息出现在该 VM 上的每个用户会话中。
Set-BrokerCatalogRebootSchedule -Name Accounting -WarningMessage "Save your work" -WarningDuration 10 -WarningTitle "WARNING: Reboot pending" <!--NeedCopy-->
-
显示所有已禁用的重新启动计划,然后启用所有已禁用的重新启动计划。
Get-BrokerCatalogRebootSchedule -Enabled $false | Set-BrokerCatalogRebootSchedule -Enabled $true <!--NeedCopy-->
-
使用 UID 17 设置目录重启时间表以显示以下消息:在每个 VM 重启前的十五、十和五分钟内在 %m% 分钟内重新启动。
Set-BrokerCatalogRebootSchedule 17 -WarningMessage "Rebooting in %m% minutes." -WarningDuration 15 -WarningRepeatInterval 5 <!--NeedCopy-->
-
为名为 MyCatalog 的目录配置时区。
Set-BrokerCatalog -Name "MyCatalog" -TimeZone <TimeZone> <!--NeedCopy-->
向映像中添加描述
可以添加与计算机目录的映像更新有关的更改的信息性描述。在创建目录时或更新目录的现有主映像时,可以使用此功能添加描述。还可以显示目录中的每个主映像的信息。此功能对于希望在更新目录使用的主映像(例如安装的 Office 365)时添加描述性标记的管理员非常有用。使用以下命令添加或查看映像说明:
-
NewProvScheme
。新参数masterImageNote
允许您向映像中添加注释。例如:
C:\PS>New-ProvScheme -ProvisioningSchemeName XenPS -HostingUnitName XenHu -IdentityPoolName idPool1 -MasterImageVM XDHyp:\HostingUnits\XenHU\Base.vm\Base.snapshot -MasterImageNote "Office365 installed"
<!--NeedCopy-->
-
Publish-ProvMasterVMImage
。使用此参数可发布注释。例如:
C:\PS>Publish-ProvMasterVMImage -ProvisioningSchemeName MyScheme -MasterImageVM XDHyp:\HostingUnits\HostUnit1\RhoneCC_baseXP.vm\base.snapshot -MasterImageNote "Visual Studio 2019 installed"
<!--NeedCopy-->
-
Get-ProvSchemeMasterVMImageHistory
。显示每个映像的信息。例如:
C:\PS>Get-ProvSchemeMasterVMImageHistory -ProvisioningSchemeName MyScheme -Showall
VMImageHistoryUid : 3cba3a75-89cd-4868-989b-27feb378fec5
ProvisioningSchemeUid : 7585f0de-192e-4847-a6d8-22713c3a2f42
ProvisioningSchemeName : MyScheme
MasterImageVM : /Base.vm/base.snapshot
Date : 17/05/2021 09:27:50
MasterImageNote : Office365 installed
<!--NeedCopy-->
重置操作系统磁盘
使用 PowerShell 命令 Reset-ProvVMDisk
在 MCS 创建的计算机目录中重置永久性 VM 的操作系统磁盘。目前,此功能适用于 Azure、Google Cloud、SCVMM、VMware 和 XenServer 虚拟化环境。
要成功运行 PowerShell 命令,请确保:
- 目标 VM 位于永久 MCS 目录中。
- MCS 计算机目录运行正常。这意味着资源预配方案和主机存在,并且预配方案有正确的条目。
- 虚拟机管理程序未处于维护模式。
- 目标 VM 已关闭电源并处于维护模式。
请执行以下步骤以重置操作系统磁盘:
- 打开 PowerShell 窗口。
- 运行 asnp citrix* 以加载特定于 Citrix 的 PowerShell 模块。
-
使用以下任一方式运行 PowerShell 命令
Reset-ProvVMDisk
:-
将 VM 列表指定为以逗号分隔的列表,然后在每个 VM 上执行重置:
Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName ("abc","def") -OS <!--NeedCopy-->
-
将 VM 列表指定为
Get-ProvVM
命令的输出,然后在每个 VM 上执行重置:(Get-ProvVM -ProvisioningSchemeName "xxx") | Reset-ProvVMDisk "abc" -OS <!--NeedCopy-->
-
按名称指定单个 VM:
Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS <!--NeedCopy-->
-
为
Get-ProvVM
命令返回的每个 VM 创建单独的重置任务。这种方法效率较低,因为每个任务都将执行相同的冗余检查,例如虚拟机管理程序功能检查、每个 VM 的连接检查。Get-ProvVM -ProvisioningSchemeName "xxx" | Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -OS <!--NeedCopy-->
-
-
出现确认提示,其中列出了要重置的 VM 以及一条警告消息,提示这是不可恢复的操作。如果您没有提供答案并按 Enter 键,则不会采取进一步的操作。
可以运行 PowerShell 命令
-WhatIf
来打印其要执行的操作,然后在不执行该操作的情况下退出。也可以使用以下方法之一绕过确认提示:
-
提供
-Force
参数:Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS -Force <!--NeedCopy-->
-
提供
-Confirm:$false
参数:Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS -Confirm:$false <!--NeedCopy-->
-
在运行
Reset-ProvVMDisk
之前,请将$ConfirmPreference
更改为“无”:PS C:\Windows\system32> $ConfirmPreference='None' PS C:\Windows\system32> $ConfirmPreference None PS C:\Windows\system32> Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS <!--NeedCopy-->
注意:
在重置过程完成之前,请勿使虚拟机退出维护模式或开启 VM。
-
- 运行
Get-ProvTask
以获取Reset-ProvVMDisk
命令返回的任务的状态。
修复活跃计算机帐户的身份信息
可以重置存在身份相关问题的活动计算机帐户的身份信息。可以选择仅重置计算机密码和信任密钥,也可以重置身份磁盘的所有配置。此实现同时适用于永久性和非永久性 MCS 计算机目录。
注意:
目前,只有 Azure 和 VMware 虚拟化环境支持该功能。
条件
请务必满足以下条件才能成功重置身份磁盘:
- 关闭 VM 并将其设置为维护模式
- 请勿在 PowerShell 命令中包含参数-OS
重置身份信息
要重置身份信息,请执行以下操作:
- 打开 PowerShell 窗口。
- 运行
asnp citrix*
以加载 Citrix 特定的 PowerShell 模块。 -
重置身份信息。
-
要仅重置计算机密码和信任密钥,请按以下顺序运行以下命令:
Repair-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfo <!--NeedCopy-->
该命令中使用的参数的说明如下:
-
IdentityAccountName
:必须修复的身份帐户的名称。 -
PrivilegedUserName
:对身份提供商(AD 或 Azure AD)具有写入权限的用户帐户。 -
PrivilegedUserPassword
:PrivilegedUserName 的密码。 -
Target
:修复操作的目标。可以是 IdentityInfo 来修复帐户密码/信任密钥,也可以是用户证书来修复加入混合 Azure AD 的计算机身份的用户证书属性。
Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMname <name> -Identity -ResetIdentityInfo <!--NeedCopy-->
ResetIdentityInfo
参数重置以下内容:- 密码和信任密钥:如果 VM 加入了 AD 域(仅适用于 Citrix DaaS)
- 仅限信任密钥:如果 VM 未加入 AD 域(仅适用于 Citrix DaaS)
- 仅限密码:如果 VM 加入了 AD 域(仅适用于 Citrix Virtual Apps and Desktops)
-
-
要重置身份磁盘的所有配置,请按以下顺序运行以下命令:
Repair-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfo <!--NeedCopy-->
Reset-ProvVMDisk ProvisioningSchemeName <name> -VMName <name> -Identity <!--NeedCopy-->
-
-
键入 y 确认操作。也可以使用
-Force
参数跳过确认提示。例如:Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMName <name> -Identity -Force <!--NeedCopy-->
- 运行
Get-ProvVM -ProvisioningSchemeName <name -VMName <name>
以检查更新后的身份磁盘设置。必须更新身份磁盘的属性(例如IdentityDiskId
)。StorageId
和IdentityDiskIndex
不得更改。
更改现有计算机目录的网络设置
您可以更改现有计算机目录的网络设置,以便在新的子网上创建新的虚拟机。使用 Set-ProvScheme
命令中的 -NetworkMapping
参数更改网络设置。
要更改现有预配方案的网络设置,请执行以下操作:
- 在 PowerShell 窗口中,运行命令
asnp citrix*
以加载 PowerShell 模块。 - 运行
(Get-Provscheme -ProvisioningSchemeName "name").NetworkMaps
以获取要更改的网络路径。 -
为新的网络设置分配一个变量。例如:
$NewNetworkMap = @{"0"= "XDHYP:\HostingUnits\MyNetworks\Network 0.network"} <!--NeedCopy-->
- 运行
Set-ProvScheme -ProvisioningSchemeName "name" -NetworkMapping $NewNetworkMap
。 - 运行
(Get-Provscheme -ProvisioningSchemeName "name").NetworkMaps
以验证现有预配方案的新网络设置。
管理计算机目录的版本
使用 Set-ProvScheme
命令更新 MCS 计算机目录时,当前配置将另存为版本。然后,您可以使用 PowerShell 命令管理计算机目录的各种版本。您可以:
- 查看计算机目录的版本列表
- 使用任意早期版本更新计算机目录
- 在该计算机目录的 VM 未使用某个版本时手动删除该版本
- 更改计算机目录保留的最大版本数量(默认值为 99)
版本包含计算机目录的以下信息:
- VMCpuCount
- VMMemoryMB
- CustomProperties
- ServiceOffering
- MachineProfile
- NetworkMapping
- 安全组
运行以下命令(以示例形式提供)来管理计算机目录的各种版本。
-
要查看计算机目录的各种版本的配置详细信息,请执行以下操作:
Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog <!--NeedCopy-->
-
要查看计算机目录的特定版本的配置详细信息,请执行以下操作:
Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog -Version 2 <!--NeedCopy-->
-
要查看与计算机目录关联的版本总数,请执行以下操作:
``` (Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog).Count
-
要使用任意早期版本更新计算机目录,请执行以下操作:
Set-ProvScheme -ProvisioningSchemeName AzureCatalog -Version 2 <!--NeedCopy-->
-
要在该计算机目录的 VM 未使用某个版本时手动删除该版本,请执行以下操作:
Remove-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog -Version 3 <!--NeedCopy-->
-
设置计算机目录保留的最大版本数量(默认值为 99)。此设置适用于所有目录。例如,在这种情况下,所有 MCS 预配的目录最多保留 15 个版本。
Set-ProvServiceConfigurationData -Name "MaxProvSchemeVersions" -Value 15 <!--NeedCopy-->
如果版本数量达到最大版本数,则如果计算机目录中的任何 VM 正在使用较旧的版本,则无法创建新版本。在这种情况下,请执行以下操作之一:
- 增加计算机目录保留的最大版本数量的上限。
- 更新一些较旧的版本上的 VM,以便这些较旧的版本不再被任何 VM 引用,并且可以将其删除。
更改现有计算机目录的缓存配置
在启用了 MCSIO 的情况下创建非永久目录后,您可以使用 Set-ProvScheme
命令修改以下参数:
- WriteBackCacheMemorySize
- WriteBackCacheDiskSize
此功能当前适用于:
- GCP 和 Microsoft Azure 环境,以及
- 启用了 MCSIO 的非永久性目录
要求
修改缓存配置的要求如下:
- 更新到 VDA 的最新版本(2308 或更高版本)。
-
为现有的计算机目录启用参数
UseWriteBackCache
。使用New-ProvScheme
创建启用了UseWriteBackCache
的计算机目录。例如:New-ProvScheme -ProvisioningSchemeName $CatalogName -HostingUnitUid $HostingUnitUid ` -IdentityPoolUid $acctPool.IdentityPoolUid -CleanOnBoot ` -MasterImageVM $MasterImage ` -ServiceOffering $ServiceOffering ` -NetworkMap $NetworkMap ` -SecurityGroup $SecurityGroup ` -UseWriteBackCache -WriteBackCacheDiskSize 8 <!--NeedCopy-->
更改缓存配置
运行 Set-ProvScheme
命令。例如:
Set-ProvScheme -ProvisioningSchemeName $provScheme.ProvisioningSchemeName -WriteBackCacheDisk32 -WriteBackCacheMemorySize 128
<!--NeedCopy-->
注意:
WriteBackCacheDiskSize
的值必须大于零,因为至少需要 1 GB 的缓存磁盘存储空间。WriteBackCacheMemorySize
的值必须小于计算机目录内存大小。- 这些更改仅影响更改后添加到目录中的新 VM。现有虚拟机不受这些更改的影响。
将基于非计算机配置文件的计算机目录转换为基于计算机配置文件的计算机目录
您可以使用虚拟机、模板规范(如果是 Azure)或启动模板(以 AWS 为例)作为计算机配置文件输入,将非基于计算机配置文件的计算机目录转换为基于计算机配置文件的计算机目录。添加到目录中的新 VM 从计算机配置文件中获取属性值。
注意:
基于计算机配置文件的现有计算机目录无法更改为非基于计算机配置文件的计算机目录。
为此,您需要:
- 创建包含 VM 但不包含计算机配置文件的永久性或非永久性计算机目录。
- 打开 PowerShell 窗口。
-
运行
Set-ProvScheme
命令以将计算机配置文件中的属性值应用到添加到计算机目录中的新 VM。例如:-
对于 Azure:
Set-ProvScheme = Set-ProvScheme -ProvisioningSchemeName xxxx -MachineProfile XDHyp:\HostingUnits<HostingUnitName>\machineprofile.folder<ResourceGroupName><TemplateSpecName><VersionName> <!--NeedCopy-->
-
以 AWS 为例:
Set-ProvScheme = Set-ProvScheme -ProvisioningSchemeName xxxx -MachineProfile "XDHyp:\HostingUnits<hosting-unit><launch-template>.launchtemplate<launch-template-version>.launchtemplateversion" <!--NeedCopy-->
-
检索与目录关联的警告和错误
可以获取历史错误和警告,以了解您的 MCS 计算机目录中的问题并修复这些问题。
使用 PowerShell 命令,您可以:
- 获取错误或警告列表
- 将警告状态从新更改为已确认
- 删除错误或警告
要运行 PowerShell 命令,请执行以下操作:
- 打开 PowerShell 窗口。
- 运行
asnp citrix*
以加载 Citrix 特定的 PowerShell 模块。
要获取错误和警告列表,请执行以下操作:
运行 Get-ProvOperationEvent
命令。
- 不带参数: 获取所有错误和警告
- 使用
LinkedObjectType
和LinkedObjectUid
参数:获取与特定预配方案关联的所有错误和警告 - 使用
EventId
参数:获取与此事件 ID 匹配的特定错误或警告 - 使用
Filter
参数:通过自定义过滤器获取错误或警告
要将错误或警告的状态从新更改为已确认,请执行以下操作:
运行 Confirm-ProvOperationEvent
命令。
- 使用
EventId
参数:设置与此事件 ID 匹配的特定错误或警告的状态。可以作为Get-ProvOperationEvent
命令的输出获取特定错误或警告的EventId
- 使用
LinkedObjectType
和LinkedObjectUid
参数:设置与特定预配方案关联的所有错误和警告的状态 - 使用
All
参数:将所有错误和警告的状态设置为已确认
要删除错误或警告,请执行以下操作:
运行 Remove-ProvOperationEvent
命令。
- 使用
EventId
参数:删除与此事件 ID 匹配的特定错误或警告。可以作为Get-ProvOperationEvent
命令的输出获取特定错误或警告的EventId
- 使用
LinkedObjectType
和LinkedObjectUid
参数:删除与特定预配方案关联的所有错误和警告 - 使用
All
参数:删除所有错误和警告
有关详细信息,请参阅 Citrix PowerShell SDK。
删除没有虚拟机管理程序访问权限的计算机
删除虚拟机或配置方案时,MCS 需要从 VM 中移除标签,有时还需要从基础磁盘中移除标记,这样 MCS 就不会再跟踪或识别删除选项中包含的资源。但是,其中一些资源只能通过虚拟机管理程序访问。即使没有虚拟机管理程序访问权限,也可以使用 Remove-ProvVM
PowerShell 中的 PurgeDBOnly
选项从数据库中删除 VM 资源对象,例如 VM、基础磁盘、ACG 中的映像等。
此选项在以下情况下启用:
- 所有支持的虚拟机管理程序
- 永久和非永久 VM
限制
不能同时使用 -PurgeDBOnly 和 -ForgetVM 命令。
使用 PurgeDBOnly 命令
在以下情况下,运行 PowerShell 命令 Remove-ProvVM -ProvisioningSchemeName SCVMM-MC -VMName SCVMM01 -ForgetVM
时,删除操作可能会失败:
- 主机连接处于维护模式
- 凭据无效
- 身份验证失败
- 未经授权的操作
- 无法访问虚拟机管理程序
注意:
Remove-provVM -ForgetVM 仅针对永久 VM。如果列表中的其中一个虚拟机是非永久 VM,则操作将失败。
如果由于无法访问虚拟机管理程序而导致操作失败,则会出现以下提示:
Try to use -PurgeDBOnly option to clean DDC database.
使用 Remove-ProvVM
PowerShell 命令中的 -PurgeDBOnly
选项从 MCS 数据库中删除虚拟机的引用。例如,
Remove-ProvVM -ProvisioningSchemeName SCVMM-MC -VMName SCVMM01 -PurgeDBOnly
通过本地文件共享访问支持 VDA 更新(技术预览版)
通过 PowerShell cmdlet 指定 VDA 安装程序的位置,这样可以减少您提供网络规则以允许每个 VDA 从 Citrix Managed Azure CDN 获取新的 VDA 安装程序所花费的精力。
PowerShell cmdlet
在 New-VusCatalogSchedule 和 New-VusMachineUpgrade cmdlet 中添加了两个新的可选参数,允许您使用本地文件共享中的安装程序
- VdaWorkstationPackageUri - 指定工作站操作系统 VDA 安装程序的 UNC 路径
- VdaServerPackageUri - 指定服务器操作系统 VDA 安装程序的 UNC 路径
必备条件
- VDA Upgrade Agent 升级到版本 7.40.0.35 或更高版本(使用 VDA 安装程序版本 2311 或更高版本)
- Virtual Apps and Desktops Remote PowerShell SDK 版本 7.40 或更高版本(于 2024 年 1 月 10 日或之后发布)
- Remote PowerShell SDK 版本 7.42 或更高版本(2024 年 2 月 16 日之后发布)
如何设置文件共享权限
包含 VDA 安装程序软件包的网络共享必须对作为本地系统(NT AUTHORITY\SYSTEM 主体)运行的 VDA Upgrade Agent 服务具有读取权限。
-
加入了域的文件共享权限
当 VDA 计算机加入了域时,本地系统帐户(VUA 作为本地系统运行)在访问网络共享时使用计算机凭据。
可以通过向域计算机授予读取权限来设置最低特权权限。
- 在网络中选择要与之共享文件的人。
- 单击 Advanced Sharing Settings(高级共享设置),然后打开 File and Printer Sharing(文件和打印机共享)。
-
未加入域的文件共享权限
当 VDA 计算机未加入域时,本地系统帐户(VUA 作为本地系统运行)在访问网络共享时使用 ANONYMOUS LOGON(匿名登录)。
- 选择共享文件夹。
- 禁用密码保护。
- 转到文件夹 Properties(属性)。
- 选择 Network and Sharing Center(网络和共享中心)。
- 关闭 Password Protected Sharing(密码保护的共享)。
- 单击 Advanced Sharing(高级共享)以授予共享权限。
- 选择 Permissions(权限)。
- 向 ANONYMOUS LOGON(匿名登录)授予 Read(读取)共享权限。
- 选择 Security Tab(“安全”选项卡)以授予文件夹权限
- 单击 Edit(编辑)为共享文件夹添加权限
- 选择共享文件夹,向 ANONYMOUS LOGON(匿名登录)授予文件夹权限。
- 单击 Advanced(高级)打开 File and Printer Sharing(文件和打印机共享)。
- 将共享文件夹名称添加到 Network Access Security Policy(网络访问安全策略)中。
注意:
重新启动您的计算机以使更改立即生效。
来自本地文件共享的 VDA 更新
-
下载 VDA 安装程序并将其放置在共享文件中。
注意:
通过 Virtual Upgrade Service,您可以选择“Current Release”(当前版本)轨道或“LTSR”轨道。
例如: 如果计算机目录设置为“Current Release”(当前版本),即 2311,并且 VDA 版本为 2305,则必须将 VDA 升级到版本 2311。
- 导航到我们的 Web 站点上的下载页面。
- 选择产品 Citrix Virtual Apps and Desktops。
- 选择 Citrix Virtual Apps and Desktops 7 2311, All Editions(Citrix Virtual Apps and Desktops 7 2311,所有版本)。
- 从 Components that are on product ISO but also packaged separately(产品 ISO 上存在的但也可单独打包的组件)中选择 VDA 安装程序。
-
根据目录类型选择相关的 VDA 安装程序。
- 如果目录类型为多会话,请下载多会话操作系统 VDA 安装程序
- 如果目录类型为单会话,请下载单会话操作系统 VDA 安装程序
- 如果目录类型为 Remote PC Access,请下载单会话操作系统核心服务 VDA 安装程序
注意:
文件共享安装程序的版本必须与 VUS 发布到云端的最新安装程序的版本完全匹配。
故障排除
- 对于状态为
Power State Unknown
的计算机,请参阅 CTX131267 了解指导信息。 - 要修复持续显示未知电源状态的 VM,请参阅如何修复持续显示未知电源状态的 VM。
- 如果 Cloud Connector 无法正常运行,MCS 配置操作(例如目录更新)需要比平时更长的时间,并且管理控制台性能会显著下降。
下一步的去向
有关管理特定虚拟机管理程序目录的信息,请参阅:
在本文中
- 简介
- 关于永久实例
- 管理计算机目录
- 使用完整配置界面
- 查看目录详细信息
- 向目录中添加计算机
- 从目录中删除计算机
- 编辑目录
- 重命名目录
- 删除目录
- 管理目录中的 Active Directory 计算机帐户
- 更改目录的主映像
- 更改功能级别或撤消更改
- 克隆目录
- 使用文件夹整理目录
- 为 VDA 配置自动升级
- 管理目录的配置集
- 重试创建目录
- (仅限非 Citrix 预置的 VDA)生成和管理注册令牌
- 使用 PowerShell
- 管理计算机名称的序列号
- 启用一次性重启计划
- 向映像中添加描述
- 重置操作系统磁盘
- 修复活跃计算机帐户的身份信息
- 更改现有计算机目录的网络设置
- 管理计算机目录的版本
- 更改现有计算机目录的缓存配置
- 将基于非计算机配置文件的计算机目录转换为基于计算机配置文件的计算机目录
- 检索与目录关联的警告和错误
- 删除没有虚拟机管理程序访问权限的计算机
- 通过本地文件共享访问支持 VDA 更新(技术预览版)
- 故障排除
- 下一步的去向