创建 Google Cloud Platform 目录
创建计算机目录 介绍了用于创建计算机目录的向导。以下信息涵盖了 Google 云环境特有的详细信息。
注意：
在创建 Google Cloud Platform (GCP) 目录之前，您需要完成与 GCP 的连接创建。请参阅 (/zh-cn/citrix-daas/install-configure/connections/connection-gcp.html)。
准备主 VM 实例和永久性磁盘
提示：
永久性磁盘是 Google Cloud 中虚拟磁盘的术语。
要准备主 VM 实例，请创建并配置一个 VM 实例，其属性应与您计划的计算机目录中克隆的 VDA 实例所需的配置相匹配。此配置不仅适用于实例大小和类型，还包括元数据、标签、GPU 分配、网络标签和服务帐户属性等实例属性。
作为主映像创建过程的一部分，MCS 使用您的主 VM 实例来创建 Google Cloud 实例模板。然后，该实例模板用于创建构成计算机目录的克隆 VDA 实例。克隆实例继承了创建实例模板所用的主 VM 实例的属性（VPC、子网和永久性磁盘属性除外）。
根据您的具体要求配置主 VM 实例的属性后，启动该实例，然后为该实例准备永久性磁盘。
我们建议您手动创建磁盘快照或磁盘映像。这样做可以让您使用有意义的命名约定来跟踪版本，为您提供更多选项来管理主映像的早期版本，并节省计算机目录创建时间。如果您不创建自己的快照，MCS 会为您创建一个临时快照（该快照在预配过程结束时删除）。手动创建操作系统磁盘或映像的多区域快照还可以让您在不同的 GCP 区域中使用相同的主映像来创建计算机目录。
启用区域选择
Citrix DaaS™ 支持区域选择。通过区域选择，您可以指定要创建 VM 的区域。通过区域选择，管理员可以将独占租户节点放置在他们选择的区域中。要配置独占租用，您必须在 Google Cloud 上完成以下操作：
-
预留 Google Cloud 独占租户节点 (#reserve-a-google-cloud-sole-tenant-node)
-
创建 VDA 主映像 (#create-the-vda-master-image)
创建计算机目录
注意：
在创建计算机目录之前，请先创建您的资源。配置计算机目录时，请使用 Google Cloud 建立的命名约定。有关详细信息，请参阅 存储桶和对象命名准则。
您可以通过两种方式创建计算机目录：
-
PowerShell。请参阅 使用远程 PowerShell SDK 管理 Citrix DaaS。有关如何使用 PowerShell 实现特定功能的信息，请参阅 使用 PowerShell
使用 Studio 创建计算机目录
请遵循 (/zh-cn/citrix-daas/install-configure/machine-catalogs-create.html) 中的指导。以下描述是 Google Cloud 目录特有的。
-
在 Studio 中，从左侧窗格中选择计算机目录。
-
在操作栏中选择创建计算机目录。
-
在计算机类型页面上，选择多会话操作系统，然后选择下一步。Citrix DaaS 也支持单会话操作系统。
-
在计算机管理页面上，选择已进行电源管理的计算机和 Citrix Machine Creation Services™ 选项，然后选择下一步。如果有多个资源，请从菜单中选择一个。
-
在映像页面上，根据需要完成这些步骤，然后单击下一步。
-
选择主映像。您可以选择以下映像类型：
-
虚拟机（其区域与所选托管单元相同）。
-
快照（支持多区域快照）。
-
操作系统映像（支持多区域公共和非公共映像）。 如果您想使用独占租户功能，请务必选择节点组属性配置正确的映像。请参阅 (#enable-zone-selection)。
-
-
在选择计算机配置文件页面上，从虚拟机选项卡或实例模板选项卡中选择资源。注意：
-
目前，此目录中的 VM 继承所选计算机配置文件中的存储、计算机类型和磁盘加密设置。
-
如果您选择实例模板作为计算机配置文件，则默认选择所有区域。您可以根据需要选择区域。
-
-
选择目录的最低功能级别。
-
-
在存储页面上，选择用于包含此计算机目录操作系统的存储类型。以下每个存储选项都具有独特的定价和性能特征。身份磁盘始终使用区域标准永久性磁盘创建。
-
标准永久性磁盘
-
平衡永久性磁盘
-
SSD 永久性磁盘
有关 Google Cloud 存储选项的详细信息，请参阅存储选项。 -
-
在虚拟机页面上，指定要创建的 VM 数量，查看 VM 的详细规范，选择 Google Cloud 计算机类型，然后选择下一步。如果将单租户节点组用于计算机目录，请务必仅选择可用预留单租户节点的区域。请参阅启用区域选择。注意：Google Cloud 计算机类型是根据所选计算机配置文件自动选择的。如有必要，您可以选择其他计算机类型。
-
在磁盘设置页面上，您可以配置以下设置：
-
选择是否启用回写式缓存。启用回写式缓存后，您可以执行以下操作：
-
启用 MCS 存储优化 (MCS I/O) 后，您可以执行以下任一操作：
-
选择是否在电源循环期间保留 VDA 的系统磁盘。有关详细信息，请参阅启用 MCS 存储优化更新。
-
更新内存和磁盘缓存大小。
-
-
选择是否使用您自己的密钥来保护磁盘内容。要使用此功能，您必须首先创建自己的客户管理加密密钥 (CMEK)。有关详细信息，请参阅使用客户管理加密密钥 (CMEK)。注意：它仅在 Studio 界面中可用。创建密钥后，您可以从列表中选择其中一个密钥。创建目录后，您无法更改密钥。Google Cloud 不支持轮换现有永久性磁盘或映像上的密钥。因此，预配目录后，该目录将绑定到特定版本的密钥。如果该密钥被禁用或销毁，则使用该密钥加密的实例和磁盘将变得无法使用，直到该密钥重新启用或恢复。客户管理加密密钥 (CMEK) 设置遵循以下优先级顺序：
-
目录的自定义 CMEK 具有最高优先级。
-
如果选定的机器配置文件已加密，CMEK 设置将自动使用机器配置文件的 CMEK 作为下一个优先级。
-
如果选定的机器配置文件未加密，CMEK 设置将自动使用主映像的 CMEK。
-
-
-
在 机器身份 页面上，选择一个 Active Directory 帐户，然后选择 下一步。
-
如果选择 创建新的 Active Directory 帐户，请选择一个域，然后输入表示在 Active Directory 中创建的预配 VM 计算机帐户的命名方案的字符序列。帐户命名方案可以包含 1-64 个字符，不能包含空格、非 ASCII 字符或特殊字符。
-
如果选择 使用现有 Active Directory 帐户，请选择 浏览 以导航到所选机器的现有 Active Directory 计算机帐户。
-
-
在 域凭据 页面上，选择 输入凭据，键入用户名和密码，选择 保存，然后选择 下一步。
-
您键入的凭据必须具有执行 Active Directory 帐户操作的权限。
-
-
在 范围 页面上，为机器目录选择范围，然后选择 下一步。
-
您可以选择可选范围或选择 自定义范围 以根据需要自定义范围。
-
-
在 摘要 页面上，确认信息，为目录指定一个名称，然后选择 完成。注意：目录名称可以包含 1-39 个字符，不能只包含空格或字符
\ / ; : # . * ? = < > | [ ] { } " ' ( ) ' )。
机器目录创建可能需要很长时间才能完成。完成后，将列出该目录。您可以在 Google Cloud 控制台中验证机器是否已在目标节点组中创建。
导入手动创建的 Google Cloud 机器
使用此功能，您可以：
-
将手动创建的 Google Cloud 多会话操作系统计算机导入 Citrix DaaS 目录。
-
从 Citrix DaaS 目录中移除手动创建的 Google Cloud 多会话操作系统计算机。
-
使用现有的 Citrix DaaS 电源管理功能来电源管理 Google Cloud Windows 多会话操作系统计算机。例如，为这些计算机设置重新启动计划。
此功能不需要更改现有的 Citrix DaaS 预配工作流，也不需要移除任何现有功能。
建议您使用 MCS 在 Studio 中预配计算机，而不是导入手动创建的 Google Cloud 计算机。
共享虚拟私有云
共享虚拟私有云 (VPC) 包含一个主机项目（从中提供共享子网）以及一个或多个使用该资源的服务项目。共享 VPC 是大型安装的理想选择，因为它们提供对共享企业 Google 云资源的集中控制、使用和管理。有关详细信息，请参阅 Google 文档站点。
借助此功能，Machine Creation Services (MCS) 支持预配和管理部署到共享 VPC 的计算机目录。此支持在功能上等同于当前在本地 VPC 中提供的支持，但在两个方面有所不同：
有关配置共享 VPC 的信息，请参阅 配置共享 VPC。
所需的新权限
创建主机连接时需要具有特定权限的 Google Cloud 服务帐户。必须将这些额外权限授予用于创建基于共享 VPC 的主机连接的任何服务帐户。
提示：
这些额外权限对于 Citrix DaaS 而言并非新功能。它们用于促进本地 VPC 的实施。对于共享 VPC，这些额外权限允许访问其他共享 VPC 资源。
最多需要向与主机连接关联的服务帐户授予四个额外权限，以支持共享 VPC：
-
compute.firewalls.list - 此权限是强制性的。它允许 MCS 检索共享 VPC 上存在的防火墙规则列表。
-
compute.networks.list - 此权限是强制性的。它允许 MCS 识别服务帐户可用的共享 VPC 网络。
-
compute.subnetworks.list – 此权限是可选的，具体取决于您如何使用 VPC。它允许 MCS 识别可见共享 VPC 中的子网。在使用本地 VPC 时已需要此权限，但它也必须分配给共享 VPC 主机项目。
-
compute.subnetworks.use - 此权限是可选的，具体取决于您如何使用 VPC。在预配的计算机目录中使用子网资源时，此权限是必需的。在使用本地 VPC 时已需要此权限，但它也必须分配给共享 VPC 主机项目。
使用这些权限时，请考虑根据用于创建计算机目录的权限类型，有不同的方法：
-
项目级权限：
-
允许访问主机项目中的所有共享 VPC。
-
要求将权限
compute.subnetworks.list和compute.subnetworks.use分配给服务帐户。
-
-
子网级权限：
-
允许访问共享 VPC 中的特定子网。
-
权限
compute.subnetworks.list和compute.subnetworks.use是子网级分配固有的，因此无需直接分配给服务帐户。
-
选择符合您的组织需求和安全标准的方法。
提示：
有关项目级和子网级权限之间差异的更多信息，请参阅 Service Project Admins。
防火墙规则
在准备计算机目录期间，会准备一个计算机映像，用作目录的主映像系统磁盘。在此过程中，磁盘会临时附加到虚拟机。此虚拟机必须在隔离环境中运行，以防止所有入站和出站网络流量。这通过一对拒绝所有流量的防火墙规则实现；一个用于入站流量，一个用于出站流量。使用 Google Cloud 本地 VPC 时，MCS 会在本地网络中创建此防火墙，并将其应用于用于主映像创建的计算机。主映像创建完成后，防火墙规则将从映像中删除。
我们建议将使用共享 VPC 所需的新权限数量保持在最低限度。共享 VPC 是更高级别的企业资源，通常具有更严格的安全协议。因此，请在主机项目中的共享 VPC 资源上创建一对防火墙规则，一个用于入站，一个用于出站。为它们分配最高优先级。使用以下值将新的目标标记应用于每个规则：
citrix-provisioning-quarantine-firewall
当 MCS 创建或更新计算机目录时，它会搜索包含此目标标记的防火墙规则。然后，它会检查规则的正确性，并将其应用于用于为目录准备主映像的计算机。如果未找到防火墙规则，或者找到了规则但规则或其优先级不正确，则会出现类似以下内容的消息：
"Unable to find valid INGRESS and EGRESS quarantine firewall rules for VPC <name> in project <project>. " Please ensure you have created 'deny all' firewall rules with the network tag ‘citrix-provisioning-quarantine-firewall' and proper priority." "Refer to Citrix Documentation for details."
配置共享 VPC
在 Citrix DaaS Studio 中将共享 VPC 添加为主机连接之前，完成以下步骤以添加您打算预配到的项目中的服务帐户：
创建 IAM 角色
确定角色的访问级别：
-
项目级访问权限，或
-
使用 子网级别访问 的更受限模型。
IAM 角色的项目级别访问。对于项目级别的 IAM 角色，请包含以下权限：
-
compute.firewalls.list
-
compute.networks.list
-
compute.subnetworks.list
-
compute.subnetworks.use
要创建项目级别的 IAM 角色：
-
在 Google Cloud 控制台中，导航到 IAM 和管理 > 角色。
-
在“角色”页面上，选择“创建角色”。
-
在“创建角色”页面上，指定角色名称。选择“添加权限”。
-
在“添加权限”页面上，单独向角色添加权限。要添加权限，请在“筛选表”字段中键入权限名称。选择权限，然后选择“添加”。
-
选择“创建”。
-
子网级别 IAM 角色。此角色在选择“创建角色”后省略了权限
compute.subnetworks.list 和 compute.subnetworks.use 的添加。对于此 IAM 访问级别，必须将权限 compute.firewalls.list 和 compute.networks.list 应用于新角色。
要创建子网级别的 IAM 角色：
-
在 Google Cloud 控制台中，导航到 VPC 网络 > 共享 VPC。“共享 VPC”页面随即显示，其中显示了宿主项目包含的共享 VPC 网络的子网。
-
在 共享 VPC 页面上，选择您要访问的子网。
-
在右上角，选择 添加成员 以添加服务帐户。
-
在 添加成员 页面上，完成以下步骤：
-
在 新成员 字段中，键入您的服务帐户名称，然后从菜单中选择您的服务帐户。
-
选择 选择角色 字段，然后选择 计算网络用户。
-
选择 保存。
-
-
在 Google Cloud 控制台中，导航到 IAM 和管理 > 角色。
-
在 角色 页面上，选择 创建角色。
-
在 创建角色 页面上，指定角色名称。选择 添加权限。
-
在 添加权限 页面上，单独为角色添加权限。要添加权限，请在 筛选表 字段中键入权限名称。选择该权限，然后选择 添加。
-
选择 创建。
-
将服务帐户添加到主机项目 IAM 角色
创建 IAM 角色后，执行以下步骤为主机项目添加服务帐户：
-
在 Google Cloud 控制台中，导航到主机项目，然后导航到 IAM 和管理 > IAM。
-
在 IAM 页面上，选择 添加 以添加服务帐户。
-
在“添加成员”页面上：
-
在“新成员”字段中，键入您的服务帐户名称，然后从菜单中选择您的服务帐户。
-
选择一个角色字段，键入您创建的 IAM 角色，然后从菜单中选择该角色。
-
选择“保存”。
-
服务帐户现已为主机项目配置。
将云构建服务帐户添加到共享 VPC
每个 Google Cloud 订阅都有一个服务帐户，其名称是项目 ID 号，后跟
cloudbuild.gserviceaccount。例如：705794712345@cloudbuild.gserviceaccount。
您可以通过导航到 Google Cloud 控制台中的“Cloud 概览 > 仪表板”来确定项目的项目 ID 号。项目 ID 和项目编号显示在项目仪表板的项目信息卡上：
执行以下步骤将 Cloud Build 服务帐户添加到共享 VPC：
-
在 Google Cloud 控制台中，导航到主机项目，然后导航到“IAM 和管理”>“IAM”。
-
在“权限”页面上，选择“添加”以添加帐户。
-
在“添加成员”页面上，完成以下步骤：
-
在“新成员”字段中，键入 Cloud Build 服务帐户的名称，然后从菜单中选择您的服务帐户。
-
选择“选择角色”字段，键入
Computer Network User，然后从菜单中选择该角色。 -
选择“保存”。
-
创建防火墙规则
作为主映像创建过程的一部分，MCS 会复制选定的计算机映像，并使用它为目录准备主映像系统磁盘。在主映像创建过程中，MCS 会将磁盘附加到临时虚拟机，然后该虚拟机运行准备脚本。此虚拟机必须在禁止所有入站和出站网络流量的隔离环境中运行。
为了创建隔离环境，MCS 需要两条拒绝所有防火墙规则（一条入站规则和一条出站规则）。因此，请在主机项目中创建两条防火墙规则（入站和出站），如下所示：
-
在 Google Cloud 控制台中，导航到主机项目，然后转到 VPC network > Firewall。
-
在 Firewall 页面上，选择 CREATE FIREWALL RULE。
-
在 Create a firewall rule 页面上，完成以下操作：
-
名称。键入规则的名称。
-
网络。选择入站防火墙规则适用的共享 VPC 网络。
-
优先级。值越小，规则的优先级越高。我们建议使用较小的值（例如，10）。
-
流量方向。选择 Ingress。
-
匹配操作。选择 Deny。
-
目标。使用默认值 Specified target tags。
-
目标标记。键入
citrix-provisioning-quarantine-firewall。 -
源筛选器。使用默认值 IP ranges。
-
源 IP 范围。键入与所有流量匹配的范围。键入
0.0.0.0/0。 -
协议和端口。选择拒绝所有。
-
-
选择创建以创建规则。
-
重复这些步骤以创建另一条规则。对于流量方向，选择出站。
使用客户管理的加密密钥 (CMEK)
注意：
GCP 中对 CMEK 的支持目前处于预览阶段。
您可以将客户管理的加密密钥 (CMEK) 用于 MCS 目录。使用此功能时，您需要将 Google Cloud 密钥管理服务
CryptoKey Encrypter/Decrypter 角色分配给 Compute Engine 服务代理。Citrix DaaS 帐户必须在存储密钥的项目中具有正确的权限。请参阅向 Citrix DaaS 帐户分配权限。有关详细信息，请参阅通过使用 Cloud KMS 密钥帮助保护资源。
您的 Compute Engine 服务代理采用以下形式：
service-<Project _Number>@compute-system.iam.gserviceaccount.com。此形式不同于默认的 Compute Engine 服务帐户。
注意：
此 Compute Engine 服务帐户可能不会显示在 Google Console IAM 权限显示中。在这种情况下，请使用
gcloud 命令，如通过使用 Cloud KMS 密钥帮助保护资源 中所述。
向 Citrix DaaS 帐户分配权限
Google Cloud KMS 权限可以通过多种方式配置。您可以提供项目级 KMS 权限或资源级 KMS 权限。有关详细信息，请参阅权限和角色。
项目级 KMS 权限
一种选择是向 Citrix DaaS 帐户提供项目级权限以浏览 Cloud KMS 资源。为此，请创建一个自定义角色，并添加以下权限：
-
cloudkms.keyRings.list -
cloudkms.keyRings.get -
cloudkms.cryptokeys.list -
cloudkms.cryptokeys.get
将此自定义角色分配给您的 Citrix DaaS 帐户。这允许您在清单中浏览相关项目中的区域密钥。
资源级 KMS 权限
对于另一个选项，即资源级权限，在 Google Cloud 控制台中，浏览到您用于 MCS 预配的
cryptoKey。将 Citrix DaaS 帐户添加到您用于目录预配的密钥环或密钥。
提示：
使用此选项，您无法在清单中浏览项目的区域密钥，因为 Citrix DaaS 帐户没有 Cloud KMS 资源的项级列表权限。但是，您仍然可以通过在
ProvScheme 自定义属性中指定正确的 cryptoKeyId 来使用 CMEK 预配目录。请参阅使用自定义属性通过 CMEK 创建目录。
轮换客户管理的密钥
Google Cloud 不支持轮换现有持久性磁盘或映像上的密钥。一旦预配了计算机，它就与创建时使用的密钥版本绑定。但是，可以创建新版本的密钥，并且该新密钥将用于新预配的计算机或在目录使用新主映像更新时创建的资源。
关于密钥环的重要注意事项
密钥环无法重命名或删除。此外，配置它们时可能会产生不可预见的费用。删除或移除密钥环时，Google Cloud 会显示错误消息：
Sorry, you can't delete or rename keys or key rings. We were concerned about the security implications of allowing multiple keys or key versions over time to have the same resource name, so we decided to make names immutable. (And you can't delete them, because we wouldn't be able to do a true deletion--there would still have to be a tombstone tracking that this name had been used and couldn't be reused).
We're aware that this can make things untidy, but we have no immediate plans to change this.
If you want to avoid getting billed for a key or otherwise make it unavailable, you can do so by deleting all the key versions; neither keys nor key rings are billed for, just the active key versions within the keys.
提示：
有关详细信息，请参阅从控制台编辑或删除密钥环。
统一存储桶级访问兼容性
Citrix DaaS 与 Google Cloud 上的统一存储桶级访问控制策略兼容。此功能增强了 IAM 策略的使用，该策略授予服务帐户权限以允许操作资源，包括存储桶。借助统一存储桶级访问控制，Citrix DaaS 允许您使用访问控制列表 (ACL) 来控制对存储桶或其中存储的对象的访问。有关 Google Cloud 统一存储桶级访问的概述信息，请参阅 统一存储桶级访问。有关配置信息，请参阅 要求统一存储桶级访问。
使用 PowerShell
本部分详细介绍了如何使用 PowerShell 执行以下任务：
创建具有持久性回写缓存磁盘的目录
要配置具有持久性回写缓存磁盘的目录，请使用 PowerShell 命令
New-ProvScheme CustomProperties。
提示：
仅将 PowerShell 参数
New-ProvScheme CustomProperties 用于基于云的托管连接。如果要为本地解决方案（例如 XenServer®）使用持久性回写缓存磁盘预配计算机，则不需要 PowerShell，因为磁盘会自动持久化。
此命令支持一个额外的属性
PersistWBC，用于确定 MCS 预配计算机的回写缓存磁盘如何持久保存。PersistWBC 属性仅在指定 UseWriteBackCache 参数且设置 WriteBackCacheDiskSize 参数以指示创建磁盘时使用。
注意：
此行为适用于 Azure 和 GCP，其中默认的 MCSIO 回写缓存磁盘在电源循环时会被删除并重新创建。您可以选择持久保存磁盘，以避免删除和重新创建 MCSIO 回写缓存磁盘。
在支持
PersistWBC 之前，CustomProperties 参数中找到的属性示例包括：
<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Property xsi:type="StringProperty" Name="UseManagedDisks" Value="true" />
<Property xsi:type="StringProperty" Name="StorageAccountType" Value="Premium_LRS" />
<Property xsi:type="StringProperty" Name="ResourceGroups" Value="benvaldev5RG3" />
</CustomProperties>
注意：
此示例仅适用于 Azure。GCP 环境中的属性有所不同。
使用这些属性时，请注意，如果
CustomProperties 参数中省略了这些属性，它们将包含默认值。PersistWBC 属性有两个可能的值：true 或 false。
将
PersistWBC 属性设置为 true 时，当 Citrix DaaS 管理员从管理界面关闭计算机时，不会删除回写缓存磁盘。
将
PersistWBC 属性设置为 false 时，当 Citrix DaaS 管理员从管理界面关闭计算机时，会删除回写缓存磁盘。
注意：
如果省略
PersistWBC 属性，则该属性默认为 false，并且当计算机从管理界面关闭时，回写缓存将被删除。
例如，使用
CustomProperties 参数将 PersistWBC 设置为 true：
<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Property xsi:type="StringProperty" Name="UseManagedDisks" Value="true" />
<Property xsi:type="StringProperty" Name="StorageAccountType" Value="Premium_LRS" />
<Property xsi:type="StringProperty" Name="ResourceGroups" Value="benvaldev5RG3" />
<Property xsi:type="StringProperty" Name="PersistWBC" Value="true" />
</CustomProperties>
重要：
PersistWBC 属性只能使用 New-ProvScheme PowerShell cmdlet 进行设置。在创建后尝试更改预配方案的 CustomProperties 对计算机目录以及计算机关闭时回写缓存磁盘的持久性没有影响。
例如，设置
New-ProvScheme 以使用回写缓存，同时将 PersistWBC 属性设置为 true：
New-ProvScheme
-CleanOnBoot
-CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"><Property xsi:type=`"StringProperty`" Name=`"UseManagedDisks`" Value=`"true`" /><Property xsi:type=`"StringProperty`" Name=`"StorageAccountType`" Value=`"Premium_LRS`" /><Property xsi:type=`"StringProperty`" Name=`"ResourceGroups`" Value=`"benvaldev5RG3`" /><Property xsi:type=`"StringProperty`" Name=`"PersistWBC`" Value=`"true`" /></CustomProperties>"
-HostingUnitName "adSubnetScale1"
-IdentityPoolName "BV-WBC1-CAT1"
-MasterImageVM "XDHyp:\HostingUnits\adSubnetScale1\image.folder\GoldImages.resourcegroup\W10MCSIO-01_OsDisk_1_a940e6f5bab349019d57ccef65d2c7e3.manageddisk"
-NetworkMapping @{"0"="XDHyp:\HostingUnits\adSubnetScale1\\virtualprivatecloud.folder\CloudScale02.resourcegroup\adVNET.virtualprivatecloud\adSubnetScale1.network"}
-ProvisioningSchemeName "BV-WBC1-CAT1"
-ServiceOffering "XDHyp:\HostingUnits\adSubnetScale1\serviceoffering.folder\Standard_D2s_v3.serviceoffering"
-UseWriteBackCache
-WriteBackCacheDiskSize 127
-WriteBackCacheMemorySize 256
使用 MCSIO 提高启动性能
启用 MCSIO 后，可以提高 Azure 和 GCP 托管磁盘的启动性能。使用 PowerShell
PersistOSDisk 自定义属性在 New-ProvScheme 命令中配置此功能。与 New-ProvScheme 相关的选项包括：
<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Property xsi:type="StringProperty" Name="UseManagedDisks" Value="true" />
<Property xsi:type="StringProperty" Name="StorageAccountType" Value="Premium_LRS" />
<Property xsi:type="StringProperty" Name="Resource``````````````Groups" Value="benvaldev5RG3" />
<Property xsi:type="StringProperty" Name="PersistOsDisk" Value="true" />
</CustomProperties>
要启用此功能，请将
PersistOSDisk 自定义属性设置为 true。例如：
New-ProvScheme
-CleanOnBoot
-CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"><Property xsi:type=`"StringProperty`" Name=`"UseManagedDisks`" Value=`"true`" /><Property xsi:type=`"StringProperty`" Name=`"StorageAccountType`" Value=`"Premium_LRS`" /><Property xsi:type=`"StringProperty`" Name=`"ResourceGroups`" Value=`"benvaldev5RG3`" /><Property xsi:type=`"StringProperty`" Name=`"PersistOsDisk`" Value=`"true`" /></CustomProperties>"
-HostingUnitName "adSubnetScale1"
-IdentityPoolName "BV-WBC1-CAT1"
-MasterImageVM "XDHyp:\HostingUnits\adSubnetScale1\image.folder\GoldImages.resourcegroup\W10MCSIO-01_OsDisk_1_a940e6f5bab349019d57ccef65d2c7e3.manageddisk"
-NetworkMapping @{"0"="XDHyp:\HostingUnits\adSubnetScale1\\virtualprivatecloud.folder\CloudScale02.resourcegroup\adVNET.virtualprivatecloud\adSubnetScale1.network"}
-ProvisioningSchemeName "BV-WBC1-CAT1"
-ServiceOffering "XDHyp:\HostingUnits\adSubnetScale1\serviceoffering.folder\Standard_D2s_v3.serviceoffering"
-UseWriteBackCache
-WriteBackCacheDiskSize 127
-WriteBackCacheMemorySize 256
使用自定义属性创建包含 CMEK 的目录
'<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Property xsi:type="StringProperty" Name="CryptoKeyId" Value="<yourCryptoKeyId>" />
</CustomProperties>'
cryptoKeyId 必须按以下格式指定：
projectId:location:keyRingName:cryptoKeyName
例如，如果您想在区域
us-east1 的密钥环 my-example-key-ring 中使用密钥 my-example-key，并且项目 ID 为 my-example-project-1，则您的 ProvScheme 自定义设置将类似于：
'<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Property xsi:type="StringProperty" Name="CryptoKeyId" Value="my-example-project-1:us-east1:my-example-key-ring:my-example-key" />
</CustomProperties>'
与此预配方案相关的所有 MCS 预配磁盘和映像都使用此客户管理的加密密钥。
提示：
如果您使用全局密钥，客户属性位置必须显示
global，而不是 region 名称（在上面的示例中为 us-east1）。例如：<Property xsi:type="StringProperty" Name="CryptoKeyId" Value="my-example-project-1:global:my-example-key-ring:my-example-key" />。
使用计算机配置文件创建计算机目录
使用 Machine Creation Services (MCS) 创建目录以预配计算机时，可以使用计算机配置文件从虚拟机捕获硬件属性，并将其应用于目录中新预配的 VM。如果未使用
MachineProfile 参数，则硬件属性将从主映像 VM 或快照中捕获。 您明确定义的某些属性（例如 StorageType、CatalogZones 和 CryptoKeyId）将从计算机配置文件中忽略。
-
要使用计算机配置文件创建目录，请使用
New-ProvScheme命令。例如，New-ProvScheme –MachineProfile “path to VM”。如果您未指定MachineProfile参数，则硬件属性将从主映像 VM 中捕获。 -
要使用新的计算机配置文件更新目录，请使用
Set-ProvScheme命令。例如，Set-ProvScheme –MachineProfile “path to new VM”。此命令不会更改目录中现有 VM 的计算机配置文件。只有添加到目录中的新创建的 VM 才具有新的计算机配置文件。 -
您也可以更新主映像，但是，当您更新主映像时，硬件属性不会更新。如果要更新硬件属性，需要使用
Set-ProvScheme命令更新计算机配置文件。这些更改仅适用于目录中的新计算机。对于更新现有计算机的硬件属性，可以使用带-StartsNow和-DurationInMinutes -1参数的Set-ProvVMUpdateTimeWindow命令。注意：-
StartsNow表示计划的开始时间是当前时间。 -
带有负数（例如，–1）的
DurationInMinutes表示计划时间窗口没有上限。
-
使用实例模板作为计算机配置文件创建计算机目录
您可以选择 GCP 实例模板作为计算机配置文件的输入。实例模板是 GCP 中的轻量级资源，因此非常经济高效。
使用实例模板作为计算机配置文件创建新的计算机目录
-
打开 PowerShell 窗口。
-
运行
asnp citrix*以加载 Citrix 特定的 PowerShell 模块。 -
使用以下命令在 GCP 项目中查找实例模板：
cd XDHyp:\HostingUnits\<HostingUnitName>\instanceTemplates.folder -
使用 NewProvScheme 命令创建以实例模板作为计算机配置文件的新的计算机目录：
New-ProvScheme -ProvisioningSchemeName <CatalogName> -HostingUnitName <HostingUnitName> -IdentityPoolName <identity pool name> -MasterImageVM
XDHyp:\HostingUnits\<HostingUnitName>\Base.vm\Base.snapshot -MachineProfile XDHyp:\HostingUnits\<HostingUnitName>\instanceTemplates.folder\mytemplate.template有关 New-ProvScheme 命令的更多信息，请参阅<https://developer-docs.citrix.com/projects/citrix-daas-sdk/en/latest/MachineCreation/New-ProvScheme/>。 -
使用 PowerShell 命令完成计算机目录的创建。
更新计算机目录以将实例模板作为计算机配置文件
-
打开 PowerShell 窗口。
-
运行
asnp citrix*以加载 Citrix 特定的 PowerShell 模块。 -
运行以下命令：
Set-ProvScheme -ProvisioningSchemeName <CatalogName> -MachineProfile XDHyp:\HostingUnits\<HostingUnitName>\instanceTemplates.folder\<TemplateName>.template有关 Set-ProvScheme 命令的信息，请参阅<https://developer-docs.citrix.com/projects/citrix-daas-sdk/en/latest/MachineCreation/Set-ProvScheme/>。
创建包含受保护虚拟机的目录
您可以创建具有受保护虚拟机属性的 MCS 计算机目录。受保护虚拟机通过一组安全控制进行强化，这些控制使用高级平台安全功能（如安全启动、虚拟可信平台模块、UEFI 固件和完整性监控）提供可验证的 Compute Engine 实例完整性。
MCS 支持使用计算机配置文件工作流创建目录。如果使用计算机配置文件工作流，则必须启用 VM 实例的受保护虚拟机属性。然后，您可以将此 VM 实例用作计算机配置文件输入。
创建包含受保护虚拟机的 MCS 计算机目录
-
在 Google Cloud 控制台中启用 VM 实例的受保护虚拟机选项。请参阅 快速入门：启用受保护虚拟机选项。
-
使用 VM 实例通过计算机配置文件工作流创建 MCS 计算机目录。
-
打开 PowerShell 窗口
-
运行
asnp citrix*以加载 Citrix 特定的 PowerShell 模块。 -
如果尚未创建身份池，请创建一个。
-
运行
New-ProvScheme命令。例如：New-ProvScheme -ProvisioningSchemeName <catalog-name>
-HostingUnitName gcp-hostint-unit
-MasterImageVM XDHyp:\HostingUnits\gcp-hostint-unit\catalog-vda.vm
-MachineProfile XDHyp:\HostingUnits\gcp-hostint-unit\catalog-machine.vm
-
-
完成计算机目录的创建。
使用新的计算机配置文件更新计算机目录
-
运行
Set-ProvScheme命令。例如：Set-ProvScheme -ProvisioningSchemeName <catalog-name>
-MasterImageVM XDHyp:\HostingUnits\<hostin-unit>\catalog-vda.vm
-MachineProfile "DHyp:\HostingUnits\<hostin-unit>\catalog-machine.vm
要将
Set-ProvScheme 中所做的更改应用于现有 VM，请运行 Set-ProvVMUpdateTimeWindow 命令。
-
运行
Set-ProvVMUpdateTimeWindow命令。例如：Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -VMName <List-Of-Vm-Names> -StartsNow -DurationInMinutes -1 -
重新启动 VM。
在单租户节点上创建 Windows 11 VM
您可以在 GCP 中创建 Windows 11 VM。但是，如果您在主映像上安装 Windows 11，则必须在主映像创建过程中启用 vTPM。此外，您还必须在计算机配置文件源（VM 或实例模板）上启用 vTPM。
在单租户节点上创建 Windows 11 VM 的关键步骤如下：
-
设置 Google Cloud 虚拟化环境。有关信息，请参阅 Google Cloud 环境。
-
安装 VDA。请参阅 安装 VDA。
-
创建与 Google Cloud 环境的连接。有关信息，请参阅 连接到 Google Cloud 环境。
-
创建 Windows 11 自带许可证 (BYOL) 主映像并将映像导入 Google Cloud。请参阅 创建 Windows 11 BYOL 主映像。
-
创建计算机配置文件源：在单租户节点上预配 VM 并启用源计算机配置文件的 vTPM。请参阅 在单租户节点上预配 VM。
-
使用已启用 vTPM 的 Windows 11 计算机配置文件源创建 MCS 计算机目录。计算机配置文件源必须具有与单租户节点中描述的相同的实例类型。请参阅 使用 Windows 11 计算机配置文件源创建 MCS 计算机目录。
创建 Windows 11 BYOL 主映像
有两种选项可以创建 Windows 11 BYOL 主映像并将其导入 Google Cloud：
-
使用 Google Cloud Cloud Build 工具
-
在任何其他虚拟机管理程序上创建主映像
使用 Google Cloud Cloud Build 工具
-
将 Windows 11 ISO、GCP SDK、.NET framework 和 PowerShell 安装程序文件上传到 GCP 存储桶。
-
在云构建
.yaml文件中提供文件位置作为参数。 -
从命令行运行以下 Cloud Build 以构建最终的 Windows 11 映像。GCP 使用 GCP 中的 Daisy 工作流在所选项目中引导并创建主映像，然后将主映像导入 GCP。
gcloud compute instances import INSTANCE-NAME--source-uri=gs://BUCKET/IMAGE-OVF-FILE.ovf --guest-os-features=UEFI_COMPATIBLE --byol --machine-type=MACHINE-TYPE --zone=ZONE注意：将所有大写字母文本替换为实际的资源详细信息。
有关完整信息，请参阅创建自定义 Windows BYOL 映像。
在任何其他虚拟机管理程序上创建主映像
-
使用任何其他虚拟机管理程序创建 Windows 11 主映像。
-
将主映像以 OVF 格式导出到本地计算机。
-
使用本地 gcloud CLI 将 OVF 文件上传到 GCP 存储桶。
gsutil cp LOCAL_IMAGE_PATH_OVF_FILES gs://BUCKET_NAME/ -
从命令行运行以下 Cloud Build 以构建最终的 Windows 11 映像。GCP 使用 GCP 中的 Daisy 工作流在所选项目中引导并创建主映像，然后将主映像导入 GCP。
gcloud compute instances import INSTANCE-NAME --source-uri=gs://BUCKET/IMAGE-OVF-FILE.ovf --guest-os-features=UEFI_COMPATIBLE --byol --machine-type=MACHINE-TYPE --zone=ZONE注意：将所有大写字母文本替换为实际的资源详细信息。
在单租户节点上预配 VM
使用单租户节点可使您的 VM 与其他项目中的 VM 物理隔离，或将您的 VM 分组到同一主机硬件上。有关单租户节点的信息，请参阅 GCP 文档 单租户概述。
有关在单租户节点上预配 VM（计算机配置文件源）的信息，请参阅 GCP 文档 在单租户节点上预配 VM。
注意：
-
选择与节点组相同的实例类型和区域。
-
在“受保护的 VM”部分中启用 vTPM。有关详细信息，请参阅 快速入门：启用受保护的 VM 选项。
-
禁用源 VM 上的 Bitlocker。
使用 Windows 11 计算机配置文件源创建 MCS 计算机目录
您可以使用 Studio 或 PowerShell 命令创建 MCS 计算机目录以创建 Windows 11 VM。
注意：
-
对于主映像，选择 Windows 11 快照或 VM。
-
对于计算机配置文件源，选择 Windows 11 VM 作为计算机配置文件。计算机配置文件源必须具有与单租户节点中描述的相同的实例类型。
有关使用 Studio 的信息，请参阅 使用 Studio 创建计算机目录。
有关 PowerShell 命令的信息，请参阅 使用计算机配置文件创建计算机目录。
创建目录并启动虚拟机后，您可以在 Google Cloud 控制台上看到在独占租户节点上运行的 Windows 11 虚拟机。
具有继承标签的虚拟机和磁盘
MCS 计算机目录虚拟机和磁盘（身份磁盘、回写缓存磁盘和操作系统磁盘）可以继承计算机配置文件源（GCP 虚拟机实例或实例模板）的标签。您可以使用这些标签来区分不同团队拥有的实例（例如，team:research 和 team:analytics），并进一步将其用于成本核算或预算。有关标签的更多信息，请参阅 GCP 文档 使用标签组织资源。
您可以使用计算机配置文件源创建新目录、更新现有目录以及更新现有虚拟机以继承标签。
此功能适用于持久性和非持久性 MCS 计算机目录。
您可以执行以下操作：
创建具有继承标签的目录
要创建 MCS 计算机目录，其中虚拟机和磁盘从计算机配置文件源继承标签，请执行以下操作：
-
创建带有标签的计算机配置文件源（虚拟机实例或实例模板）。有关创建带有标签的虚拟机的信息，请参阅 GCP 文档 使用标签创建资源。实例模板是从虚拟机创建的，并采用虚拟机中定义的标签。
-
使用 Studio 或 PowerShell 命令创建 MCS 目录。
-
如果使用 Studio，在映像页面上，选择使用计算机配置文件，然后选择 VM 或模板。
-
如果使用 PowerShell 命令，请执行以下操作：
-
打开 PowerShell 窗口。
-
运行 asnp citrix*。
-
创建身份池。身份池是用于存储要创建的 VM 的 Active Directory (AD) 帐户的容器。
-
在 Active Directory 中创建所需的 AD 计算机帐户。
-
运行
New-ProvScheme命令以创建目录。例如：New-ProvScheme，其中模板作为计算机配置文件输入（持久目录）：New-ProvScheme `
-ProvisioningSchemeName "catalog-name" `
-HostingUnitUid "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" `
-IdentityPoolUid "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" `
-MasterImageVM "XDHyp:\HostingUnits\hosting-unit-name\vm-name.vm" `
-MachineProfile "XDHyp:\HostingUnits\hosting-unit-name\instanceTemplates.folder\instance-template-name.template" `New-ProvScheme，其中实例模板作为计算机配置文件输入（非持久目录）：New-ProvScheme `
-ProvisioningSchemeName "catalog-name" `
-HostingUnitUid "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" `
-IdentityPoolUid "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" `
-MasterImageVM "XDHyp:\HostingUnits\hosting-unit-name\vm-name.vm" `
-MachineProfile "XDHyp:\HostingUnits\hosting-unit-name\instanceTemplates.folder\instance-template-name.template" `
-CleanOnBootNew-ProvScheme，其中 VM 实例作为计算机配置文件输入（持久目录）：New-ProvScheme `
-ProvisioningSchemeName "catalog-name" `
-HostingUnitUid "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" `
-IdentityPoolUid "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" `
-MasterImageVM "XDHyp:\HostingUnits\hosting-unit-name\vm-name.vm" `
-MachineProfile "XDHyp:\HostingUnits\hosting-unit-name\vm-name.vm" `New-ProvScheme，其中 VM 实例作为计算机配置文件输入（非持久目录）：New-ProvScheme `
-ProvisioningSchemeName "catalog-name" `
-HostingUnitUid "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" `
-IdentityPoolUid "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" `
-MasterImageVM "XDHyp:\HostingUnits\hosting-unit-name\vm-name.vm" `
-MachineProfile "XDHyp:\HostingUnits\hosting-unit-name\vm-name.vm" `
-CleanOnBoot -
将预配方案注册为代理目录。
-
将 VM 添加到目录。
-
使用继承的标签更新现有目录
要更新现有目录以使其具有新的计算机配置文件，请运行 Set-ProvScheme 命令。运行该命令后，添加到目录中的所有新 VM 都将具有新计算机配置文件源的标签。非持久目录将在下次开机时更新。
例如：
将实例模板作为计算机配置文件输入的 Set-ProvScheme：
Set-ProvScheme `
-ProvisioningSchemeName "catalog-name" `
-MachineProfile "XDHyp:\HostingUnits\hosting-unit-name\instanceTemplates.folder\instance-template-name.template" `
将 VM 实例作为计算机配置文件输入的 Set-ProvScheme：
Set-ProvScheme `
-ProvisioningSchemeName "catalog-name" `
-MachineProfile "XDHyp:\HostingUnits\hosting-unit-name\vm-name.vm" `
使用继承的标签更新现有 VM
要使用更新的计算机配置文件源更新现有 VM，请运行以下命令：
-
Set-ProvScheme -
Set-ProvVMUpdateTimeWindow。例如：Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -VMName <List-Of-Vm-Names> -StartsNow -DurationInMinutes -1 -
重新启动 VM。
检索 VM 和启动磁盘标签的信息
创建 VM 后，您可以使用带
AdditionalData 参数的 Get-Item 命令获取 VM 和启动磁盘标签的信息。
要检索 VM 标签的信息，请运行以下命令：
(Get-Item XDHyp:\HostingUnits\hosting-unit-name\vm_name.vm).AdditionalData.Tags
要检索启动磁盘标签的信息，请运行以下命令：
(Get-Item XDHyp:\HostingUnits\hosting-unit-name\vm_name.vm\bootdisk-name.attacheddisk).AdditionalData.Tags
注意：
为了保持各个虚拟机管理程序之间的一致性，我们使用术语“标签”来显示 GCP 标签。
删除 VM
您可以选择从目录中移除虚拟机，但不会从 GCP 中删除该虚拟机。在这种情况下，仅从虚拟机中移除 Citrix 标签。所有其他添加的标签都不会从虚拟机中删除。您可以从 Studio 中移除虚拟机，也可以使用 PowerShell 命令。
使用 Studio
-
选择并右键单击虚拟机。
-
单击删除。
-
选择从目录中移除虚拟机，但不要删除虚拟机。
使用 PowerShell 命令
Google Cloud 应用商店
您可以浏览并选择 Citrix 在 Google Cloud Marketplace 上提供的映像来创建计算机目录。目前，MCS 仅支持此功能的计算机配置文件工作流。
要通过 Google Cloud Marketplace 搜索 Citrix VDA VM 产品，请转至
<https://console.cloud.google.com/marketplace/>。
您可以使用 Google Cloud Marketplace 上的自定义映像或 Citrix ready® 映像来更新计算机目录的映像。
注意：
如果计算机配置文件不包含存储类型信息，则该值将从自定义属性中派生。
支持的 Google Cloud Marketplace 映像包括：
-
Windows 2019 单会话
-
Windows 2019 多会话
-
乌班图
使用 Citrix 准备好的映像作为创建计算机目录的源的示例：
New-ProvScheme -ProvisioningSchemeName GCPCatalog \
-HostingUnitName GcpHu -IdentityPoolName gcpPool -CleanOnBoot \
-MasterImageVM XDHyp:\HostingUnits\GcpHu\images.folder\citrix-daas-win2019-single-vda-v20220819.publicimage \
-MachineProfile XDHyp:\HostingUnits\GcpHu\Base.vm
后续步骤
-
如果这是创建的第一个目录，系统将引导您创建交付组。
-
要查看整个配置过程，请参阅规划和构建部署。
-
要管理目录，请参阅管理计算机目录和管理 Google Cloud Platform 目录。