创建 微软 Azure 目录
注意：
Since July 2023, Microsoft has renamed Azure Active Directory (Azure AD) to Microsoft Entra ID. In this document, any reference to Azure Active Directory, Azure AD, or AAD now refers to Microsoft Entra ID.
创建计算机目录 介绍了用于创建计算机目录的向导。以下信息涵盖了 Microsoft Azure Resource Manager 云环境特有的详细信息。
注意：
在创建微软 Azure 目录之前，您需要先完成与微软 Azure 的连接创建。请参阅 连接到微软 Azure。
创建计算机目录
您可以通过两种方式创建计算机目录：
在 Web Studio 中使用 Azure 资源管理器映像创建计算机目录
映像可以是磁盘、快照或 Azure Compute Gallery 中映像定义的映像版本，用于在计算机目录中创建 VM。在创建计算机目录之前，请在 Azure Resource Manager 中创建映像。有关映像的常规信息，请参阅 创建计算机目录。
注意：
不再支持使用与主机连接中配置的区域不同的主映像。请使用 Azure Compute Gallery 将主映像复制到所需区域。
创建 MCS 计算机目录时，会基于原始 VM 创建一个临时 VM，以执行准备任务，例如启用 DHCP 和许可证重新武装。此临时 VM 称为准备 VM。此准备 VM 的名称遵循 Preparati-84x9n 格式，其中最后五个字符是随机生成的，以避免重复。此准备 VM 的命名约定是固定的，无法自定义。准备任务完成后，准备 VM 将被销毁。
为了断开准备 VM 的网络连接，会创建一个网络安全组以拒绝所有入站和出站流量。每个目录会自动创建一次网络安全组。网络安全组的名称为 Citrix-Deny-All-a3pgu-GUID，其中 GUID 是随机生成的。例如，Citrix-Deny-All-a3pgu-3f161981-28e2-4223-b797-88b04d336dd1。
在计算机目录创建向导中：
-
计算机类型和计算机管理页面不包含 Azure 特定的信息。请遵循 创建计算机目录 文章中的指导。
-
在映像页面上，选择要用作在此目录中创建计算机的模板的映像。
如果选择主映像作为要使用的映像类型，请单击选择映像并按照以下步骤根据需要选择主映像：
- （仅适用于配置了租户内或跨租户共享映像的连接）选择一个订阅，映像驻留于其中。
- 选择资源组。
- 导航到 Azure VHD、Azure 计算库或 Azure 映像版本。如果需要，为所选映像添加备注。
选择映像时，请考虑以下事项：
- 验证映像上是否安装了 Citrix VDA。
- 如果选择附加到 VM 的 VHD，则必须在继续执行下一步之前关闭 VM。
注意：
- 目录中创建计算机的连接（主机）对应的订阅用绿点表示。其他订阅是与该订阅共享 Azure 计算库的订阅。在这些订阅中，仅显示共享库。有关如何配置共享订阅的信息，请参阅 在租户内（跨订阅）共享映像 和 跨租户共享映像。
- 当您选择启用了 Trusted Launch 的映像或快照时，强制要求使用将 Trusted Launch 作为安全类型的计算机配置文件。然后，您可以通过在计算机配置文件中指定 SecureBoot 和 vTPM 的值来启用或禁用它们。共享映像库不支持 Trusted Launch。有关 Azure Trusted Launch 的信息，请参阅 https://docs.microsoft.com/zh-cn/azure/virtual-machines/trusted-launch。
- 您可以使用 Windows 上的临时 OS 磁盘和 Trusted Launch 创建预配方案。当您选择具有 Trusted Launch 的映像时，必须选择启用了 vTPM 的 Trusted Launch 计算机配置文件。要使用临时 OS 磁盘创建计算机目录，请参阅 如何使用临时 OS 磁盘创建计算机。
- 映像复制正在进行时，您可以继续选择该映像作为主映像并完成设置。但是，在映像复制期间，目录创建可能需要更长时间才能完成。MCS 要求复制在目录创建开始后一小时内完成。如果复制超时，目录创建将失败。您可以在 Azure 中验证复制状态。如果复制仍在进行中或复制完成后，请重试。
- 在 Azure 中为计算机目录选择主映像时，MCS 会根据您选择的主映像和计算机配置文件识别操作系统类型。如果 MCS 无法识别，请选择与主映像匹配的操作系统类型。
- 您可以使用 Gen2 映像预配 Gen2 VM 目录，以提高启动时间性能。但是，不支持使用 Gen1 映像创建 Gen2 计算机目录。同样，也不支持使用 Gen2 映像创建 Gen1 计算机目录。此外，任何没有代信息的旧映像都是 Gen1 映像。
如果您选择 Prepared image 作为要使用的映像类型，请单击 Select an image 并根据需要选择一个准备好的映像。
为确保成功创建 VM，请验证映像是否已安装 Citrix VDA 2311 或更高版本，并且 VDA 上存在 MCSIO。
选择映像后，Use a machine profile (mandatory for Azure Active Directory) 复选框会自动选中。单击 Select a machine profile 可从资源组列表中浏览到 VM 或 ARM 模板规范。目录中的 VM 可以从选定的计算机配置文件继承配置。
验证 ARM 模板规范，以确保其可用作计算机配置文件来创建计算机目录。验证 ARM 模板规范有两种方法：
- 从资源组列表中选择 ARM 模板规范后，单击 Next。如果 ARM 模板规范存在错误，则会显示错误消息。
- 运行以下 PowerShell 命令之一：
Test-ProvInventoryItem -HostingUnitName <string> -InventoryPath <string>Test-ProvInventoryItem -HostingUnitUid <Guid> -InventoryPath <string>
VM 可以从计算机配置文件继承的配置示例包括：
- 加速网络功能
- 启动诊断
- 主机磁盘缓存（与操作系统和 MCSIO 磁盘相关）
- 计算机大小（除非另有说明）
- 放置在 VM 上的标签
创建目录后，您可以查看映像从计算机配置文件继承的配置。在计算机目录节点上，选择目录以在下部窗格中查看其详细信息。然后，单击模板属性选项卡以查看计算机配置文件属性。标签部分最多显示三个标签。要查看放置在 VM 上的所有标签，请单击查看所有。
如果您希望 MCS 在 Azure 专用主机上预配 VM，请启用使用专用主机组复选框，然后从列表中选择一个主机组。主机组是表示专用主机集合的资源。专用主机是一种服务，提供托管一个或多个 VM 的物理服务器。您的服务器专用于您的 Azure 订阅，不与其他订阅者共享。当您使用专用主机时，Azure 可确保您的 VM 是在该主机上运行的唯一计算机。此功能适用于必须满足法规或内部安全要求的场景。要了解有关主机组及其使用注意事项的更多信息，请参阅Azure 专用主机。
重要提示：
- 仅显示启用了 Azure 自动放置的主机组。
- 使用主机组会更改向导后面提供的虚拟机页面。该页面上仅显示所选主机组包含的计算机大小。此外，可用性区域会自动选择，并且不可供选择。
-
存储和许可证类型页面仅在使用 Azure Resource Manager 映像时显示。
您可以为计算机目录使用以下存储类型：
- 高级 SSD。提供高性能、低延迟的磁盘存储选项，适用于 I/O 密集型工作负载的 VM。
- 标准 SSD。提供经济高效的存储选项，适用于需要较低 IOPS 级别下一致性能的工作负载。
- 标准 HDD。提供可靠、低成本的磁盘存储选项，适用于运行对延迟不敏感的工作负载的 VM。
-
Azure 临时 OS 磁盘。提供经济高效的存储选项，可重复使用 VM 的本地磁盘来托管操作系统磁盘。或者，您可以使用 PowerShell 创建使用临时 OS 磁盘的计算机。有关详细信息，请参阅Azure 临时磁盘。使用临时 OS 磁盘时，请注意以下事项：
- Azure 临时 OS 磁盘和 MCS I/O 不能同时启用。
- 要更新使用临时 OS 磁盘的计算机，必须选择其大小不超过 VM 缓存磁盘或临时磁盘大小的映像。
- 您不能使用向导后面提供的在电源循环期间保留 VM 和系统磁盘选项。
注意：
无论您选择哪种存储类型，身份磁盘始终使用标准 SSD 创建。
存储类型决定了向导的虚拟机页面上提供的计算机大小。MCS 将高级磁盘和标准磁盘配置为使用本地冗余存储 (LRS)。LRS 在单个数据中心内创建磁盘数据的多个同步副本。Azure 临时 OS 磁盘使用 VM 的本地磁盘来存储操作系统。有关 Azure 存储类型和存储复制的详细信息，请参阅以下内容：
- https://docs.microsoft.com/zh-cn/azure/storage/common/storage-introduction/
- https://docs.microsoft.com/zh-cn/azure/virtual-machines/premium-storage-performance/
- https://docs.microsoft.com/zh-cn/azure/storage/common/storage-redundancy/
选择是使用现有 Windows 许可证还是 Linux 许可证。
-
Windows 许可证：将 Windows 许可证与 Windows 映像（Azure 平台支持映像或自定义映像）结合使用，可让您以更低的成本在 Azure 中运行 Windows VM。许可证有两种类型：
-
Windows Server 许可证。允许您使用 Windows Server 或 Azure Windows Server 许可证，从而可以使用 Azure 混合权益。有关详细信息，请参阅 https://azure.microsoft.com/zh-cn/pricing/hybrid-benefit/。Azure 混合权益将 Azure 中运行 VM 的成本降低到基本计算费率，免除 Azure 库中额外 Windows Server 许可证的费用。
-
Windows 客户端许可证。允许您将 Windows 10 和 Windows 11 许可证带到 Azure，从而可以在 Azure 中运行 Windows 10 和 Windows 11 VM，而无需额外许可证。有关详细信息，请参阅 客户端访问许可证和管理许可证。
-
您可以通过运行以下 PowerShell 命令来验证预配的 VM 是否正在使用许可权益：
Get-AzVM -ResourceGroup MyResourceGroup -Name MyVM。-
对于 Windows Server 许可证类型，请验证许可证类型是否为 Windows_Server。更多说明可在 https://docs.microsoft.com/zh-cn/azure/virtual-machines/windows/hybrid-use-benefit-licensing/ 处找到。
-
对于 Windows 客户端许可证类型，请验证许可证类型是否为 Windows_Client。更多说明可在 https://docs.microsoft.com/zh-cn/azure/virtual-machines/windows/windows-desktop-multitenant-hosting-deployment/ 处找到。
此外，您还可以使用
Get-ProvschemePowerShell SDK 进行验证。例如：Get-Provscheme -ProvisioningSchemeName "My Azure Catalog"。有关此 cmdlet 的更多信息，请参阅 https://developer-docs.citrix.com/projects/citrix-virtual-apps-desktops-sdk/en/latest/MachineCreation/Get-ProvScheme/。-
Linux 许可证：使用自带订阅 (BYOS) Linux 许可证，您无需支付软件费用。BYOS 费用仅包含计算硬件费用。许可证有两种类型：
- RHEL_BYOS：要成功使用 RHEL_BYOS 类型，请在您的 Azure 订阅上启用红帽云访问。
- SLES_BYOS：SLES 的 BYOS 版本中包含了来自 SUSE 公司的官方支持。
您可以在
New-ProvScheme和Set-ProvScheme处将 LicenseType 值设置为 Linux 选项。Example of setting LicenseType to RHEL_BYOS at
New-ProvScheme:New-ProvScheme -CleanOnBoot -ProvisioningSchemeName "azureCatalog" -RunAsynchronously -Scope @() -SecurityGroup @() -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="StandardSSD_LRS" /><Property xsi:type="StringProperty" Name="ResourceGroups" Value="hu-dev-mcs" /><Property xsi:type="StringProperty" Name="OsType" Value="Linux" /><Property xsi:type="StringProperty" Name="LicenseType" Value="RHEL_BYOS" /></CustomProperties>' <!--NeedCopy-->Example of setting LicenseType to SLES_BYOS at
Set-ProvScheme:Set-ProvScheme -ProvisioningSchemeName "azureCatalog" -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="StandardSSD_LRS" /><Property xsi:type="StringProperty" Name="ResourceGroups" Value="hu-dev-mcs" /><Property xsi:type="StringProperty" Name="OsType" Value="Linux" /><Property xsi:type="StringProperty" Name="LicenseType" Value="SLES_BYOS" /></CustomProperties>' <!--NeedCopy-->注意：
如果
LicenseType的值为空，则默认值将是 Azure Windows Server 许可证或 Azure Linux 许可证，具体取决于 OsType 的值。将 LicenseType 设置为空的示例：
Set-ProvScheme -ProvisioningSchemeName "azureCatalog" -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="StandardSSD_LRS" /><Property xsi:type="StringProperty" Name="ResourceGroups" Value="hu-dev-mcs" /><Property xsi:type="StringProperty" Name="OsType" Value="Linux" /></CustomProperties>' <!--NeedCopy-->
请参阅以下文档以了解许可证类型及其优势：
Azure 计算库（以前称为 Azure 共享映像库）是用于管理和共享映像的存储库。它允许您在整个组织中提供映像。我们建议您在创建大型非持久性计算机目录时将映像存储在 SIG 中，因为这样做可以更快地重置 VDA 操作系统磁盘。选择将准备好的映像放置在 Azure 计算库中后，将显示Azure 计算库设置部分，允许您指定更多 Azure 计算库设置：
-
虚拟机与映像副本的比率。允许您指定 Azure 要保留的虚拟机与映像副本的比率。默认情况下，Azure 为每 40 台非持久性计算机保留一个映像副本。对于持久性计算机，该数字默认为 1,000。
-
最大副本数。允许您指定 Azure 要保留的最大映像副本数。默认值为 100。
注意：
ACG 中会创建一个库来存储映像。此库仅供 MCS 用于创建 VM，并且不会显示在“选择映像”页面上。
-
在“虚拟机”页面上，指示要创建的 VM 数量。您必须至少指定一个并选择一个计算机大小。创建目录后，您可以通过编辑目录来更改计算机大小。
-
“网卡”页面不包含 Azure 特定的信息。请遵循 创建计算机目录 一文中的指导。
-
在“磁盘设置”页面上，选择是否启用回写缓存。启用 MCS 存储优化功能后，您可以在创建目录时配置以下设置。这些设置适用于 Azure 和 GCP 环境。
启用回写缓存后，您可以执行以下操作：
-
配置用于缓存临时数据的磁盘和 RAM 大小。有关详细信息，请参阅 配置临时数据缓存。
-
请为回写缓存磁盘选择合适的存储类型。针对回写缓存磁盘，系统提供了以下存储选项供您选择：
- 高级 SSD
- 标准 SSD
- 标准 HDD
-
选择是否希望回写缓存磁盘对预配的 VM 持久化。选择“启用回写缓存”以使选项可用。默认情况下，选择“使用非持久性回写缓存磁盘”。
-
选择回写缓存磁盘的类型。
- 使用非持久性回写缓存磁盘。如果选中，回写缓存磁盘将在电源循环期间删除。重定向到它的任何数据都将丢失。如果 VM 的临时磁盘有足够的空间，它将用于托管回写缓存磁盘以降低您的成本。目录创建后，您可以检查预配的计算机是否使用临时磁盘。为此，请单击目录并验证“模板属性”选项卡上的信息。如果使用临时磁盘，您将看到“非持久性回写缓存磁盘”，其值为“是（使用 VM 的临时磁盘）”。否则，您将看到“非持久性回写缓存磁盘”，其值为“否（不使用 VM 的临时磁盘）”。
- 使用持久性回写缓存磁盘。如果选中，回写缓存磁盘将为预配的 VM 持久保留。启用此选项会增加您的存储成本。
-
选择是否在电源循环期间保留 VDA 的 VM 和系统磁盘。
在电源循环期间保留 VM 和系统磁盘。当您选择“启用回写缓存”时可用。默认情况下，VM 和系统磁盘在关机时删除，并在启动时重新创建。如果您想缩短 VM 重启时间，请选择此选项。请记住，启用此选项也会增加存储成本。
-
选择是否启用“存储成本节省”。如果启用，当 VM 关闭时，通过将存储磁盘降级到标准 HDD 来节省存储成本。VM 在重新启动时会切换回其原始设置。此选项适用于存储磁盘和回写缓存磁盘。或者，您也可以使用 PowerShell。请参阅在 VM 关闭时将存储类型更改为较低层。
注意：
Microsoft 对 VM 关闭期间更改存储类型施加了限制。Microsoft 未来也可能会阻止存储类型更改。有关详细信息，请参阅此Microsoft 文章。
-
选择是否加密此目录中计算机上的数据以及使用哪个加密密钥。使用客户管理的密钥 (CMK) 进行服务器端加密允许您在托管磁盘级别管理加密并保护目录中计算机上的数据。默认设置继承自计算机配置文件或主映像，其中配置文件具有优先权：
- 如果您正在使用带有 CMK 的计算机配置文件，则“使用以下密钥加密每台计算机上的数据”选项将自动选中，并默认为计算机配置文件中的密钥。
- 如果您正在使用带有平台管理密钥 (PMK) 的计算机配置文件，并且主映像是 CMK 加密的，则“使用以下密钥加密每台计算机上的数据”选项将自动选中，并默认为主映像中的密钥。
- 如果您未使用计算机配置文件，并且主映像是 CMK 加密的，则“使用以下密钥加密每台计算机上的数据”选项将自动选中，并默认为主映像中的密钥。
有关详细信息，请参阅 Azure 服务器端加密。
-
-
在“资源组”页面上，选择是创建资源组还是使用现有组。
- 如果您选择创建资源组，请选择“下一步”。
- 如果您选择使用现有资源组，请从“可用预配资源组”列表中选择组。请记住：选择足够的组以容纳您在目录中创建的计算机。如果您选择的组太少，将显示一条消息。如果您计划稍后向目录添加更多 VM，您可能需要选择多于最低要求的组。目录创建后，您无法向目录添加更多资源组。
有关详细信息，请参阅 Azure 资源组。
-
在计算机身份页面上，选择一种身份类型并配置此目录中计算机的身份。如果将 VM 选为 Azure Active Directory 已加入，则可以将其添加到 Azure AD 安全组。详细步骤如下：
- 在身份类型字段中，选择Azure Active Directory 已加入。此时将显示Azure AD 安全组（可选）选项。
- 单击Azure AD 安全组: 创建新组。
- 输入组名称，然后单击创建。
- 按照屏幕上的说明登录 Azure。 如果组名称在 Azure 中不存在，则会显示一个绿色图标。否则，将显示一条错误消息，要求您输入新名称。
- 输入 VM 的计算机帐户命名方案。
目录创建后，Citrix Virtual Apps and Desktops™ 将代表您访问 Azure，并为该组创建安全组和动态成员资格规则。根据该规则，具有此目录中指定的命名方案的 VM 将自动添加到安全组。
将具有不同命名方案的 VM 添加到此目录需要您登录 Azure。然后，Citrix Virtual Apps and Desktops 可以访问 Azure 并根据新的命名方案创建动态成员资格规则。
删除此目录时，从 Azure 删除安全组也需要登录 Azure。
-
域凭据和摘要页面不包含 Azure 特定的信息。请遵循 创建计算机目录 一文中的指导。
完成向导。
Azure 临时磁盘符合回写缓存磁盘条件的条件
仅当满足以下所有条件时，才能将 Azure 临时磁盘用作回写缓存磁盘：
-
回写缓存磁盘必须是非持久性的，因为 Azure 临时磁盘不适用于持久性数据。
-
所选的 Azure VM 大小必须包含临时磁盘。
-
不需要启用临时 OS 磁盘。
-
接受将回写缓存文件放置在 Azure 临时磁盘上。
-
Azure 临时磁盘大小必须大于（回写缓存磁盘大小 + 分页文件保留空间 + 1 GB 缓冲区空间）的总和。
非持久性回写缓存磁盘方案
下表描述了在创建计算机目录时，将临时磁盘用于回写缓存的三种不同方案。
| 方案 | 结果 |
|---|---|
| 满足将临时磁盘用于回写缓存的所有条件。 | WBC 文件 mcsdif.vhdx 放置在临时磁盘上。 |
| 临时磁盘没有足够的空间用于回写缓存。 | 创建了一个 VHD 磁盘 MCSWCDisk，WBC 文件 mcsdif.vhdx 放置在此磁盘上。 |
临时磁盘有足够的空间用于回写缓存，但 UseTempDiskForWBC 设置为 false。 |
创建了一个 VHD 磁盘 MCSWCDisk，WBC 文件 mcsdif.vhdx 放置在此磁盘上。 |
创建 Azure 模板规范
您可以在 Azure 门户中创建 Azure 模板规范，并在 Web Studio 和 PowerShell 命令中使用它来创建或更新 MCS 计算机目录。
为现有 VM 创建 Azure 模板规范：
- 转到 Azure 门户。选择一个资源组，然后选择 VM 和网络接口。从顶部的 … 菜单中，单击 导出模板。
-
如果要为目录预配创建模板规范，请清除 包括参数 复选框。在 JSON 文件中验证
parameters和variables部分是否为："parameters": {}, "variables": {} <!--NeedCopy--> - 单击 下载 将模板保存为 JSON 文件。
- 在 Azure 门户上，选择 模板规范，然后单击 导入模板。
- 浏览并导入保存在计算机上的计算机配置文件（JSON 格式）。
- 提供 名称、订阅、资源组、位置 和 版本。单击 下一步: 编辑模板。
- 创建 审阅+创建 并创建模板规范。
- 在 模板规范 页面上，验证您刚刚创建的模板规范。单击该模板规范。在左侧面板中，单击 版本。
- 您可以通过单击 创建新版本 来创建新版本。指定新的版本号，更改为当前模板规范，然后单击 审阅 + 创建 以创建模板规范的新版本。
您可以使用以下 PowerShell 命令获取有关模板规范和模板版本的信息：
-
要获取有关模板规范的信息，请运行：
get-item XDHyp:\HostingUnits\East\machineprofile.folder\abc.resourcegroup\bggTemplateSpec.templatespec <!--NeedCopy--> -
要获取有关模板规范版本的信息，请运行：
get-item XDHyp:\HostingUnits\East\machineprofile.folder\abc.resourcegroup\bggTemplateSpec.templatespec\bgg1.0.templatespecversion <!--NeedCopy-->
在创建或更新目录时使用模板规范
您可以使用模板规范作为计算机配置文件输入来创建或更新 MCS 计算机目录。为此，您可以使用 Web Studio 或 PowerShell 命令。
- 对于 Web Studio，请参阅在 Web Studio 中使用 Azure 资源管理器映像创建计算机目录
- 对于 PowerShell，请参阅使用 PowerShell 创建或更新目录时使用模板规范
Azure 服务器端加密
Citrix Virtual Apps and Desktops 通过 Azure Key Vault 支持 Azure 托管磁盘的客户管理加密密钥。通过此支持，您可以使用自己的加密密钥加密计算机目录的托管磁盘，从而管理您的组织和合规性要求。有关详细信息，请参阅Azure 磁盘存储的服务器端加密。
将此功能用于托管磁盘时：
-
要更改磁盘加密所用的密钥，请在
DiskEncryptionSet中更改当前密钥。与该DiskEncryptionSet关联的所有资源都将更改为使用新密钥进行加密。 -
当您禁用或删除密钥时，任何使用该密钥的磁盘的 VM 都会自动关闭。关闭后，除非重新启用密钥或分配新密钥，否则 VM 将无法使用。任何使用该密钥的目录都无法开机，并且您无法向其中添加 VM。
使用客户管理加密密钥时的重要注意事项
使用此功能时，请考虑以下事项：
- 与客户管理密钥相关的所有资源（Azure Key Vault、磁盘加密集、VM、磁盘和快照）必须位于同一订阅和区域中。
- 使用客户管理密钥加密的磁盘、快照和映像无法移动到其他资源组和订阅。
- 有关每个区域的磁盘加密集限制，请参阅 Microsoft 站点。
注意：
有关配置 Azure 服务器端加密的信息，请参阅 快速入门：使用 Azure 门户创建 Key Vault。
Azure 客户管理的加密密钥
创建计算机目录时，您可以选择是否加密目录中预配的计算机上的数据。使用客户管理的加密密钥进行服务器端加密，可让您在托管磁盘级别管理加密并保护目录中计算机上的数据。磁盘加密集 (DES) 表示客户管理的密钥。要使用此功能，您必须首先在 Azure 中创建 DES。DES 采用以下格式：
/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/Sample-RG/providers/Microsoft.Compute/diskEncryptionSets/SampleEncryptionSet
从列表中选择一个 DES。您选择的 DES 必须与您的资源位于相同的订阅和区域中。
请参阅 使用客户管理的密钥创建计算机目录。
Azure 主机上的磁盘加密
您可以创建具有主机上加密功能的 MCS 计算机目录。目前，MCS 仅支持此功能的计算机配置文件工作流。您可以将 VM 或模板规范用作计算机配置文件的输入。
此加密方法不通过 Azure 存储加密数据。托管 VM 的服务器会加密数据，然后加密的数据流经 Azure 存储服务器。因此，这种加密方法可以端到端地加密数据。
限制：
Azure 主机上的磁盘加密：
- 不支持所有 Azure 计算机大小
- 与 Azure 磁盘加密不兼容
要创建具有主机上加密功能的计算机目录：
- 检查订阅是否已启用主机上的加密功能。为此，请参阅 https://learn.microsoft.com/zh-cn/rest/api/resources/features/get?tabs=HTTP/。如果未启用，则必须为订阅启用该功能。有关为订阅启用该功能的信息，请参阅 https://learn.microsoft.com/zh-cn/azure/virtual-machines/disks-enable-host-based-encryption-portal?tabs=azure-powershell#prerequisites/。
-
检查特定的 Azure VM 大小是否支持主机上的加密。为此，请在 PowerShell 窗口中运行以下命令之一：
PS XDHyp:\Connections\<your connection>\east us.region\serviceoffering.folder> <!--NeedCopy-->PS XDHyp:\HostingUnits\<your hosting unit>\serviceoffering.folder> <!--NeedCopy--> -
在 Azure 门户中创建 VM 或模板规范，作为计算机配置文件输入，并启用主机加密。
- 如果要创建 VM，请选择支持主机加密的 VM 大小。创建 VM 后，VM 属性 主机加密 将启用。
- 如果要使用模板规范，请在
securityProfile中将参数Encryption at Host分配为 true。
-
通过选择 VM 或模板规范，使用计算机配置文件工作流创建 MCS 计算机目录。
- 操作系统磁盘/数据磁盘：通过客户管理的密钥和平台管理的密钥进行加密
- 临时操作系统磁盘：仅通过平台管理的密钥进行加密
- 缓存磁盘：通过客户管理的密钥和平台管理的密钥进行加密
您可以使用 Web Studio 或运行 PowerShell 命令来创建计算机目录。
从计算机配置文件中检索主机加密信息
当您使用 AdditionalData 参数运行 PowerShell 命令时，可以从计算机配置文件中检索主机加密信息。如果 EncryptionAtHost 参数为 True，则表示已为计算机配置文件启用主机加密。
例如：当计算机配置文件输入为 VM 时，运行以下命令：
(get-item XDHyp:\HostingUnits\myAzureNetwork\machineprofile.folder\abc.resourcegroup\def.vm).AdditionalData
<!--NeedCopy-->
例如：当计算机配置文件输入为模板规范时，运行以下命令：
(get-item XDHyp:\HostingUnits\myAzureNetwork\machineprofile.folder\abc.resourcegroup\def_templatespec.templatespec\EncryptionAtHost.templatespecversion).AdditionalData
<!--NeedCopy-->
托管磁盘上的双重加密
您可以创建具有双重加密的计算机目录。使用此功能创建的任何目录都将所有磁盘进行服务器端加密，并使用平台和客户管理的密钥。您拥有并维护 Azure Key Vault、加密密钥和磁盘加密集 (DES)。
双重加密是平台端加密（默认）和客户管理的加密 (CMEK)。因此，如果您是高度安全敏感的客户，担心与任何加密算法、实施或受损密钥相关的风险，则可以选择此双重加密。持久性操作系统和数据磁盘、快照和映像都通过双重加密进行静态加密。
注意：
- 您可以使用 Web Studio 和 PowerShell 命令创建和更新具有双重加密的计算机目录。有关 PowerShell 命令，请参阅 使用双重加密创建计算机目录。
- 您可以使用非计算机配置文件工作流或计算机配置文件工作流来创建或更新具有双重加密的计算机目录。
- 如果您使用非计算机配置文件工作流创建计算机目录，则可以重复使用存储的
DiskEncryptionSetId。- 如果您使用计算机配置文件，则可以使用 VM 或模板规范作为计算机配置文件输入。
限制：
- 超级磁盘或高级 SSD v2 磁盘不支持双重加密。
- 双重加密在非托管磁盘上不受支持。
- 如果您禁用与目录关联的 DiskEncryptionSet 密钥，则该目录的 VM 将被禁用。
- 与客户管理的密钥相关的所有资源（Azure Key Vault、磁盘加密集、VM、磁盘和快照）必须位于同一订阅和区域中。
- 每个区域每个订阅最多只能创建 50 个磁盘加密集。
微软 Azure 资源组
Azure 预配资源组提供了一种预配向用户提供应用程序和桌面的 VM 的方法。您可以创建资源组或使用现有资源组在 MCS 计算机目录中预配 VM。您可以在多个计算机目录中使用同一资源组。有关 Azure 资源组的信息，请参阅 Microsoft 文档。
Azure 资源组使用情况
每个 Azure 资源组的虚拟机、托管磁盘、快照和映像数量没有限制。（每个 Azure 资源组 240 个 VM 和 800 个托管磁盘的限制已取消。）
- 当使用完全范围的服务主体创建计算机目录时，MCS 只创建一个 Azure 资源组，并将该组用于该目录。
- 当使用窄范围的服务主体创建计算机目录时，您必须为该目录提供一个空的、预先创建的 Azure 资源组。
Azure 临时磁盘
一个Azure 临时磁盘 允许您重新利用缓存磁盘或临时磁盘来存储支持 Azure 的虚拟机的操作系统磁盘。此功能对于需要高性能 SSD 磁盘而非标准 HDD 磁盘的 Azure 环境非常有用。有关使用 Azure 临时磁盘创建目录的信息，请参阅使用 Azure 临时磁盘创建目录。
注意：
持久性目录不支持临时操作系统磁盘。
临时操作系统磁盘要求您的预配方案使用托管磁盘和共享映像库。
存储临时操作系统临时磁盘
您可以选择将临时操作系统磁盘存储在 VM 临时磁盘或资源磁盘上。此功能使您能够将临时操作系统磁盘与没有缓存或缓存不足的 VM 配合使用。此类 VM 具有临时磁盘或资源磁盘来存储临时操作系统磁盘，例如 Ddv4。
请考虑以下事项：
- 临时磁盘存储在 VM 缓存磁盘或 VM 的临时（资源）磁盘中。缓存磁盘优先于临时磁盘，除非缓存磁盘不足以容纳操作系统磁盘的内容。
- 对于更新，如果新映像大于缓存磁盘但小于临时磁盘，则会导致用 VM 的临时磁盘替换临时操作系统磁盘。
Azure 临时磁盘和机器创建服务 (MCS) 存储优化 (MCS I/O)
Azure 临时操作系统磁盘和 MCS I/O 不能同时启用。
以下是重要的注意事项：
-
不能同时创建启用了临时 OS 磁盘和 MCS I/O 的计算机目录。
- 如果在
New-ProvScheme或Set-ProvScheme中将 PowerShell 参数 (UseWriteBackCache和UseEphemeralOsDisk) 设置为 true，则会显示相应的错误消息。 - 对于已启用这两种功能而创建的现有计算机目录，您仍然可以执行以下操作：
- 更新计算机目录。
- 添加或删除 VM。
- 删除计算机目录。
微软 Azure 计算库
使用 Azure 计算库（以前称为 Azure 共享映像库）作为 Azure 中 MCS 预配计算机的已发布映像存储库。您可以将已发布的映像存储在库中，以加快 OS 磁盘的创建和填充，从而缩短非持久性 VM 的启动和应用程序启动时间。共享映像库包含以下三个元素：
- 库：映像存储在此处。MCS 为每个计算机目录创建一个库。
- 库映像定义：此定义包含有关已发布映像的信息（操作系统类型和状态、Azure 区域）。MCS 为为目录创建的每个映像创建一个映像定义。
- 库映像版本：共享映像库中的每个映像可以有多个版本，每个版本可以在不同的区域有多个副本。每个副本都是已发布映像的完整副本。
注意：
共享映像库的功能仅与托管磁盘兼容。此功能不适用于旧版计算机目录。
有关详细信息，请参阅 Azure 计算库概述。
有关使用 PowerShell 通过 Azure 计算库映像创建或更新计算机目录的信息，请参阅 使用 Azure 计算库映像创建或更新计算机目录。
Azure 机密虚拟机
Azure 机密计算虚拟机可确保您的虚拟桌面在内存中加密并在使用中受到保护。
您可以使用 MCS 创建包含 Azure 机密虚拟机的目录。您必须使用计算机配置文件工作流来创建此类目录。您可以将虚拟机和 ARM 模板规范都用作计算机配置文件输入。
机密虚拟机的重要注意事项
支持的虚拟机大小和使用机密虚拟机创建计算机目录的重要注意事项如下：
-
支持的虚拟机大小：机密虚拟机支持以下虚拟机大小：
- 迪卡斯v5 系列
- DCadsv5 系列的虚拟机
- ECasv5 系列实例
- ECadsv5-series
-
使用机密虚拟机创建计算机目录。
- 您可以使用 Web Studio 和 PowerShell 命令创建包含 Azure 机密虚拟机的计算机目录。
- 您必须使用基于计算机配置文件的流程来创建包含 Azure 机密虚拟机的计算机目录。您可以将虚拟机或模板规范用作计算机配置文件输入。
-
主映像和计算机配置文件输入都必须启用相同的机密安全类型。安全类型包括：
- VMGuestStateOnly：仅加密虚拟机来宾状态的机密虚拟机
- DiskWithVMGuestState：机密虚拟机，其操作系统磁盘和虚拟机来宾状态均使用平台管理的密钥或客户管理的密钥加密。普通和临时操作系统磁盘都可以加密。
-
您可以使用 AdditionalData 参数获取各种资源类型（例如托管磁盘、快照、Azure 计算库映像、虚拟机和 ARM 模板规范）的机密虚拟机信息。例如：
PS C:\Users\username> (get-item XDHyp:\HostingUnits\mynetwork\image.folder\username-dev-testing-rg.resourcegroup\username-dev-tsvda.vm).AdditionalData <!--NeedCopy-->附加数据字段包括：
- 磁盘安全类型
- 机密虚拟机磁盘加密集ID
- 磁盘安全配置文件
要获取计算机大小的机密计算属性，请运行以下命令：
(Get-Item -path "XDHyp:\Connections\my-connection-name\East US.region\serviceoffering.folder\abc.serviceoffering").AdditionalData附加数据字段是
ConfidentialComputingType。 - 您无法将主映像或计算机配置文件从机密安全类型更改为非机密安全类型，也无法从非机密安全类型更改为机密安全类型。
- 对于任何不正确的配置，您都会收到相应的错误消息。
准备主映像和计算机配置文件
在创建一组机密虚拟机之前，请按照以下步骤为其准备主映像和计算机配置文件：
- 在 Azure 门户中，创建具有特定设置的机密虚拟机，例如：
- 安全类型：机密虚拟机
- 机密操作系统磁盘加密：已启用。
- 密钥管理：使用平台管理的密钥进行机密磁盘加密 有关创建机密 VM 的更多信息，请参阅 此 Microsoft 文章。
-
在创建的 VM 上准备主映像。在创建的 VM 上安装必要的应用程序和 VDA。
注意：
不支持使用 VHD 创建机密 VM。请改用 Azure 计算库、托管磁盘或快照。
-
通过以下任一方式创建计算机配置文件：
- 如果步骤 1 中创建的现有 VM 具有所需的计算机属性，则使用该 VM。
-
如果您选择 ARM 模板规范作为计算机配置文件，请根据需要创建模板规范。具体来说，配置满足您的机密 VM 要求的参数，例如 SecurityEncryptionType 和 diskEncryptionSet（用于客户管理的密钥）。有关详细信息，请参阅 (/zh-cn/citrix-virtual-apps-desktops/2507-ltsr/install-configure/machine-catalogs-create/create-machine-catalog-citrix-azure#create-an-azure-template-spec)。
注意：
- 确保主映像和计算机配置文件具有相同的安全密钥类型。
- 要创建需要使用客户管理的密钥进行机密 OS 磁盘加密的机密 VM，请确保主映像和计算机配置文件中的磁盘加密集 ID 相同。
Create confidential VMs using Web Studio or PowerShell commands
要创建一组机密 VM，请使用主映像和从所需机密 VM 派生的计算机配置文件来创建计算机目录。
要使用 Web Studio 创建目录，请按照 (/zh-cn/citrix-virtual-apps-desktops/2507-ltsr/install-configure/machine-catalogs-create) 中所述的步骤操作。请记住以下注意事项：
- 在映像页面上，选择您为创建机密 VM 准备的主映像和计算机配置文件。计算机配置文件选择是强制性的，并且只有与所选主映像具有相同安全加密类型的配置文件才可供选择。
- 在虚拟机页面上，只有支持机密 VM 的计算机大小才会显示以供选择。
- 在磁盘设置页面上，您无法指定磁盘加密集，因为它继承自所选的计算机配置文件。
启动完整性监控
如果您的 VM 启用了安全启动和虚拟可信平台模块 (vTPM)，并且安装了 GuestAttestation 扩展，则 Microsoft Defender for Cloud 可以远程验证您的 VM 是否以健康方式启动。此监控称为启动完整性监控。有关启动完整性监控的更多信息，请参阅启动完整性监控概述。
您可以使用计算机配置文件（VM 或模板规范）为 MCS 计算机目录 VM（持久性 VM 和非持久性 VM）启用启动完整性监控。启动完整性监控仅支持受信任启动和机密 VM。
您可以使用 Set-ProvScheme 更新现有目录以使用启动完整性，指向已启用启动完整性的计算机配置文件。然后，添加到目录的新 VM 将启用完整性监控。
您还可以使用 Set-ProvVmUpdateTimeWindow、Set-ProvVm 或 Maintenance Cycles 更新目录中的现有 VM。您可以将以下内容转换为：
- 没有完整性监控的 VM 转换为具有完整性监控
- 具有完整性监控的 VM 转换为没有完整性监控
创建已启用完整性监控的计算机目录
所需的权限：
请确保您已拥有以下各项权限：
Microsoft.Compute/virtualMachines/extensions/readMicrosoft.Compute/virtualMachines/extensions/write
执行以下操作以创建已启用完整性监控的 MCS 计算机目录：
- 创建已安装
GuestAttestation扩展的计算机配置文件（VM 或模板规范）。（链接到以下内容） -
使用 Web Studio 或 PowerShell 命令，利用计算机配置文件输入创建 MCS 计算机目录。
注意：
您可以使用
Get-ItemPowerShell 命令和AdditionalData参数检查 VM 或模板规范的GuestAttestationExtensionEnabled状态。 - 将 VM 添加到目录。
创建已安装 GuestAttestation 扩展的计算机配置文件
创建已启用完整性监控的 VM 或模板规范作为计算机配置文件输入，这意味着已安装 GuestAttestation 扩展。
要创建已启用完整性监控的 VM，请执行以下操作：
- 登录到 Azure 门户。
-
如果要创建新的 VM：
- 将安全类型选择为受信任的启动虚拟机或机密虚拟机。
-
单击配置安全功能并选中完整性监控复选框。
注意：
对于完整性监控，您必须启用安全启动和 vTPM。
- 在概述页面上，转到安全类型部分，验证安全类型是否为受信任的启动或机密虚拟机，并且已启用完整性监控。
- 导航到扩展 + 应用程序页面以验证是否已安装
GuestAttestation。
要启用现有 VM 的完整性监视，请参阅 启用完整性监视 - Azure 门户。
要创建已安装 GuestAttestation 扩展的模板规范：
-
您可以使用模板规范安装 GuestAttestation。请参阅 启用完整性监视 - 模板规范。
注意：
在此模板规范中，在设置下，您可以配置用于证明的终结点。如果您不进行配置，则 Azure 会决定要配置哪些终结点。
Azure Marketplace
Citrix Virtual Apps and Desktops 支持在 Azure 上使用包含计划信息的主映像来创建计算机目录。有关详细信息，请参阅 Microsoft Azure 市场。
提示：
Some images found on the Azure Marketplace, like the standard Windows Server image, do not append plan information. Citrix Virtual Apps and Desktops feature is for paid images.
确保在共享映像库中创建的映像包含 Azure 计划信息
使用本节中的过程在 Web Studio 中查看共享映像库映像。这些映像可以选择用作主映像。要将映像放入共享映像库，请在库中创建映像定义。
在发布选项页面中，验证购买计划信息。
购买计划信息字段最初为空。使用用于映像的购买计划信息填充这些字段。未能填充购买计划信息可能导致计算机目录过程失败。
在验证购买计划信息后，在定义中创建映像版本。此版本用作主映像。单击添加版本：
在版本详细信息部分中，选择映像快照或托管磁盘作为源：
创建按需容量预留 VM 目录
按需容量预留使您能够在 Azure 区域或可用性区域中预留任意时长的计算容量。有关 Azure 按需容量预留的更多信息，请参阅 Microsoft 文档 按需容量预留。
您可以使用计算机配置文件（VM 或模板规范）创建具有按需容量预留的 Azure VM 的 MCS 计算机目录。您还可以更新现有计算机目录和现有 VM，以添加或删除按需容量预留。
此功能适用于持久性以及非持久性的计算机目录。
限制事项
此功能不适用于以下各项：
- Spot 虚拟机
- 主机组
- 已启用休眠的 VM
有关限制的更多信息，请参阅 Microsoft 文档 限制和约束。
创建按需容量预留 VM 目录的步骤
- 创建计算机配置文件源（VM 或 ARM 模板规范）。有关创建 VM 或 ARM 模板规范的信息，请参阅 将 VM 与容量预留组关联。
-
运行以下 PowerShell 命令以检查计算机配置文件是否启用了按需容量预留。如果计算机配置文件启用了按需容量预留，则会获得
capacityReservationGroup id。例如，
如果计算机配置文件源是 VM，请运行以下命令：
(Get-Item "XDHyp:\HostingUnits\azure-res-conn2\machineprofile.folder\fifthcolumn.resourcegroup\demand-capacity.vm").AdditionalData <!--NeedCopy-->如果计算机配置文件源是模板规范，请运行以下命令：
(Get-Item "XDHyp:\HostingUnits\azure-res-conn2\machineprofile.folder\fifthcolumn.resourcegroup\fc-aeh-templatespec.templatespec\14.0.0-capacity-reservation.templatespecversion").AdditionalData <!--NeedCopy--> - 使用 Web Studio 或 PowerShell 命令，通过计算机配置文件创建计算机目录。
您可以使用 Set-ProvScheme 命令更新目录。您还可以使用 PowerShell 命令 Set-ProvVmUpdateTimeWindow 更新现有 VM。计算机配置文件将在下次开机时更新。
嵌套式虚拟化
如果将主 VM 配置为启用嵌套虚拟化，则使用该主 VM 创建的 MCS 计算机目录中的所有 VM 都将启用嵌套虚拟化。此功能适用于持久性和非持久性 VM。您可以通过映像更新来更新现有 MCS 计算机目录和现有 VM，以启用嵌套虚拟化。
目前，只有 Dv3 和 Ev3 VM 大小支持嵌套虚拟化。
有关嵌套虚拟化的信息，请参阅 Microsoft 博客 Azure 中的嵌套虚拟化。
仅限 NVMe 的产品型号
通常，较旧的通用、内存优化和计算优化 VM（D/Ev5 或 Fv2 及更早版本）支持 SCSI。较新的代次（Da/Ea/Fav6 及更新版本）通常仅支持 NVMe 存储接口。MCS 支持 NVMe 存储控制器类型，以支持 Azure 上的新 VM SKU。
有关 NVMe 的信息，请参阅 Microsoft 文档 NVMe 常见问题解答。
您可以使用以下服务产品创建 MCS 目录：
- 同时支持 SCSI 和 NVMe，请参阅使用同时支持 SCSI 和 NVMe 的服务产品创建目录
- 仅支持 NVMe，请参阅使用仅支持 NVMe 的服务产品创建目录
局限性
- 所有支持 NVMe 的服务产品都不支持同时启用受信任启动。
- Gen 1 虚拟机不支持 NVMe。
- 某些操作系统映像可能不支持 NVMe。在这种情况下，Azure UI 上的 NVMe 选项将显示为灰色。
使用同时支持 SCSI 和 NVMe 的服务产品创建目录
-
创建用作主映像的虚拟机。
- 使用支持 NVMe 的市场映像。支持 NVMe 的 Azure Marketplace 映像列表可在远程 NVMe 支持的操作系统映像 中找到。
-
拍摄虚拟机的操作系统磁盘快照，以在
New-ProvScheme命令的MasterImageVM参数中使用，或直接使用托管磁盘。使用以下方法之一检查您的主映像是否支持 NVMe：
-
检查
Get-Item的AdditionalData字段中的SupportedDiskControllerTypes。例如：(get-item XDHyp:\HostingUnits\mynetwork\image.folder\abc.resourcegroup\deg-snapshot).AdditionalData <!--NeedCopy-->SupportedDiskControllerTypes必须是SCSI, NVMe。 -
Use Azure CLI and PowerShell
-
- 使用同时支持 NVMe 和 SCSI 的服务产品。
- 使用已启用 NVMe 的 VM 或模板规范作为计算机配置文件。选择任何将
DiskControllerType设置为 NVMe 的 VM。直接将 VM 用作计算机配置文件，或导出模板并将模板规范用作计算机配置文件。
使用仅支持 NVMe 的服务产品创建目录
- 创建一个用作主映像的虚拟机。使用支持 NVMe 的市场映像。支持 NVMe 的 Azure 市场映像列表可在 支持远程 NVMe 的操作系统映像 中找到。
-
使用仅支持 NVMe 的服务产品。
注意：
由于服务产品支持 NVMe，因此您不需要将
DiskControllerType设置为NVMe的计算机配置文件即可在目录上启用 NVMe。但是，如果您使用计算机配置文件，则必须将DiskControllerType设置为NVMe，或者将其留空或不指定。
修改现有持久性 VM
VM 创建后，无法更改 NVMe 配置。更改持久性 VM 的 NVMe 配置的方法是重新部署 VM。执行此操作的逻辑是：
- 保存 VM 的当前状态。
-
启动现有 VM 后，检测 VM 是否需要重新部署。
- 如果配置更改是从 NVMe 到 NVMe 或从 SCSI 到 SCSI，则无需重新部署 VM。
- 如果配置更改是从 SCSI 到 NVMe，反之亦然，则重新部署并重新创建 VM。
使用 PowerShell 创建计算机目录
本节详细介绍了如何使用 PowerShell 创建目录：
- 使用非持久性回写缓存磁盘创建目录
- 创建使用持久性回写缓存磁盘的目录
- 使用 MCSIO 提高启动性能
- 使用 PowerShell 创建或更新目录时使用模板规范
- 使用受信任启动的计算机目录
- 使用计算机配置文件属性值
- 创建使用客户管理的加密密钥的计算机目录
- 创建使用双重加密的计算机目录
- 创建使用 Azure 临时磁盘的目录
- Azure 专用主机
- 使用 Azure 计算库映像创建或更新计算机目录
- 配置共享映像库
- 将计算机预配到指定的可用性区域
- 存储类型
- 使用 Azure 即时虚拟机创建目录
- 配置备份 VM 大小
- 复制所有资源上的标签(#copy-tags-on-all-resources)
- 预配已安装 Azure 监视器代理的目录 VM(#provision-catalog-vms-with-azure-monitor-agent-installed)
创建具有非持久性回写缓存磁盘的目录
要配置具有非持久性回写缓存磁盘的目录，请使用 PowerShell 参数 New-ProvScheme CustomProperties。自定义属性 UseTempDiskForWBC 指示您是否接受使用 Azure 临时存储来存储回写缓存文件。如果您想使用临时磁盘作为回写缓存磁盘，则在运行 New-ProvScheme 时必须将其配置为 true。如果未指定此属性，则参数默认设置为 False。
例如，使用 CustomProperties 参数将 UseTempDiskForWBC 设置为 true：
-CustomProperties '<CustomProperties xmlns=" http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi=" http://www.w3.org/2001/XMLSchema-instance"> `
<Property xsi:type="StringProperty" Name="PersistWBC" Value="false"/> `
<Property xsi:type="StringProperty" Name="PersistOsDisk" Value="false"/> `
<Property xsi:type="StringProperty" Name="PersistVm" Value="false"/> `
<Property xsi:type="StringProperty" Name="StorageAccountType" Value="Premium_LRS"/> `
<Property xsi:type="StringProperty" Name="WBCDiskStorageType" Value="Premium_LRS"/> `
<Property xsi:type="StringProperty" Name="LicenseType" Value="Windows_Client"/> `
<Property xsi:type="StringProperty" Name="UseTempDiskForWBC" Value="true"/> `
</CustomProperties>'
<!--NeedCopy-->
注意：
将计算机目录提交为使用 Azure 本地临时存储作为回写缓存文件后，以后无法更改为使用 VHD。
创建具有持久性回写缓存磁盘的目录
要配置具有持久性回写缓存磁盘的目录，请使用 PowerShell 参数 New-ProvScheme CustomProperties。此参数支持一个额外的属性 PersistWBC，用于确定 MCS 预配的计算机的回写缓存磁盘如何持久化。PersistWBC 属性仅在指定 UseWriteBackCache 参数且 WriteBackCacheDiskSize 参数设置为指示创建磁盘时使用。
在支持 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>
<!--NeedCopy-->
使用这些属性时，请注意，如果 CustomProperties 参数中省略了这些属性，它们将包含默认值。PersistWBC 属性有两个可能的值：true 或 false。
当 Citrix Virtual Apps and Desktops 管理员使用 Web Studio 关闭计算机时，将 PersistWBC 属性设置为 true 不会删除回写缓存磁盘。
将 PersistWBC 属性设置为 false 时，当 Citrix 虚拟应用和桌面管理员使用 Web Studio 关闭计算机时，将删除回写缓存磁盘。
注意：
如果省略
PersistWBC属性，则该属性默认为 false，并且在使用 Web Studio 关闭计算机时会删除回写缓存。
例如，使用 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>
<!--NeedCopy-->
重要提示：
PersistWBC属性只能使用New-ProvSchemePowerShell cmdlet 进行设置。尝试在创建后更改预配方案的CustomProperties对计算机目录以及计算机关闭时回写缓存磁盘的持久性没有影响。
例如，在将 PersistWBC 属性设置为 true 的同时，将 New-ProvScheme 设置为使用回写缓存：
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
<!--NeedCopy-->
使用 MCSIO 提高启动性能
启用 MCSIO 后，可以提高 Azure 和 GCP 托管磁盘的启动性能。在 New-ProvScheme 命令中使用 PowerShell PersistOSDisk 自定义属性来配置此功能。与 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 <!--NeedCopy-->
``````<!--NeedCopy-->
<!--NeedCopy-->
````````Groups" Value="benvaldev5RG3" />
<Property xsi:type="StringProperty" Name="PersistOsDisk" Value="true" />
</CustomProperties>
<!--NeedCopy-->
要启用此功能，请将 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
<!--NeedCopy-->
使用 PowerShell 创建或更新目录时使用模板规范
您可以使用模板规范作为计算机配置文件输入来创建或更新 MCS 计算机目录。为此，您可以使用 Web Studio 或 PowerShell 命令。
对于 Web Studio，请参阅 在 Web Studio 中使用 Azure 资源管理器映像创建计算机目录
使用 PowerShell 命令执行操作：
- 打开 PowerShell 命令行窗口。
- 运行
asnp citrix*。 - 创建或更新目录。
- 要创建目录：
-
使用
New-ProvScheme命令，并将模板规范作为计算机配置文件输入。例如：New-ProvScheme -MasterImageVM "XDHyp:/HostingUnits/azure/image.folder/fgthj.resourcegroup/nab-ws-vda_OsDisk_1_xxxxxxxxxxa.manageddisk" MachineProfile "XDHyp:/HostingUnits/azure/machineprofile.folder/fgthj.resourcegroup/test.templatespec/V1.templatespecversion" -ProvisioningSchemeName <String> -HostingUnitName <String> -IdentityPoolName <String> [-ServiceOffering <String>][-CustomProperties <String> [-LoggingId <Guid>] [-BearerToken <String>][-AdminAddress <String>] [<CommonParameters>] <!--NeedCopy--> -
完成目录创建。
-
-
要更新目录，请使用
Set-ProvScheme命令，并将模板规范作为计算机配置文件输入。例如：Set-ProvScheme -MasterImageVm 'XDHyp://Connections/Azure/East Us.region/vm.folder/MasterDisk.vm' MachineProfile 'XDHyp:/HostingUnits/azure/machineprofile.folder/fgthj.resourcegroup/testing.templatespec/V1.templatespecversion' [-ProvisioningSchemeName] <String> [-CustomProperties <String>][-ServiceOffering <String>] [-PassThru] [-LoggingId <Guid>] [-BearerToken <String>][-AdminAddress <String>] [<CommonParameters>] <!--NeedCopy-->
- 要创建目录：
具有受信任启动的计算机目录
要成功创建具有受信任启动的计算机目录，请使用：
- 启用了受信任启动的主映像。您必须使用计算机配置文件，但计算机配置文件不必启用受信任启动。如果您使用启用了受信任启动的主映像和未启用受信任启动的计算机配置文件，则会收到警告消息，因为主映像和计算机配置文件之间的受信任启动配置不匹配。
- 支持受信任启动的 VM 大小
- 支持受信任启动功能的 Windows 虚拟机版本。目前，Windows 10、Windows 11、Windows Server 2016、2019 和 2022 均支持受信任启动功能。
要查看 Citrix Virtual Apps and Desktops 提供的清单项并确定 VM 大小是否支持受信任启动，请运行以下命令：
- 打开一个 PowerShell 命令行窗口。
- 运行 asnp citrix* 命令，以加载 思杰 特定的 PowerShell 模块。
-
运行以下命令：
$s = (ls XDHyp:\HostingUnits\<name of hosting unit>\serviceoffering.folder\"<VM size>.serviceoffering) <!--NeedCopy--> - 运行
$s | select -ExpandProperty Additionaldata -
检查
SupportsTrustedLaunch属性的值。- 如果
SupportsTrustedLaunch为 True，则 VM 大小支持受信任启动。 - 如果
SupportsTrustedLaunch为 False，则 VM 大小不支持受信任启动。
- 如果
根据 Azure 的 PowerShell，您可以使用以下命令确定支持受信任启动的 VM 大小：
(Get-AzComputeResourceSku | where {$_.Locations.Contains($region) -and ($_.Name -eq "<VM size>") })[0].Capabilities
<!--NeedCopy-->
以下示例描述了运行 Azure PowerShell 命令后 VM 大小是否支持受信任启动。
-
示例 1：如果 Azure VM 仅支持第 1 代，则该 VM 不支持受信任启动。因此，运行 Azure PowerShell 命令后不会显示
TrustedLaunchDisabled功能。 -
示例 2：如果 Azure VM 仅支持第 2 代且
TrustedLaunchDisabled功能为 True，则不支持第 2 代 VM 大小进行受信任启动。 -
示例 3：如果 Azure VM 仅支持第 2 代，并且运行 PowerShell 命令后未显示
TrustedLaunchDisabled功能，则支持第 2 代 VM 大小进行受信任启动。
有关 Azure 虚拟机受信任启动的更多信息，请参阅 Microsoft 文档 适用于 Azure 虚拟机的受信任启动。
创建具有受信任启动的计算机目录
- 创建启用受信任启动的主映像。请参阅 Microsoft 文档 受信任启动 VM 映像。
- 创建安全类型为 trusted launch virtual machines 的 VM 或模板规范。有关创建 VM 或模板规范的更多信息，请参阅 Microsoft 文档 部署受信任启动 VM。
-
使用 Web Studio 界面 或 PowerShell 命令创建计算机目录。
- 如果要使用 Web Studio，请参阅 在 Web Studio 中使用 Azure 资源管理器 映像创建计算机目录。
-
如果要使用 PowerShell 命令，请使用
New-ProvScheme命令，并将 VM 或模板规范作为计算机配置文件输入。有关创建目录的完整命令列表，请参阅 Creating a catalog。New-ProvScheme以 VM 作为计算机配置文件输入的示例：New-ProvScheme -CleanOnBoot -HostingUnitName "name" -IdentityPoolName "name" -InitialBatchSizeHint 1 -MasterImageVM "XDHyp:/HostingUnits/azure/image.folder/fgthj.resourcegroup/nab-ws-vda_OsDisk_1_xxxxxxxxxxa.manageddisk" -MachineProfile "XDHyp:\HostingUnits\<adnet>\machineprofile.folder\<def.resourcegroup>\<machine profile vm.vm>" -ProvisioningSchemeName <String> -HostingUnitName <String> -IdentityPoolName <String> [-ServiceOffering <String>][-CustomProperties <String>] [<CommonParameters>] <!--NeedCopy-->New-ProvScheme以模板规范作为计算机配置文件输入的示例：New-ProvScheme -CleanOnBoot -HostingUnitName "name" -IdentityPoolName "name" -InitialBatchSizeHint 1 -MasterImageVM "XDHyp:/HostingUnits/azure/image.folder/fgthj.resourcegroup/nab-ws-vda_OsDisk_1_xxxxxxxxxxa.manageddisk" MachineProfile "XDHyp:/HostingUnits/azure/machineprofile.folder/fgthj.resourcegroup/test.templatespec/V1.templatespecversion" -ProvisioningSchemeName <String> -HostingUnitName <String> -IdentityPoolName <String> [-ServiceOffering <String>][-CustomProperties <String>] [<CommonParameters>] <!--NeedCopy-->
使用可信启动更新计算机目录
您可以更新持久性和非持久性计算机目录：
对于持久性计算机目录：
对于非持久性计算机目录：
使用可信启动创建计算机目录时出错
在以下场景中，使用可信启动创建计算机目录时会收到相应的错误：
| 场景 | 错误 |
|---|---|
| 如果在创建非托管目录时选择了计算机配置文件 | MachineProfileNotSupportedForUnmanagedCatalog |
| 如果在创建托管目录时未选择计算机配置文件，且主映像源的安全类型为可信启动 | MachineProfileNotFoundForTrustedLaunchMasterImage |
| 如果选择的计算机配置文件的安全类型与主映像的安全类型不同 | SecurityTypeConflictBetweenMasterImageAndMachineProfile |
| 如果您选择的 VM 大小不支持受信任启动，但在创建目录时使用了支持受信任启动的主映像 | MachineSizeNotSupportTrustedLaunch |
使用计算机配置文件属性值
计算机目录使用在自定义属性中定义的以下各项属性：
- 可用性区域
- 专用主机组 ID
- 磁盘加密集 ID
- 操作系统类型
- 许可证类型
- 存储类型
如果未明确定义这些自定义属性，则属性值将从 ARM 模板规范或 VM（以用作计算机配置文件的为准）中设置。此外，如果未指定 ServiceOffering，则会从计算机配置文件中设置。
注意：
如果计算机配置文件中缺少某些属性且未在自定义属性中定义，则在适用的情况下将采用属性的默认值。
以下部分描述了 New-ProvScheme 和 Set-ProvScheme 处的一些场景，其中 CustomProperties 要么定义了所有属性，要么值是从 MachineProfile 派生的。
-
New-ProvScheme 命令行工具的使用场景
-
MachineProfile has all the properties and CustomProperties are not defined. Example:
New-ProvScheme -MachineProfile "XDHyp:\HostingUnits\azureunit\machineprofile.folder\azure.resourcegroup\mpA.vm"以下值将作为目录的自定义属性进行设置：
Get-ProvScheme | select CustomProperties <CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <Property xsi:type="StringProperty" Name="StorageAccountType" Value="<mpA-value>"/> <Property xsi:type="StringProperty" Name="OSType" Value="<mpA-value>"/> <Property xsi:type="StringProperty" Name="LicenseType" Value="<mpA-value>"/> <Property xsi:type="StringProperty" Name="DiskEncryptionSetId" Value="<mpA-value>"/> <Property xsi:type="StringProperty" Name="DedicatedHostGroupId" Value="<mpA-value>"/> <Property xsi:type="StringProperty" Name="Zones" Value="<mpA-value>"/> </CustomProperties> <!--NeedCopy--> -
MachineProfile has some properties and CustomProperties are not defined. Example: MachineProfile only has LicenseType and OsType.
New-ProvScheme -MachineProfile "XDHyp:\HostingUnits\azureunit\machineprofile.folder\azure.resourcegroup\mpA.vm"以下值将作为目录的自定义属性进行配置：
Get-ProvScheme | select CustomProperties <CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <Property xsi:type="StringProperty" Name="OSType" Value="<mpA-value>"/> <Property xsi:type="StringProperty" Name="LicenseType" Value="<mpA-value>"/> </CustomProperties> <!--NeedCopy--> -
Both MachineProfile and CustomProperties define all properties. Example:
New-ProvScheme -MachineProfile "XDHyp:\HostingUnits\azureunit\machineprofile.folder\azure.resourcegroup\mpA.vm" -CustomProperties $CustomPropertiesA自定义属性具有优先权。以下值将作为目录的自定义属性进行设置：
Get-ProvScheme | select CustomProperties <CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <Property xsi:type="StringProperty" Name="StorageAccountType" Value="<CustomPropertiesA-value>"/> <Property xsi:type="StringProperty" Name="OSType" Value="<CustomPropertiesA-value>"/> <Property xsi:type="StringProperty" Name="LicenseType" Value="<CustomPropertiesA-value>"/> <Property xsi:type="StringProperty" Name="DiskEncryptionSetId" Value="<CustomPropertiesA-value>"/> <Property xsi:type="StringProperty" Name="DedicatedHostGroupId" Value="<CustomPropertiesA-value>"/> <Property xsi:type="StringProperty" Name="Zones" Value="<CustomPropertiesA-value>"/> </CustomProperties> <!--NeedCopy--> - Some properties are defined in MachineProfile and some properties are defined in CustomProperties. Example:
- 自定义属性定义许可证类型和存储账户类型
- 计算机配置文件定义许可证类型、操作系统类型和区域
New-ProvScheme -MachineProfile "XDHyp:\HostingUnits\azureunit\machineprofile.folder\azure.resourcegroup\mpA.vm" -CustomProperties $CustomPropertiesA以下值将作为目录的自定义属性进行设置：
Get-ProvScheme | select CustomProperties <CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <Property xsi:type="StringProperty" Name="StorageAccountType" Value="<CustomPropertiesA-value>"/> <Property xsi:type="StringProperty" Name="OSType" Value="<mpA-value>"/> <Property xsi:type="StringProperty" Name="LicenseType" Value="<CustomPropertiesA-value>"/> <Property xsi:type="StringProperty" Name="Zones" Value="<mpA-value>"/> </CustomProperties> <!--NeedCopy--> -
Some properties are defined in MachineProfile and some properties are defined in CustomProperties. In addition, ServiceOffering is not defined. Example:
- 自定义属性定义存储类型
- 机器配置文件定义许可证类型
New-ProvScheme -MachineProfile "XDHyp:\HostingUnits\azureunit\machineprofile.folder\azure.resourcegroup\mp.vm" -ServiceOffering "XDHyp:\HostingUnits\azureunit\serviceoffering.folder\<explicit-machine-size>.serviceoffering" <!--NeedCopy-->以下值将作为目录的自定义属性进行设置：
Get-ProvScheme | select ServiceOffering serviceoffering.folder\<explicit-machine-size>.serviceoffering Get-ProvScheme | select CustomProperties <CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <Property xsi:type="StringProperty" Name="StorageAccountType" Value="explicit-storage-type"/> <Property xsi:type="StringProperty" Name="LicenseType" Value="value-from-machineprofile"/> </CustomProperties> <!--NeedCopy--> - If the OsType is in neither in the CustomProperties nor in the MachineProfile, then:
- 该值从主映像中读取。
- 如果主映像是非托管磁盘，则 OsType 设置为 Windows。示例：
New-ProvScheme -MachineProfile "XDHyp:\HostingUnits\azureunit\machineprofile.folder\azure.resourcegroup\mpA.vm" -MasterImageVM "XDHyp:\HostingUnits\azureunit\image.folder\linux-master-image.manageddisk"主映像中的值将写入自定义属性，在此情况下为 Linux。
Get-ProvScheme | select CustomProperties <CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <Property xsi:type="StringProperty" Name="OSType" Value="Linux"/> </CustomProperties> <!--NeedCopy-->
-
-
Set-ProvScheme Scenarios
-
具有以下内容的现有目录：
- 用于
StorageAccountType和 OsType 的自定义属性 - 定义区域的机器配置文件
mpA.vm
- 用于
-
更新：
- 定义存储账户类型的机器配置文件 mpB.vm
- 一组新的自定义属性 $CustomPropertiesB，用于定义许可证类型和操作系统类型
Set-ProvScheme -MachineProfile "XDHyp:\HostingUnits\azureunit\machineprofile.folder\azure.resourcegroup\mpB.vm" -CustomProperties $CustomPropertiesB以下值将作为目录的自定义属性进行设置：
Get-ProvScheme | select CustomProperties <CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <Property xsi:type="StringProperty" Name="StorageAccountType" Value="<mpB-value>"/> <Property xsi:type="StringProperty" Name="OSType" Value="<CustomPropertiesB-value>"/> <Property xsi:type="StringProperty" Name="LicenseType" Value="<CustomPropertiesB-value>"/> </CustomProperties> <!--NeedCopy--> - 具有以下内容的现有目录：
- S
torageAccountType和 OsType 的 自定义属性 - MachineProfile
mpA.vmthat defines StorageAccountType and LicenseType
- S
- 更新：
- A new set of custom properties $CustomPropertiesB that defines StorageAccountType and OsType.
Set-ProvScheme -CustomProperties $CustomPropertiesB以下各项值被设置为目录的自定义属性：
Get-ProvScheme | select CustomProperties <CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <Property xsi:type="StringProperty" Name="StorageAccountType" Value="<CustomPropertiesB-value>"/> <Property xsi:type="StringProperty" Name="OSType" Value="<CustomPropertiesB-value>"/> <Property xsi:type="StringProperty" Name="LicenseType" Value="<mp-A-value>"/> </CustomProperties> <!--NeedCopy--> - 具有以下内容的现有目录：
-
StorageAccountType和 操作系统类型 的 自定义属性 - 定义区域的机器配置文件
mpA.vm
-
- 更新：
- 一个机器配置文件 mpB.vm，它定义了存储账户类型和许可证类型
-
ServiceOffering未指定
Set-ProvScheme -MachineProfile "XDHyp:\HostingUnits\azureunit\machineprofile.folder\azure.resourcegroup\mpB.vm"以下值将作为目录的自定义属性进行设置：
Get-ProvScheme | select ServiceOffering serviceoffering.folder\<value-from-machineprofile>.serviceoffering Get-ProvScheme | select CustomProperties <CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <Property xsi:type="StringProperty" Name="StorageAccountType" Value="<mpB-value>"/> <Property xsi:type="StringProperty" Name="OSType" Value="<prior-CustomProperties-value>"/> <Property xsi:type="StringProperty" Name="LicenseType" Value="<mpB-value>"/> </CustomProperties> <!--NeedCopy-->
-
创建或更新每个 VM 具有多个 NIC 的目录
MCS 支持每个 VM 具有多个 NIC。您可以将 VM 上的多个 NIC 关联到多个子网，但是，这些子网必须位于同一虚拟网络 (VNet) 中。您可以使用 PowerShell 命令来：
您可以创建或更新非计算机配置文件型计算机目录和计算机配置文件型计算机目录，以使每个 VM 具有多个 NIC。目前，对于计算机配置文件型计算机目录，您只能拥有与计算机配置文件源中指定的 NIC 数量相同的 NIC。
诸如加速网络之类的属性是从计算机配置文件源派生而来的。
注意：
VM 大小必须支持相同数量的 NIC 和相应的加速网络，否则会出错。
当您使用 AdditionalData 参数运行 PowerShell get-item 命令时，名为 MaxNetworkInterfaces 的 PowerShell 属性会显示最大 NIC 计数。
检索最大 NIC 计数
要检索最大 NIC 计数：
- 从交付控制器™主机打开 PowerShell 窗口。
- 运行
asnp citrix*以加载 思杰 专用的 PowerShell 模块。 - 运行
Get-ChildItem -Path "XDHyp:\Connections\abc-connection\East US.region\serviceoffering.folder"以列出所有可用的 VM 大小。 - 运行
get-item -Path "XDHyp:\Connections\abc-connection\East US.region\serviceoffering.folder\Standard_M416ms_v2.serviceoffering").AdditionalData - 检查
MaxNetworkInterfaces以了解最大 NIC 计数。
在 VM 上创建具有多个 NIC 的目录
要在 VM 上创建具有多个 NIC 的目录，请执行以下操作：
- 从 交付控制器 主机打开 PowerShell 窗口。
- 运行
asnp citrix*以加载 思杰 专用的 PowerShell 模块。 - 如果尚未创建身份池，请创建一个。
- 创建预配的方案：
-
如果要创建非计算机配置文件型计算机目录，请运行
New-ProvScheme命令并使用NetworkMappings参数。您可以将多个子网添加到参数NetworkMappings。例如：New-Provscheme -NetworkMappings @{"0"="subnetpath1";"1"="subnetpath1"} <!--NeedCopy--> -
如果要创建计算机配置文件型计算机目录：
- 在 Azure 中创建具有多个 NIC 的 VM。有关信息，请参阅 创建和管理具有多个 NIC 的 Windows 虚拟机。您还可以创建新的 VM，然后在 Azure 门户的“网络”页面中附加网络接口。
- 运行
New-ProvScheme命令，并将 VM 作为计算机配置文件输入。
注意：
创建基于计算机配置文件的计算机目录时，
NetworkMappings的数量必须与计算机配置文件的NetworkInterfaceCount相同。NetworkInterfaceCount可以从Get-item -Path "machine profile path"的AdditionalData中检索。
-
- 完成目录创建。
更新目录以使虚拟机具有多个 NIC
要更新目录以使虚拟机具有多个 NIC，请执行以下操作：
- 从交付控制器主机打开 PowerShell 窗口。
- 运行
asnp citrix*以加载 思杰 专用的 PowerShell 模块。 -
对预配方案进行更新：
-
如果创建非基于计算机配置文件的计算机目录，请运行带
NetworkMappings参数的Set-ProvScheme命令。您可以向参数NetworkMappings添加多个子网。例如：Set-Provscheme -NetworkMappings @{"0"="subnetpath1";"1"="subnetpath1"} <!--NeedCopy--> -
如果创建基于计算机配置文件的计算机目录：
- 在 Azure 中创建具有多个 NIC 的虚拟机。有关信息，请参阅创建和管理具有多个 NIC 的 Windows 虚拟机。
- 运行
Set-ProvScheme命令，并将虚拟机作为计算机配置文件输入。
-
更新现有虚拟机以使虚拟机具有多个 NIC
您还可以使用 Set-ProvVMUpdateTimeWindow 更新现有虚拟机，并在更新时间窗口内对现有虚拟机执行电源循环。
预配已安装 Azure Monitor 代理的目录虚拟机
Azure 监控是一项服务，可用于收集、分析和处理来自 Azure 和本地环境的遥测数据。
Azure Monitor Agent (AMA) 从虚拟机等计算资源收集监控数据，并将数据传送到 Azure Monitor。它目前支持收集事件日志、系统日志和性能指标，并将其发送到 Azure Monitor 指标和 Azure Monitor 日志数据源。
为了通过唯一标识监控数据中的 VM 来启用监控，您可以预配安装了 AMA 作为扩展的 MCS 计算机目录的 VM。
先决条件
-
权限：确保您拥有 (/zh-cn/citrix-virtual-apps-desktops/2507-ltsr/install-configure/connections/connection-azure-resource-manager#required-azure-permissions) 中指定的最低 Azure 权限以及以下使用 Azure Monitor 的权限：
Microsoft.Compute/virtualMachines/extensions/readMicrosoft.Compute/virtualMachines/extensions/writeMicrosoft.Insights/DataCollectionRuleAssociations/ReadMicrosoft.Insights/dataCollectionRuleAssociations/writeMicrosoft.Insights/DataCollectionRules/Read
- 数据收集规则：在 Azure 门户中设置数据收集规则。有关设置 DCR 的信息，请参阅 创建数据收集规则。DCR 是特定于平台的（Windows 或 Linux）。请确保根据所需的平台创建 DCR。 AMA 使用数据收集规则 (DCR) 来管理资源（例如 VM）与数据源（例如 Azure Monitor 指标和 Azure Monitor 日志）之间的映射。
- 默认工作区：在 Azure 门户中创建工作区。有关创建工作区的信息，请参阅创建 Log Analytics 工作区。当您收集日志和数据时，信息会存储在工作区中。工作区具有唯一的工作区 ID 和资源 ID。工作区名称对于给定的资源组必须是唯一的。创建工作区后，配置数据源和解决方案以将其数据存储在工作区中。
- 已将监视扩展列入白名单：扩展
AzureMonitorWindowsAgent和AzureMonitorLinuxAgent是 Citrix 定义的白名单扩展。要查看白名单扩展列表，请使用 PoSH 命令Get-ProvMetadataConfiguration。 - 主映像：Microsoft 建议在从现有计算机创建新计算机之前，先从现有计算机中删除扩展。如果未删除扩展，可能会导致残留文件和意外行为。有关详细信息，请参阅如果 VM 是从现有 VM 重新创建的。
要预配已启用 AMA 的目录 VM：
-
设置计算机配置文件模板。
-
如果要使用 VM 作为计算机配置文件模板：
- 在 Azure 门户上创建 VM。
- 启动 VM。
- 在 资源 下将 VM 添加到数据收集规则。这会在模板 VM 上调用代理安装。
注意：
如果必须创建 Linux 目录，请设置 Linux 计算机。
-
如果要使用模板规范作为计算机配置文件模板：
- 设置模板规范。
-
将以下扩展和数据收集规则关联添加到生成的模板规范：
{ "type": "Microsoft.Compute/virtualMachines/extensions", "apiVersion": "2022-03-01", "name": "<vm-name>/AzureMonitorWindowsAgent", "dependsOn": [ "Microsoft.Compute/virtualMachines/<vm-name>" ], "location": "<azure-region>", "properties": { "publisher": "Microsoft.Azure.Monitor", "type": "AzureMonitorWindowsAgent", "typeHandlerVersion": "1.0", "autoUpgradeMinorVersion": true, "enableAutomaticUpgrade": true } }, { "type": "Microsoft.Insights/dataCollectionRuleAssociations", "apiVersion": "2021-11-01", "name": "<associatio-name>", "scope": "Microsoft.Compute/virtualMachines/<vm-name>", "dependsOn": [ "Microsoft.Compute/virtualMachines/<vm-name>", "Microsoft.Compute/virtualMachines/<vm-name>/extensions/AzureMonitorWindowsAgent" ], "properties": { "description": "Association of data collection rule. Deleting this association will break the data collection for this Arc server.", "dataCollectionRuleId": "/subscriptions/<azure-subscription>/resourcegroups/<azure-resource-group>/providers/microsoft.insights/datacollectionrules/<azure-data-collection-rule>" } } <!--NeedCopy-->
-
-
创建或更新现有 MCS 计算机目录。
-
要创建新的 MCS 目录：
- 在 Web Studio 中选择该 VM 或模板规范作为计算机配置文件。
- 继续执行后续步骤以创建目录。
-
要更新现有 MCS 目录，请使用以下 PoSH 命令：
-
要让新 VM 获取更新的计算机配置文件模板，请运行以下命令：
Set-ProvScheme -ProvisioningSchemeName "name" -MachineProfile "XDHyp:\HostingUnits\Unit1\machineprofile.folder\abc.resourcegroup\ab-machine-profile.vm" <!--NeedCopy--> -
要使用更新的计算机配置文件模板更新现有 VM：
Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -StartsNow -DurationInMinutes -1 <!--NeedCopy-->
-
-
- 启动目录 VM。
- 转到 Azure 门户，检查监视器扩展是否已安装在 VM 上，以及 VM 是否显示在 DCR 的资源下。几分钟后，监视数据将显示在 Azure Monitor 上。
故障排除
有关 Azure Monitor Agent 故障排除指南的信息，请参阅以下内容：
- https://learn.microsoft.com/zh-cn/azure/azure-monitor/agents/azure-monitor-agent-troubleshoot-windows-vm/
- https://learn.microsoft.com/zh-cn/azure/azure-resource-manager/troubleshooting/create-troubleshooting-template/
使用客户管理的加密密钥创建计算机目录
使用客户管理的加密密钥创建计算机目录的详细步骤如下：
- Open a PowerShell window.
- 请执行
asnp citrix*，以便加载那些专门用于 Citrix 平台的 PowerShell 模块。 - 输入
cd xdhyp:/。 - 输入
cd .\HostingUnits\(your hosting unit)。 - 输入
cd diskencryptionset.folder。 - 输入
dir以获取磁盘加密集的列表。 - 复制磁盘加密集的 ID。
-
创建自定义属性字符串以包含磁盘加密集的 ID。例如：
$customProperties = "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"> <Property xsi:type=`"StringProperty`" Name=`"StorageAccountType`" Value=`"Standard_LRS`" /> <Property xsi:type=`"StringProperty`" Name=`"persistWBC`" Value=`"False`" /> <Property xsi:type=`"StringProperty`" Name=`"PersistOsDisk`" Value=`"false`" /> <Property xsi:type=`"StringProperty`" Name=`"UseManagedDisks`" Value=`"true`" /> <Property xsi:type=`"StringProperty`" Name=`"DiskEncryptionSetId`" Value=`"/subscriptions/0xxx4xxx-xxb-4bxx-xxxx-xxxxxxxx/resourceGroups/abc/providers/Microsoft.Compute/diskEncryptionSets/abc-des`"/> </CustomProperties> <!--NeedCopy--> -
如果尚未创建，请创建身份池。例如：
New-AcctIdentityPool -IdentityPoolName idPool -NamingScheme ms## -Domain def.local -NamingSchemeType Numeric <!--NeedCopy--> -
Run the New-ProvScheme command: For example:
New-ProvScheme -CleanOnBoot -HostingUnitName "name" -IdentityPoolName "name" -InitialBatchSizeHint 1 -MasterImageVM "XDHyp:\HostingUnits\azure-res2\image.folder\def.resourcegroup\def.snapshot" -NetworkMapping @{"0"="XDHyp:\HostingUnits\azure-res2\\virtualprivatecloud.folder\def.resourcegroup\def-vnet.virtualprivatecloud\subnet1.network"} -ProvisioningSchemeName "name" -ServiceOffering "XDHyp:\HostingUnits\azure-res2\serviceoffering.folder\Standard_DS2_v2.serviceoffering" -MachineProfile "XDHyp:\HostingUnits\<adnet>\machineprofile.folder\<def.resourcegroup>\<machine profile vm.vm>" -CustomProperties $customProperties <!--NeedCopy--> - 完成创建计算机目录。
创建具有双重加密的计算机目录
您可以使用 Web Studio 和 PowerShell 命令创建和更新具有双重加密的计算机目录。
创建具有双重加密的计算机目录的详细步骤如下：
- 使用平台管理和客户管理的密钥创建 Azure Key Vault 和 DES。有关如何创建 Azure Key Vault 和 DES 的信息，请参阅使用 Azure 门户为托管磁盘启用静态双重加密。
- 要浏览您的托管连接中可用的 DiskEncryptionSets：
- 打开一个 PowerShell 命令行窗口。
- 运行以下 PowerShell 命令行命令：
asnp citrix*cd xdhyp:cd HostingUnits-
cd YourHostingUnitName(ex. azure-east) cd diskencryptionset.folderdir
您可以使用
DiskEncryptionSet的 ID 通过自定义属性创建或更新目录。 - 如果要使用计算机配置文件工作流，请创建 VM 或模板规范作为计算机配置文件输入。
- 如果要使用 VM 作为计算机配置文件输入：
- 在 Azure 门户中创建 VM。
- 导航到 Disks>Key management（磁盘>密钥管理）以使用任何
DiskEncryptionSetID直接加密 VM。
- 如果要使用模板规范作为计算机配置文件输入：
- 在模板中，在
properties>storageProfile>osDisk>managedDisk下，添加diskEncryptionSet参数并添加双重加密 DES 的 ID。
- 在模板中，在
- 如果要使用 VM 作为计算机配置文件输入：
- 创建计算机目录。
- 如果使用 Web Studio，除了创建计算机目录 中的步骤外，还要执行以下操作之一。
- 如果您不使用基于计算机配置文件的工作流，请在磁盘设置页面上，选择使用以下密钥加密每台计算机上的数据。然后，从下拉菜单中选择您的双重加密 DES。继续创建目录。
- 如果使用计算机配置文件工作流，请在映像页面上，选择主映像和计算机配置文件。确保计算机配置文件在其属性中具有磁盘加密集 ID。
目录中创建的所有计算机都通过与您选择的 DES 关联的密钥进行双重加密。
- 如果使用 PowerShell 命令，请执行以下操作之一：
-
如果未使用基于计算机配置文件的流程，请在
New-ProvScheme命令中添加自定义属性DiskEncryptionSetId。例如：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="DiskEncryptionSetId" Value="/subscriptions/12345678-xxxx-1234-1234-123456789012/resourceGroups/Sample-RG/providers/Microsoft.Compute/diskEncryptionSets/SampleEncryptionSet" /> </CustomProperties>' -HostingUnitName "Redacted" -IdentityPoolName "Redacted" -InitialBatchSizeHint 1 -MasterImageVM "Redacted" -NetworkMapping @{"0"="Redacted"} -ProvisioningSchemeName "Redacted" -ServiceOffering "Redacted" <!--NeedCopy--> -
如果使用基于计算机配置文件的流程，请在
New-ProvScheme命令中使用计算机配置文件输入。例如：New-ProvScheme -CleanOnBoot -HostingUnitName azure-east -IdentityPoolName aio-ip -InitialBatchSizeHint 1 -MasterImageVM XDHyp:\HostingUnits\azure-east\image.folder\abc.resourcegroup\fgb-vda-snapshot.snapshot -NetworkMapping @{"0"="XDHyp:\HostingUnits\azure-east\virtualprivatecloud.folder\apa-resourceGroup.resourcegroup\apa-resourceGroup-vnet.virtualprivatecloud\default.network"} -ProvisioningSchemeName aio-test -MachineProfile XDHyp:\HostingUnits\azure-east\machineprofile.folder\abc.resourcegroup\abx-mp.templatespec\1.0.0.templatespecversion <!--NeedCopy-->
-
- 如果使用 Web Studio，除了创建计算机目录 中的步骤外，还要执行以下操作之一。
- 使用远程 PowerShell SDK 完成目录创建。有关如何使用远程 PowerShell SDK 创建目录的信息，请参阅 https://developer-docs.citrix.com/projects/citrix-virtual-apps-desktops-sdk/en/latest/creating-a-catalog/。目录中创建的所有计算机都通过与您选择的 DES 关联的密钥进行双重加密。
将未加密的目录转换为使用双重加密
您可以更新计算机目录的加密类型（使用自定义属性或计算机配置文件）。
-
如果未使用基于计算机配置文件的流程，请在
Set-ProvScheme命令中添加自定义属性 DiskEncryptionSetId。例如：Set-ProvScheme -ProvisioningSchemeName "SampleProvSchemeName" -CustomProperties '<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <Property xsi:type="StringProperty" Name="DiskEncryptionSetId" Value="/subscriptions/12345678-xxxx-1234-1234-123456789012/resourceGroups/Sample-RG/providers/Microsoft.Compute/diskEncryptionSets/SampleEncryptionSet" /> </CustomProperties>' <!--NeedCopy--> -
如果使用基于计算机配置文件的流程，请在
Set-ProvScheme命令中使用计算机配置文件输入。例如：Set-ProvScheme -ProvisioningSchemeName mxiao-test -MachineProfile XDHyp:\HostingUnits\azure-east\machineprofile.folder\aelx.resourcegroup\elx-mp.templatespec\1.0.0.templatespecversion <!--NeedCopy-->
成功后，您在目录中添加的所有新 VM 都将通过与您选择的 DES 关联的密钥进行双重加密。
验证目录是否已双重加密
-
In the Web Studio:
- 导航到 计算机目录。
- 选择要验证的目录。单击屏幕底部附近的 模板属性 选项卡。
- 在 Azure 详细信息 下，验证 磁盘加密集 中的磁盘加密集 ID。如果目录的 DES ID 为空，则表示目录未加密。
- 在 Azure 门户中，验证与 DES ID 关联的 DES 的加密类型是平台管理的和客户管理的密钥。
-
使用 PowerShell 命令进行操作：
- 打开 PowerShell 命令行窗口。
- 运行
asnp citrix*以加载 思杰 特定的 PowerShell 模块。 -
使用
Get-ProvScheme获取计算机目录的信息。例如：Get-ProvScheme -ProvisioningSchemeName "SampleProvSchemeName" <!--NeedCopy--> -
检索计算机目录的 DES ID 自定义属性。例如：
<Property xsi:type="StringProperty" Name="DiskEncryptionSetId" Value="/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/Sample-RG/providers/Microsoft.Compute/diskEncryptionSets/SampleEncryptionSet" /> <!--NeedCopy--> - 在 Azure 门户中，验证与 DES ID 关联的 DES 的加密类型是平台管理的和客户管理的密钥。
创建具有 Azure 临时磁盘的目录
要使用临时磁盘，在运行 New-ProvScheme 时，必须将自定义属性 UseEphemeralOsDisk 设置为 true。
注意：
如果自定义属性
UseEphemeralOsDisk设置为 false 或未指定值，则所有预配的 VDA 将继续使用预配的操作系统磁盘。
以下是可在预配方案中使用的自定义属性示例集：
"CustomProperties": [
{
"Name": "UseManagedDisks",
"Value": "true"
},
{
"Name": "StorageType",
"Value": "Standard_LRS"
},
{
"Name": "UseSharedImageGallery",
"Value": "true"
},
{
"Name": "SharedImageGalleryReplicaRatio",
"Value": "40"
},
{
"Name": "SharedImageGalleryReplicaMaximum",
"Value": "10"
},
{
"Name": "LicenseType",
"Value": "Windows_Server"
},
{
"Name": "UseEphemeralOsDisk",
"Value": "true"
}
],
<!--NeedCopy-->
为目录配置一个临时磁盘
要为目录配置 Azure 临时操作系统磁盘，请在 Set-ProvScheme 中使用 UseEphemeralOsDisk 参数。将 UseEphemeralOsDisk 参数的值设置为 true。
注意：
要使用此功能，您还必须启用参数
UseManagedDisks和UseSharedImageGallery。
例如：
Set-ProvScheme -ProvisioningSchemeName catalog-name -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="UseSharedImageGallery" Value="true" />
<Property xsi:type="StringProperty" Name="UseEphemeralOsDisk" Value="true" />
</CustomProperties>'
<!--NeedCopy-->
临时磁盘的重要注意事项
要使用 New-ProvScheme 预配临时操作系统磁盘，请考虑以下限制：
- 用于目录的 VM 大小必须支持临时操作系统磁盘。
- 与 VM 大小关联的缓存或临时磁盘的大小必须大于或等于操作系统磁盘的大小。
- 临时磁盘大小必须大于缓存磁盘大小。
此外，在以下情况下也要考虑这些问题：
- 进行预配方案的创建。
- 进行预配方案的修改。
- 更新映像。
Azure 专用主机
您可以使用 MCS 在 Azure 专用主机上预配 VM。在 Azure 专用主机上预配 VM 之前：
- 创建主机组。
- 在该主机组中创建主机。
- 确保已预留足够的主机容量，以供创建目录和虚拟机使用。
您可以通过以下 PowerShell 脚本创建具有主机租用定义的计算机目录：
New-ProvScheme <otherParameters> -CustomProperties '<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Property xsi:type="StringProperty" Name="HostGroupId" Value="myResourceGroup/myHostGroup" />
...other Custom Properties...
</CustomProperties>
<!--NeedCopy-->
使用 MCS 在 Azure 专用主机上预配虚拟机时，请考虑：
- 专用主机是目录属性，目录创建后无法更改。Azure 目前不支持专用租用。
- 使用
HostGroupId参数时，需要一个在托管单元区域中预配置的 Azure 主机组。 - 需要 Azure 自动放置。此功能会发出请求以载入与主机组关联的订阅。有关详细信息，请参阅 Azure 专用主机上的 VM 规模集 - 公共预览版。如果未启用自动放置，MCS 会在目录创建期间引发错误。
使用 Azure 计算库映像创建或更新计算机目录
选择用于创建计算机目录的映像时，可以选择在 Azure 计算库中创建的映像。
要使这些映像显示，您必须：
- 配置 思杰虚拟应用和桌面 站点。
- 连接到 Azure 资源管理器。
- 在 Azure 门户中，创建资源组。有关详细信息，请参阅 使用门户创建 Azure 计算库。
- 在资源组中，创建 Azure 计算库。
- 在 Azure 计算库中，创建映像定义。
- 在映像定义中，创建映像版本。
使用以下 PowerShell 命令，通过 Azure 计算库中的映像创建或更新计算机目录：
- 打开 PowerShell 命令行窗口。
- 运行
asnp citrix*以加载 思杰 专用的 PowerShell 模块。 -
选择一个资源组，然后列出该资源组的所有库。
Get-ChildItem -LiteralPath @("XDHyp:\HostingUnits\testresource\image.folder\sharedImageGalleryTest.resourcegroup") <!--NeedCopy--> -
选择一个库，然后列出该库的所有映像定义。
Get-ChildItem -LiteralPath @("XDHyp:\HostingUnits\testresource\image.folder\sharedImageGalleryTest.resourcegroup\sharedImageGallery.sharedimagegallery") <!--NeedCopy--> -
选择一个映像定义，然后列出该映像定义的所有映像版本。
Get-ChildItem -LiteralPath @("XDHyp:\HostingUnits\testresource\image.folder\sharedImageGalleryTest.resourcegroup\sharedImageGallery.sharedimagegallery\sigtestimage.imagedefinition") <!--NeedCopy--> - 使用以下元素创建和更新 MCS 目录：
- 一个资源组
- 库
- 图库映像定义
- 图库映像版本
有关如何使用远程 PowerShell SDK 创建目录的信息，请参阅 https://developer-docs.citrix.com/projects/citrix-virtual-apps-desktops-sdk/en/latest/creating-a-catalog/。
配置共享映像库设置
使用 New-ProvScheme 命令创建支持共享映像库的预配方案。使用 Set-ProvScheme 命令为预配方案启用或禁用此功能，并更改副本比率和副本最大值。
预配方案中添加了三个自定义属性以支持共享映像库功能：
UseSharedImageGallery
- 定义是否使用共享映像库存储已发布的映像。如果设置为 True，则映像存储为共享映像库映像，否则映像存储为快照。
- 有效值为 真 和 假。
- 如果未定义此属性，则默认值为 False。
SharedImageGalleryReplicaRatio
- 定义计算机与图库映像版本副本的比率。
- 有效值为大于 0 的整数。
- 如果未定义此属性，则使用默认值。持久性操作系统磁盘的默认值为 1000，非持久性操作系统磁盘的默认值为 40。
SharedImageGalleryReplicaMaximum
- 定义了每个图库映像版本的最大副本数。
- 如果未定义此属性，则默认值为 100。
- 如果未定义此属性，则默认值为 100。
提示：
当使用共享映像库存储 MCS 预配目录的已发布映像时，MCS 会根据目录中的计算机数量、副本比率和最大副本数来设置图库映像版本副本计数。副本计数是通过将目录中的计算机数量除以副本比率（向上舍入到最接近的整数值），然后将该值限制为最大副本数来计算的。例如，如果副本比率为 20，最大值为 5，则 0-20 台计算机有一个副本，21-40 台计算机有两个副本，41-60 台计算机有三个副本，61-80 台计算机有四个副本，81+ 台计算机有五个副本。
用例：更新共享映像库副本比率和最大副本数
现有计算机目录使用共享映像库。使用 Set-ProvScheme 命令更新目录中所有现有计算机和任何未来计算机的自定义属性：
Set-ProvScheme -ProvisioningSchemeName catalog-name -CustomProperties '<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <Property xsi:type="StringProperty" Name="StorageType" Value="Standard_LRS"/> <Property xsi:type="StringProperty" Name="UseManagedDisks" Value="True"/> <Property xsi:type="StringProperty" Name="UseSharedImageGallery" Value="True"/> <Property xsi:type="IntProperty" Name="SharedImageGalleryReplicaRatio" Value="30"/> <Property xsi:type="IntProperty" Name="SharedImageGalleryReplicaMaximum" Value="20"/></CustomProperties>'
<!--NeedCopy-->
用例：将快照机器目录转换为共享映像库机器目录
对于此用例：
- 运行
Set-ProvScheme，并将UseSharedImageGallery标志设置为 True。可以选择包括SharedImageGalleryReplicaRatio和SharedImageGalleryReplicaMaximum属性。 - 更新目录。
- 重新启动计算机以强制更新。
例如：
Set-ProvScheme -ProvisioningSchemeName catalog-name -CustomProperties '<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <Property xsi:type="StringProperty" Name="StorageType" Value="Standard_LRS"/> <Property xsi:type="StringProperty" Name="UseManagedDisks" Value="True"/> <Property xsi:type="StringProperty" Name="UseSharedImageGallery" Value="True"/> <Property xsi:type="IntProperty" Name="SharedImageGalleryReplicaRatio" Value="30"/> <Property xsi:type="IntProperty" Name="SharedImageGalleryReplicaMaximum" Value="20"/></CustomProperties>'
<!--NeedCopy-->
提示：
参数
SharedImageGalleryReplicaRatio和SharedImageGalleryReplicaMaximum不是必需的。在Set-ProvScheme命令完成后，共享映像库映像尚未创建。一旦目录配置为使用该库，下一次目录更新操作会将发布的映像存储在库中。目录更新命令会创建库、库映像和映像版本。重新启动计算机会更新它们，此时（如果适用）副本计数也会更新。从那时起，所有现有的非持久性计算机都将使用共享映像库映像进行重置，所有新预配的计算机都将使用该映像创建。旧快照将在几小时内自动清理。
用例：将共享映像库机器目录转换为快照机器目录
对于此用例：
- 运行
Set-ProvScheme，并将UseSharedImageGallery标志设置为 False 或未定义。 - 更新目录。
- 重新启动计算机以强制更新。
例如：
Set-ProvScheme -ProvisioningSchemeName catalog-name -CustomProperties '<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <Property xsi:type="StringProperty" Name="StorageType" Value="Standard_LRS"/> <Property xsi:type="StringProperty" Name="UseManagedDisks" Value="True"/> <Property xsi:type="StringProperty" Name="UseSharedImageGallery" Value="False"/></CustomProperties>'
<!--NeedCopy-->
提示：
与从快照更新到共享映像库目录不同，每台计算机的自定义数据尚未更新以反映新的自定义属性。运行以下命令以查看原始共享映像库自定义属性：
Get-ProvVm -ProvisioningSchemeName catalog-name。在Set-ProvScheme命令完成后，映像快照尚未创建。一旦目录配置为不使用库，下一次目录更新操作会将发布的映像存储为快照。从那时起，所有现有的非持久性计算机都将使用快照进行重置，所有新预配的计算机都将从快照创建。重新启动计算机将更新它们，此时自定义计算机数据将更新以反映UseSharedImageGallery设置为 False。旧的共享映像库资产（库、映像和版本）将在几小时内自动清理。
将计算机预配到指定的可用性区域
您可以将计算机预配到 Azure 环境中的特定可用性区域。您可以使用 PowerShell 实现此目的。
注意：
如果未指定任何区域，MCS 将允许 Azure 在该区域内放置计算机。如果指定了多个区域，MCS 将在这些区域之间随机分发计算机。
通过 PowerShell 配置可用性区域
使用 PowerShell，您可以通过使用 Get-Item 查看产品目录项。例如，要查看 美国东部区域 Standard_B1ls 服务产品：
$serviceOffering = Get-Item -path "XDHyp:\Connections\my-connection-name\East US.region\serviceoffering.folder\Standard_B1ls.serviceoffering"
<!--NeedCopy-->
要查看区域，请对该项使用 AdditionalData 参数：
$serviceOffering.AdditionalData
如果未指定可用性区域，则计算机的预配方式不会改变。
要通过 PowerShell 配置可用性区域，请使用 New-ProvScheme 操作提供的 Zones 自定义属性。Zones 属性定义了要将计算机预配到的可用性区域列表。这些区域可以包括一个或多个可用性区域。例如，<Property xsi:type="StringProperty" Name="Zones" Value="1, 3"/> 表示区域 1 和 3。
使用 Set-ProvScheme 命令更新预配方案的区域。
如果提供了无效区域，则预配方案不会更新，并且会显示一条错误消息，提供有关如何修复无效命令的说明。
提示：
如果您指定了无效的自定义属性，则预配方案不会更新，并且会显示相关的错误消息。
存储类型
为使用 MCS 的 Azure 环境中的虚拟机选择不同的存储类型。对于目标 VM，MCS 支持：
- 操作系统磁盘：高级 SSD、SSD 或 HDD
- 回写缓存磁盘：高级 SSD、SSD 或 HDD
使用这些存储类型时，请考虑以下事项：
- 确保您的 VM 支持所选的存储类型。
- 如果您的配置使用 Azure 临时磁盘，则不会获得回写缓存磁盘设置选项。
提示：
StorageType配置用于操作系统类型和存储帐户。WBCDiskStorageType配置用于回写缓存存储类型。对于普通目录，StorageType是必需的。如果未配置WBCDiskStorageType，则StorageType将用作WBCDiskStorageType的默认值。
If WBCDiskStorageType is not configured, then StorageType is used as the default for WBCDiskStorageType
配置存储类型
要为 VM 配置存储类型，请在 New-ProvScheme 中使用 StorageType 参数。将 StorageType 参数的值设置为受支持的存储类型之一。
以下是预配方案中 CustomProperties 参数的示例集：
Set-ProvScheme -ProvisioningSchemeName catalog-name -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="StorageType" Value="Premium_LRS" />
<Property xsi:type="StringProperty" Name="LicenseType" Value="Windows_Client" />
</CustomProperties>'
<!--NeedCopy-->
启用区域冗余存储
您可以在目录创建期间选择区域冗余存储。它将您的 Azure 托管磁盘同步复制到多个可用区，这使您能够通过利用其他区域的冗余从一个区域的故障中恢复。
您可以在存储类型自定义属性中指定 Premium_ZRS 和 StandardSSD_ZRS。ZRS 存储可以使用现有自定义属性或通过 MachineProfile 模板进行设置。ZRS 存储还支持带 -StartsNow 和 -DurationInMinutes -1 参数的 Set-ProvVMUpdateTimeWindow 命令，并且您可以将现有计算机从 LRS 存储更改为 ZRS 存储。
限制：
- 仅适用于托管磁盘
- 仅支持高级和标准固态硬盘 (SSD)
- 不支持
StorageTypeAtShutdown - 仅在某些区域可用。
- 大规模创建 ZRS 磁盘时，Azure 的性能会下降。因此，首次开机时，请以较小的批次（每次少于 300 台计算机）开启计算机。
将区域冗余存储设置为磁盘存储类型
您可以在初始目录创建期间选择区域冗余存储，也可以在现有目录中更新存储类型。
使用 PowerShell 命令选择区域冗余存储
在 Azure 中使用 New-ProvScheme PowerShell 命令创建新目录时，请在 StorageAccountType 中使用 Standard_ZRS 作为值。
例如：
<Property xsi:type="StringProperty" Name="StorageAccountType" Value="StandardSSD_ZRS" />
<!--NeedCopy-->
设置此值时，动态 API 会对其进行验证，以确定其是否可以正确使用。如果 ZRS 的使用对您的目录无效，则可能会出现以下异常：
- StorageTypeAtShutdownNotSupportedForZrsDisks: The StorageTypeAtShutdown custom property cannot be used with ZRS storage.
- StorageAccountTypeNotSupportedInRegion: This exception occurs if you try to use ZRS Storage in an Azure Region that does not support ZRS
- ZrsRequiresManagedDisks：您只能将区域冗余存储与托管磁盘一起使用。
您可以使用以下自定义属性设置磁盘存储类型：
StorageTypeWBCDiskStorageTypeIdentityDiskStorageType
注意：
在目录创建期间，如果未设置自定义属性，则使用计算机配置文件的操作系统磁盘
StorageType。
从计算机配置文件捕获 VM 和 NIC 上的诊断设置
您可以在创建计算机目录、更新现有计算机目录以及更新现有 VM 时，从计算机配置文件捕获 VM 和 NIC 上的诊断设置。
您可以将 VM 或模板规范创建为计算机配置文件源。
关键步骤
-
在 Azure 中设置所需的 ID。您必须在模板规范中提供这些 ID。
- 存储帐户
- 日志分析工作区
- 具有标准层定价的事件中心命名空间
- 创建计算机配置文件源。
- 创建新的计算机目录、更新现有目录或更新现有虚拟机。
在 Azure 中设置所需的 ID
在 Azure 中设置以下其中一项：
- 存储帐户
- 日志分析工作区
- 具有标准层定价的事件中心命名空间
设置存储帐户
在 Azure 中创建标准存储帐户。在模板规范中，将存储帐户的完整 resourceId 指定为 storageAccountId。
将虚拟机设置为将数据记录到存储帐户后，可以在 insights-metrics-pt1m 容器下找到数据。
设置日志分析工作区
创建日志分析工作区。在模板规范中，将日志分析工作区的完整 resourceId 指定为 workspaceId。
将虚拟机设置为将数据记录到工作区后，可以在 Azure 的“日志”下查询数据。您可以在 Azure 的“日志”下运行以下命令，以显示资源记录的所有指标的计数：
AzureMetrics
| summarize Count=count() by ResourceId
设置事件中心
在 Azure 门户中设置事件中心，请执行以下操作：
- 创建具有标准层定价的事件中心命名空间。
- 在该命名空间下创建一个事件中心。
- 导航到事件中心下的捕获。打开切换开关以使用 Avro 输出类型进行捕获。
- 在现有存储帐户中创建一个新容器以捕获日志。
- 在模板规范中，按以下格式指定
eventHubAuthorizationRuleId：/subscriptions/093f4c12-704b-4b1d-8339-f339e7557f60/resourcegroups/matspo/providers/Microsoft.EventHub/namespaces/matspoeventhub/authorizationrules/RootManageSharedAccessKey - 指定事件中心的名称。
将 VM 设置为将数据记录到事件中心后，数据将捕获到配置的存储容器中。
创建计算机配置文件源
您可以创建 VM 或模板规范作为计算机配置文件源。
创建基于 VM 的计算机配置文件并包含诊断设置
如果要创建 VM 作为计算机配置文件，请首先在模板 VM 本身设置诊断设置。您可以参考 Microsoft 文档 Azure Monitor 中的诊断设置 中提供的详细说明。
您可以运行以下命令来验证现在是否已将诊断设置与 VM 或 NIC 关联：
az monitor diagnostic-settings list --resource-group matspo --resource matspo-tog-cc2659 --resource-type microsoft.network/networkInterfaces
<!--NeedCopy-->
az monitor diagnostic-settings list --resource-group matspo --resource matspo-tog-cc2 --resource-type microsoft.compute/virtualMachines
<!--NeedCopy-->
创建基于模板规范的计算机配置文件并包含诊断设置
如果要使用已启用诊断设置的 VM 并将其导出到 ARM 模板规范中，则这些设置不会自动包含在模板中。您必须在 ARM 模板中手动添加或修改诊断设置。
但是，如果您希望将 VM 作为计算机配置文件，MCS 会确保准确捕获关键诊断设置并将其应用于 MCS 目录中的资源。
- 创建定义 VM 和 NIC 的标准模板规范。
-
根据规范添加其他资源以部署诊断设置：Microsoft.Insights diagnosticSettings。对于范围，通过名称和部分 ID 引用模板中的 VM 或 NIC。例如，要在模板规范中创建附加到名为 test-VM 的 VM 的诊断设置，请将范围指定为：
"scope": "microsoft.compute/virtualMachines/test-VM", <!--NeedCopy--> - 使用模板规范作为计算机配置文件源。
创建或更新包含诊断设置的目录
创建计算机配置文件源后，您现在可以使用 New-ProvScheme 命令创建计算机目录，使用 Set-ProvScheme 命令更新现有计算机目录，并使用 Request-ProvVMUpdate 命令更新现有 VM。
页面文件位置确定
页面文件位置的确定将依据以下情况进行：
注意：
默认页面文件位置是操作系统磁盘。
| 场景 | 位置 |
|---|---|
| 页面文件设置在自定义属性中指定 | 如在自定义属性中明确指定 |
| 启用了临时操作系统磁盘或休眠 | OS 磁盘 |
| VM 具有临时磁盘 | 临时磁盘 |
| MCS 输入/输出 已启用 | WBC 磁盘 |
页面文件设置方案
下表描述了在映像准备和预配方案更新过程中，页面文件设置可能出现的几种情况：
| 期间 | 方案 | 结果 |
|---|---|---|
| 映像准备阶段 | 您在临时磁盘上设置了源映像页面文件，而您在预配方案中指定的 VM 大小没有临时磁盘 | 页面文件放置在 OS 上 |
| 映像准备阶段 | 您在 OS 磁盘上设置了源映像页面文件，而您在预配方案中指定的 VM 大小具有临时磁盘 | 页面文件放置在临时磁盘上 |
| 映像准备工作 | 您在预配方案中将源映像页面文件设置在临时磁盘上并启用临时操作系统磁盘 | 页面文件放置在操作系统磁盘上 |
| 预配方案更新功能 | 当 VDA 版本早于 2311 时，您尝试更新预配方案 | 修改页面文件设置并发出警告 |
| 预配方案的更新 | 当 VDA 版本为 2311 或更高版本时，您尝试更新预配方案 | 根据 页面文件位置确定 确定页面文件位置 |
指定页面文件设置
使用 PowerShell 命令，您可以指定页面文件设置，包括位置和大小。这会覆盖 MCS 根据 页面文件位置确定 确定的页面文件设置。您可以通过在创建计算机目录期间运行以下 New-ProvScheme 命令来完成此操作。
重要注意事项
在继续创建目录之前，请考虑以下事项：
- You must provide all the custom properties (‘PageFileDiskDriveLetterOverride’, ‘InitialPageFileSizeInMB’, and ‘MaxPageFileSizeInMB’) in the
New-ProvSchemecommand or none of them. - 此功能不支持通过 Citrix Studio。
- 初始页面文件大小必须介于 16 MB 和 16777216 MB 之间。
- 最大页面文件大小必须大于或等于初始页面文件大小，并且小于 16777216 MB。
- 您可以同时将初始页面文件大小和最大页面文件大小设置为零。
注意：
您可以修改现有目录中新添加的 VM 的页面文件设置，而无需更新主映像。要修改页面文件设置，您需要 VDA 2311 或更高版本。您可以使用 PowerShell 命令修改页面文件设置。有关详细信息，请参阅修改页面文件设置。
New-ProvScheme -CleanOnBoot `
-HostingUnitName "zijinnet" `
-IdentityPoolName "PageFileSettingExample" `
-ProvisioningSchemeName "PageFileSettingExample" `
-InitialBatchSizeHint 1 `
-MasterImageVM "XDHyp:\HostingUnits\zijinnet\image.folder\neal-zijincloud-resources.resourcegroup\CustomWin10VDA_OsDisk_1_9473d7c8a6174b2c8284c7d3efeea88f.manageddisk" `
-NetworkMapping @{"0"="XDHyp:\\HostingUnits\\zijinnet\\virtualprivatecloud.folder\\East US.region\\virtualprivatecloud.folder\\neal-zijincloud-resources.resourcegroup\\neal-zijincloud-resources-vnet.virtualprivatecloud\\default.network"} `
-ServiceOffering "XDHyp:\\HostingUnits\\zijinnet\\serviceoffering.folder\\Standard_B2ms.serviceoffering" `
-CustomProperties '<CustomProperties xmlns=" http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi=" http://www.w3.org/2001/XMLSchema-instance"> `
<Property xsi:type="StringProperty" Name="PersistOsDisk" Value="false"/> `
<Property xsi:type="StringProperty" Name="PersistVm" Value="false"/> `
<Property xsi:type="StringProperty" Name="PageFileDiskDriveLetterOverride" Value="d"/> `
<Property xsi:type="StringProperty" Name="InitialPageFileSizeInMB" Value="2048"/> `
<Property xsi:type="StringProperty" Name="MaxPageFileSizeInMB" Value="8196"/> `
<Property xsi:type="StringProperty" Name="StorageAccountType" Value="Premium_LRS"/> `
<Property xsi:type="StringProperty" Name="LicenseType" Value="Windows_Client"/> `
</CustomProperties>'
<!--NeedCopy-->
修改页面文件设置
您可以修改现有目录中新添加的 VM 的页面文件设置，而无需更新主映像。目前，此功能仅适用于 Azure 环境。
要修改页面文件设置，您需要 VDA 2311 或更高版本。您可以使用 PowerShell 命令修改页面文件设置。
以下是您可以在 Azure 环境中修改的各种页面文件设置：
PageFileDiskDriveLetterOverrideInitialPageFileSizeInMBMaxPageFileSizeInMB
修改现有目录的页面文件设置
要修改现有计算机目录的页面文件设置，请运行 Set-ProvScheme 命令。在这种情况下，更新仅应用于添加到目录的新 VM。例如：
Set-ProvScheme -ProvisioningSchemeName $schemeName -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="OsType" Value="Windows" />
<Property xsi:type="StringProperty" Name="StorageType" Value="StandardSSD_LRS" />
<Property xsi:type="StringProperty" Name="PageFileDiskDriveLetterOverride" Value="D" />
<Property xsi:type="StringProperty" Name="InitialPageFileSizeInMB" Value="2048" />
<Property xsi:type="StringProperty" Name="MaxPageFileSizeInMB" Value="8196" />
<Property xsi:type="StringProperty" Name="LicenseType" Value="Windows_Client" />
<Property xsi:type="StringProperty" Name="Zones" Value="1" />
<Property xsi:type="StringProperty" Name="ResourceGroups" Value="neal-test-group1" />
<Property xsi:type="StringProperty" Name="SchemaVersion" Value="2" />
</CustomProperties>'
<!--NeedCopy-->
注意：
如果您启用回写缓存并尝试使用 PowerShell 命令将
PageFileDiskDriveLetterOverride设置为C:，MCS IO 驱动程序会自动将页面文件重定向到正确的磁盘驱动器，而不是C:。
使用 Azure 现成 VM 创建目录
Azure 现成 VM 允许您利用 Azure 未使用的计算容量，从而显著节省成本。但是，分配 Azure 现成 VM 的能力取决于当前的容量和定价。因此，Azure 可能会根据 逐出策略 逐出正在运行的 VM、无法创建 VM 或无法启动 VM。因此，Azure 现成 VM 适用于某些非关键应用程序和桌面。有关详细信息，请参阅 使用 Azure 现成虚拟机。
局限性
-
并非所有 VM 大小都支持 Azure 现成 VM。有关详细信息，请参阅 限制。
您可以运行以下 PowerShell 命令来检查 VM 大小是否支持现成 VM。如果 VM 大小支持现成 VM，则
SupportsSpotVM为 True。(Get-Item "XDHyp:\HostingUnits\azure-res-conn2\serviceoffering.folder\Standard_D2ds_v4.serviceoffering"). AdditionalData <!--NeedCopy--> -
目前，Azure 现成 VM 不支持休眠。
要求事项
在为 Azure 现成 VM 目录创建计算机配置文件源（VM 或模板规范）时，您必须选择 Azure 现成实例（如果使用 VM）或将 priority 设置为 Spot（如果使用模板规范）。
使用 Azure 现成 VM 创建目录的步骤
-
创建计算机配置文件源（VM 或启动模板）。
- 有关使用 Azure 门户创建 VM 的信息，请参阅 使用 Azure 门户部署 Azure 现成虚拟机。
-
要创建模板规范，请在模板规范中的 资源 > 类型: Microsoft.Compute/虚拟机 > 属性 下添加以下属性。例如：
"priority": "Spot", "evictionPolicy": "Deallocate", "billingProfile": { "maxPrice": 0.01 } <!--NeedCopy-->
注意：
- 逐出策略可以是 解除分配 或 删除。
- 对于非持久性 VM，MCS 始终将逐出策略设置为 Delete。如果 VM 被逐出，它将与任何非持久性磁盘（例如，OS 磁盘）一起被删除。任何持久性磁盘（例如，标识磁盘）都不会被删除。但是，如果目录类型是持久性的，或者
PersistOsDisk自定义属性设置为 True，则 OS 磁盘是持久性的。同样，如果PersistWbc自定义属性设置为 True，则 WBC 磁盘是持久性的。 - 对于持久性 VM，MCS 始终将逐出策略设置为 Deallocate。如果 VM 被逐出，它将被解除分配。磁盘不会发生任何更改。
- 最高价格是您每小时愿意支付的价格。如果您使用的是 仅容量，则此值为 -1。最高价格只能为 null、-1 或大于零的十进制数。有关详细信息，请参阅 定价。
-
您可以运行以下 PowerShell 命令来检查计算机配置文件是否启用了 Azure Spot VM。如果
SpotEnabled参数为 True 且SpotEvictionPolicy设置为 Deallocate 或 Delete，则计算机配置文件已启用 Azure Spot VM。例如，-
如果计算机配置文件源是 VM，运行以下命令：
(Get-Item "XDHyp:\HostingUnits\azure-res-conn2\machineprofile.folder\fifthcolumn.resourcegroup\kb-spot-delete.vm"). AdditionalData <!--NeedCopy--> -
如果计算机配置文件源是模板规范，运行以下命令：
(Get-Item "XDHyp:\HostingUnits\azure-res-conn2\machineprofile.folder\fifthcolumn.resourcegroup\fc-aeh-templatespec.templatespec\14.0.0-spot-delete.templatespecversion").AdditionalData <!--NeedCopy-->
-
-
使用
New-ProvSchemePowerShell 命令，通过计算机配置文件创建计算机目录。
您可以使用 Set-ProvScheme 命令更新目录。您还可以使用 PowerShell 命令 Set-ProvVmUpdateTimeWindow 更新现有 VM。计算机配置文件将在下次开机时更新。
运行中的 Azure Spot VM 上的逐出
如果计算容量不可用或每小时价格高于配置的最高价格，Azure 将逐出正在运行的 Spot VM。默认情况下，您不会收到逐出通知。VM 会简单地冻结，然后被逐出。Microsoft 建议使用计划事件来监视逐出。请参阅 持续监视逐出。您还可以从 VM 内部运行脚本，以便在逐出之前收到通知。例如，Microsoft 在 Python 中有一个轮询脚本 ScheduledEvents.cs。
故障排除
- 您可以使用
Get-ProvVM命令在预配的 VM 的 customMachineData 中查看 Spot VM 属性。如果优先级字段设置为 Spot，则表示正在使用 Spot。 -
您可以在 Azure 门户中检查 VM 是否正在使用 Spot：
- 在 Azure 门户中查找 VM。
- 转到“概览”页面。
-
向下滚动到底部，找到“Azure Spot”部分。
- 如果未使用 Spot，则此字段为空。
- 如果正在使用 Spot，则会设置“Azure Spot”和“Azure Spot 逐出策略”字段。
- 您可以在“配置”页面上查看 VM 的计费配置文件或每小时最高价格。
配置备份 VM 大小
公有云有时可能会出现特定 VM 大小的容量不足。此外，如果您使用 Azure Spot VM，则 VM 会根据 Azure 的容量需求随时被逐出。在 Azure 容量不足或 Spot VM 启动失败的情况下，MCS 会回退到备份 VM 大小。您可以在创建或更新 MCS 计算机目录时，使用自定义属性 BackupVmConfiguration 提供备份 VM 大小列表。MCS 会按照您在列表中提供的顺序尝试回退到备份 VM 大小。
当 MCS 为 VM 使用特定的备份配置时，它会继续使用该配置直到下次关机。在下次开机时，MCS 会尝试启动主 VM 配置。如果失败，MCS 会再次尝试按照列表启动备份 VM 大小配置。
此功能支持以下各项：
- 使用计算机配置文件的目录
- 持久和非持久 MCS 计算机目录
- 当前的 Azure 环境
重要注意事项
- 您可以在列表中提供多个备份 VM 大小。
- 列表必须是唯一的。
- 您可以为列表中的每个 VM 添加实例类型属性。类型可以是 Spot 或 Regular。如果未指定类型，则 MCS 会将该 VM 视为 Regular。
- 您可以使用
Set-ProvSchemePowerShell 命令更改现有目录的备份 VM 大小列表。 - 您可以使用
Set-ProvVMUpdateTimeWindow命令更新从与目录关联的预配方案创建的现有 VM。 - 您可以使用
Set-ProvVM命令为选定数量的现有 MCS VM 配置备份 VM 大小列表。但是，要应用更新，请使用Set-ProvVMUpdateTimeWindow为 VM 设置更新时间窗口，并在该窗口内启动 VM。如果对 VM 使用Set-ProvVm命令，则即使以后更新了预配方案上的列表，该 VM 仍会继续使用在该特定 VM 上设置的备份 VM 大小列表。您可以将Set-ProvVM与-RevertToProvSchemeConfiguration结合使用，使 VM 使用预配方案上的备份列表。
创建具有备份 VM 大小的目录
注意：
为解决 Studio UI 冻结问题，请在运行 PowerShell 命令时将所有单引号替换为
"。
- 打开 PowerShell 命令行窗口。
- 运行
asnp citrix*以加载思杰特定的 PowerShell 模块。 - 创建 Broker 目录。此目录将填充即将创建的计算机。
- 创建身份池。这将成为为即将创建的计算机创建的 AD 帐户的容器。
- 使用计算机配置文件创建预配方案。请参阅如何配置备份配置。
- 使用预配方案的唯一 ID 更新 BrokerCatalog。
- 创建 VM 并将其添加到目录。
更新现有的计算机目录
您可以使用 Set-ProvScheme 命令更新预配方案。请参阅 如何配置备份配置。
更新现有 VM
您可以使用 Set-ProvVMUpdateTimeWindow PowerShell 命令更新目录中的现有 VM。该命令会在给定时间窗口内的下次开机时，更新从与目录关联的预配方案创建的 VM。例如：
Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName azure-catalog -StartTimeInUTC "3/12/2022 3am" -DurationInMinutes 60Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName azure-catalog -StartsNow -DurationInMinutes 60
注意：
StartsNow表示计划的开始时间。DurationInMinutes是计划的时间窗口。
您可以使用 Set-ProvVM 命令为选定数量的现有 MCS VM 配置备份 VM 大小列表。但是，要应用更新，请使用 Set-ProvVMUpdateTimeWindow 为 VM 设置更新时间窗口，并在该窗口内启动 VM。例如：
-
运行
Set-ProvVM命令，为选定的现有 MCS VM 配置备份 VM 大小列表。例如：Set-ProvVM -ProvisioningSchemeName "name" -VMName "Vm-001" -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=`"LicenseType`" Value=`"Windows_Server`"/> <Property xsi:type=`"StringProperty`" Name=`"PersistWBC`" Value=`"true`"/> <Property xsi:type=`"StringProperty`" Name=`"BackupVmConfiguration`" Value=`"[{"ServiceOffering": "Standard_D2as_v4", "Type": "Spot"}, {"ServiceOffering": "Standard_D2s_v3", "Type": "Regular"}, {"ServiceOffering": "Standard_D2s_v3", "Type": "Spot"}]`"/> </CustomProperties>" <!--NeedCopy--> -
运行
Set-ProvVMUpdateTimeWindow命令以应用更新。例如：Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName azure-catalog -StartsNow -DurationInMinutes 60 <!--NeedCopy-->
复制所有资源上的标签
您可以将计算机配置文件中指定的标签复制到计算机目录中新 VM 或现有 VM 的所有资源，例如多个 NIC 和磁盘（操作系统磁盘、身份磁盘和回写缓存磁盘）。计算机配置文件源可以是 VM 或 ARM 模板规范。
注意：
您必须添加标签策略（请参阅 分配标签合规性策略定义）或在计算机配置文件源中添加标签，以保留资源上的标签。
必备条件
创建机器配置文件源（VM 或 ARM 模板规范），以便在该 VM 的 VM、磁盘和 NIC 上具有标签。
- 如果您想将 VM 作为机器配置文件输入，请在 Azure 门户中将标签应用于 VM 和所有资源。请参阅使用 Azure 门户应用标签。
-
如果您想将 ARM 模板规范作为机器配置文件输入，请在每个资源下添加以下标签块。
"tags": { "TagC": "Value3" }, <!--NeedCopy-->
注意：
模板规范中最多可以有一个磁盘，并且至少有一个 NIC。
将标签复制到新机器目录中 VM 的资源
- 使用 VM 或 ARM 模板规范作为机器配置文件输入来创建非持久性或持久性目录。
-
将 VM 添加到目录并将其开机。您应该会看到机器配置文件中指定的标签已复制到该 VM 的相应资源。
注意：
如果机器配置文件中提供的 NIC 数量与您希望 VM 使用的 NIC 数量不匹配，则会收到错误。
修改现有 VM 资源上的标签
- 创建包含所有资源上标签的机器配置文件。
-
使用更新的机器配置文件更新现有机器目录。例如：
Set-ProvScheme -ProvisioningSchemeName <YourCatalogName> -MachineProfile <PathToYourMachineProfile> <!--NeedCopy--> - 将需要应用更新的虚拟机关闭。
-
请求 VM 的计划更新。例如：
Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName <YourCatalogName> -VMName machine1 -StartsNow -DurationInMinutes -1 <!--NeedCopy--> - 启动虚拟机。
- 您必须看到计算机配置文件中指定的标签已复制到相应的资源。
注意：
如果计算机配置文件中提供的 NIC 数量与
Set-ProvScheme中提供的 NIC 数量不匹配，则会收到错误。
创建预格式化的 WBC 磁盘目录
您可以创建预格式化的 WBC 磁盘目录，以提高预配计算机的启动性能。要实现此功能，请创建启用了 WBC 的 Azure 目录，并包含一个额外的自定义属性 PreformatWriteBackCache 作为 True。
您可以使用 Set-ProvScheme 命令更新现有目录，以更新 WBC 磁盘大小。
此功能与映像管理工作流兼容，在该工作流中，MCS 将主映像阶段与整个预配工作流分离。有关映像管理的信息，请参阅映像管理。
创建启用了 WBC 且 PreformatWriteBackCache 为 True 的 Azure 目录的示例：
$customProperties = @'
<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Property xsi:type="StringProperty" Name="PreformatWriteBackCache" Value="true" />
</CustomProperties>
'@
New-ProvScheme -CleanOnBoot `
-ProvisioningSchemeName "provisioningschemename" `
-HostingUnitName "hostingunitname" `
-IdentityPoolName "identitypoolnamename" `
-MasterImageVM "XDHyp:\HostingUnits\AzureHostingUnit\image.folder\rg.resourcegroup\masterImage.manageddisk" `
-CustomProperties $customProperties `
-NetworkMapping $networkMapping `
-UseWriteBackCache `
-WriteBackCacheDiskSize 30
<!--NeedCopy-->
更新现有目录的 WBC 磁盘缓存大小的示例：
Set-ProvScheme -ProvisioningSchemeName provisioningschemename -WriteBackCacheDiskSize 127
<!--NeedCopy-->
适用于 MCS 预配的 Citrix Provisioning™ 目录，在关机时删除 WBC 磁盘
在 Azure 中创建 MCS 预配的 Citrix Provisioning 目录时，您可以将 WBC 磁盘预配为非持久性（PersistWBC 为 False）。此配置有助于在关闭 Azure 中 MCS 预配的 Citrix Provisioning 目录的虚拟机后删除回写缓存 (WBC) 磁盘。
条件：
您必须将自定义属性 PreformatWriteBackCache 设置为 True 才能使此功能正常工作。
创建 Azure 目录的示例，其中 PersistWBC 为 False 且 PreformatWriteBackCache 为 True：
$customProperties = @'
<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Property xsi:type="StringProperty" Name="PersistWBC" Value="false" />
<Property xsi:type="StringProperty" Name="PreformatWriteBackCache" Value="true" />
</CustomProperties>
'@
New-ProvScheme -CleanOnBoot `
-ProvisioningSchemeName "provisioningschemename" `
-HostingUnitName "hostingunitname" `
-IdentityPoolName "identitypoolnamename" `
-MasterImageVM "XDHyp:\HostingUnits\AzureHostingUnit\image.folder\rg.resourcegroup\masterImage.manageddisk" `
-CustomProperties $customProperties `
-NetworkMapping $networkMapping `
-UseWriteBackCache `
-WriteBackCacheDiskSize 30
<!--NeedCopy-->
您还可以使用 Set-ProvScheme 命令更新现有目录，以更新 PersistWBC 自定义属性。
从非托管磁盘迁移到托管磁盘
2025 年 9 月 30 日，Azure 将正式停用非托管磁盘（即 VHD）。任何使用非托管磁盘的现有 VM 都将在截止日期后停止并解除分配。
但是，您可以将 MCS 预配的 VM 从非托管磁盘迁移到托管磁盘，这有助于避免因 Azure 的非托管磁盘停用计划而导致的服务中断。
连接到 VM 的所有非托管磁盘都将转换。这包括身份磁盘、操作系统磁盘和 WBC 磁盘（如果使用）。
有关 Azure 非托管磁盘停用计划的更多信息，请参阅 在 2025 年 9 月 30 日之前迁移 Azure 非托管磁盘。
使用场景
此功能适用于持久性和非持久性 MCS 预配的目录。
它还支持按需和非按需（旧版）VM 的迁移：
- 按需 VM：将现有磁盘从非托管磁盘转换为托管磁盘，以符合 Azure 的最新支持。
- 非按需（旧版）VM：旧版或非按需 VM 仅支持非托管磁盘。使用此功能可将旧版 VM 转换为按需 VM，同时迁移到托管磁盘。
有关按需预配的更多信息，请参阅 Azure 按需预配。
局限性
- 一旦计算机目录或 VM 转换为托管磁盘，就无法再转换回非托管磁盘
- 对于非按需（旧版）VM，迁移过程包括将其转换为按需预配。您不能只转换磁盘并继续使用非按需 VM。
重要注意事项
- 转换不会自动发生。它作为开机操作的一部分进行。
- 如果为虚拟机请求了多个更新，则磁盘转换优先。其他更新将推迟到下次开机时进行。
- 虚拟机成功转换并开机后，虚拟机的 VHD 将被清理以节省成本。存储帐户本身不会被清理。
- 存储帐户中可能仍然存在基本磁盘。您可以运行目录更新，然后会创建一个新的快照（或 ACG）基本磁盘。
- 目录中的所有虚拟机都转换完毕并创建了新的基本磁盘后，可以删除空的存储帐户。
所需的权限
您的 Azure 服务主体需要以下权限才能允许从非托管磁盘转换为托管磁盘：
Microsoft.Compute/virtualMachines/convertToManagedDisks/write
<!--NeedCopy-->
配置操作步骤
对于按需目录：
-
运行
Set-ProvScheme（对于持久性虚拟机，则为Set-ProvVM）以将UseManagedDisks更新为True。例如：Set-ProvScheme -ProvisioningSchemeName "<provscheme-name>" -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`" /></CustomProperties>" <!--NeedCopy-->Set-ProvVM -ProvisioningSchemeName "<provscheme-name>" -VMName "<vm-name>" -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`" /></CustomProperties>" <!--NeedCopy--> -
运行
Set-ProvVMUpdateTimeWindow` 以应用更新。在此示例中，更新将在虚拟机下次开机时应用。Set-ProvVmUpdateTimeWindow -ProvisioningSchemeName "<provscheme-name>" -VMName "<vm-name>" <!--NeedCopy--> -
启动虚拟机。
对于非按需（旧版）目录：
-
运行
Set-ProvScheme（对于持久性虚拟机，则为Set-ProvVM）以将Set DeploymentSchema配置为1.1。例如：Set-ProvScheme -ProvisioningSchemeName "<provscheme-name>" -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"><Property xsi:type=`"StringProperty`" Name=`"DeploymentSchema`" Value=`"1.1`" /></CustomProperties>" <!--NeedCopy-->Set-ProvVM -ProvisioningSchemeName "<provscheme-name>" -VMName "<vm-name>" -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"><Property xsi:type=`"StringProperty`" Name=`"DeploymentSchema`" Value=`"1.1`" /></CustomProperties> <!--NeedCopy--> -
运行
Set-ProvVMUpdateTimeWindow以应用更新。在此示例中，更新将在虚拟机下次开机时应用。Set-ProvVmUpdateTimeWindow -ProvisioningSchemeName "<provscheme-name>" -VMName "<vm-name>" <!--NeedCopy--> -
启动虚拟机。
故障排除
如果虚拟机无法从非托管磁盘转换为托管磁盘：
-
验证
UseManagedDisks或DeploymentSchema自定义属性是否已正确设置：- 如果使用
Set-ProvScheme，请通过运行Get-ProvScheme验证 ProvScheme 自定义属性。有关详细信息，请参阅 Get-ProvScheme。 - 如果使用
Set-ProvVM，请通过运行Get-ProvVMConfiguration验证虚拟机是否具有包含更新的自定义属性的新配置。有关详细信息，请参阅 Set-ProvVM。
- 如果使用
-
验证您的 Azure 服务主体中是否存在以下权限：
Microsoft.Compute/virtualMachines/convertToManagedDisks/write
-
运行
Get-ProvOperationEvent以查看预配方案的任何警告。有关详细信息，请参阅 Get-ProvOperationEvent。例如：Get-ProvOperationEvent -LinkedObjectType ProvisioningScheme -LinkedObjectUid <your-provscheme-id> <!--NeedCopy-->
后续步骤
- 如果这是创建的第一个目录，Web Studio 将引导您 创建交付组
- 要查看整个配置过程，请参阅 安装和配置
- 要管理目录，请参阅 管理计算机目录 和 管理 Microsoft Azure 目录
更多信息
在本文中
- 创建计算机目录
- Azure 临时磁盘符合回写缓存磁盘条件的条件
- 非持久性回写缓存磁盘方案
- 创建 Azure 模板规范
- 在创建或更新目录时使用模板规范
- Azure 服务器端加密
- Azure 客户管理的加密密钥
- Azure 主机上的磁盘加密
- 托管磁盘上的双重加密
- 微软 Azure 资源组
- Azure 临时磁盘
- 微软 Azure 计算库
- Azure 机密虚拟机
- 启动完整性监控
- Azure Marketplace
- 创建按需容量预留 VM 目录
- 嵌套式虚拟化
- 仅限 NVMe 的产品型号
- 使用 PowerShell 创建计算机目录
- 创建具有非持久性回写缓存磁盘的目录
- 创建具有持久性回写缓存磁盘的目录
- 使用 MCSIO 提高启动性能
- 使用 PowerShell 创建或更新目录时使用模板规范
- 具有受信任启动的计算机目录
- 使用计算机配置文件属性值
- 创建或更新每个 VM 具有多个 NIC 的目录
- 预配已安装 Azure Monitor 代理的目录虚拟机
- 使用客户管理的加密密钥创建计算机目录
- 创建具有双重加密的计算机目录
- 创建具有 Azure 临时磁盘的目录
- Azure 专用主机
- 使用 Azure 计算库映像创建或更新计算机目录
- 配置共享映像库设置
- 将计算机预配到指定的可用性区域
- 存储类型
- 从计算机配置文件捕获 VM 和 NIC 上的诊断设置
- 页面文件位置确定
- 页面文件设置方案
- 指定页面文件设置
- 修改页面文件设置
- 使用 Azure 现成 VM 创建目录
- 配置备份 VM 大小
- 复制所有资源上的标签
- 创建预格式化的 WBC 磁盘目录
- 适用于 MCS 预配的 Citrix Provisioning™ 目录，在关机时删除 WBC 磁盘
- 从非托管磁盘迁移到托管磁盘
- 后续步骤
- 更多信息