创建红帽 OpenShift 目录（预览版）

June 2, 2026

投稿者:

(/zh-cn/citrix-virtual-apps-desktops/2503/install-configure/machine-catalogs-create.html) 介绍了用于创建计算机目录的向导。以下信息涵盖了 Red Hat OpenShift 虚拟化环境的特定详细信息。

注意：

在创建 Red Hat OpenShift 目录之前，请完成与 Red Hat OpenShift 的连接和托管单元的创建。请参阅 (/zh-cn/citrix-virtual-apps-desktops/2503/install-configure/connections/connection-redhat-openshift.html)。

创建主映像 VM

创建计算机目录需要主映像 VM。

使用您的登录 ID 访问 OpenShift 控制台。
导航到 虚拟化 > 虚拟机 以查看虚拟机列表，包括主映像虚拟机。
创建主映像。创建主映像时，请确保主映像 VM 只有一个存储设备。

注意：

删除在创建主映像 VM 时自动附加的具有 Masquerade 类型和 Pod 网络的默认网络附加定义 (NAD)。此外，请确保根据客户对群集环境的要求，将可路由 NAD 添加到主映像 VM。

当主映像加入域时，在用于目录创建后，它可能会失去域信任。由于 OpenShift 环境的限制，此问题会影响 Citrix Virtual Apps and Desktops™ 2503。解决方法是不在主映像中加入域。Citrix 正在与 Red Hat 合作以增强网络隔离功能。

在 Red Hat OpenShift 虚拟化环境中创建 MCS 计算机目录时，不能使用具有不同操作系统类型的主映像和计算机配置文件。这是因为 Red Hat OpenShift 管理每种操作系统类型的方式。因此，不支持将 Windows VM 用作主映像，而将非 Windows（例如 Linux）VM 用作计算机配置文件，反之亦然。

目前，不支持将使用 InstanceType 创建的 VM 用作主映像。

创建目录

您可以创建 OpenShift 目录，以在您的 OpenShift 环境中创建、交付和电源管理计算机。

使用 Web Studio 创建目录：目前，您只能使用 Web Studio 创建用于计算机交付和电源管理的 OpenShift 目录。
使用 PowerShell 命令创建目录：使用 PowerShell 创建用于计算机创建、交付和电源管理的 OpenShift 目录。

使用 Web Studio 创建目录

目前，您可以使用 Studio 创建 OpenShift 目录，以在您的 OpenShift 环境中交付和管理现有计算机的电源。

在“计算机目录设置”向导中：

在“操作系统”页面上，选择“多会话操作系统或单会话操作系统”。
在“计算机管理”页面上，选择“已进行电源管理的计算机和另一项服务或技术”。
在“虚拟机”页面上，添加计算机及其 Active Directory 计算机帐户。您可以：
- 手动添加计算机：单击“添加计算机”以手动添加计算机。“选择 VM”窗口随即出现。展开您之前创建的 OpenShift 连接，然后选择要添加的节点 (VM)。然后添加关联的计算机帐户名称。
- 使用 CSV 文件添加计算机：单击“添加 CSV 文件”以批量添加计算机。有关使用 CSV 文件添加计算机的信息，请参阅使用 CSV 文件批量将计算机添加到目录。
按照屏幕上的说明完成剩余步骤，这些步骤不包含 OpenShift 特定的信息。

使用 PowerShell 命令创建目录

目前，您只能使用 PowerShell 命令在 Red Hat OpenShift 环境中创建 MCS 计算机目录。您可以创建带或不带计算机配置文件的计算机目录。VM 用作计算机配置文件输入。

打开 PowerShell 命令行窗口。
运行 asnp citrix*。
运行 PowerShell 命令行指令以
1. 创建一个身份池
2. 创建 AD 帐户
3. 创建包含持久性 VM 的 MCS 计算机目录，无论是否使用计算机配置文件。
4. 将 VM 添加到目录
5. 创建代理目录
6. 将代理计算机添加到新 VM

以下是示例脚本：

创建一个身份池

New-AcctIdentityPool `
    -IdentityPoolName "IdentityPoolName" `
    -ZoneUid "00000000-0000-0000-0000-000000000000" `
    -NamingScheme "vm###" `
    -NamingSchemeType "Numeric" `
    -AllowUnicode `
    -Domain "MyDomain.local" `
    -AdminAddress "MyDDC.MyDomain.Local"
<!--NeedCopy-->

创建 AD 帐户

New-AcctADAccount `
    -IdentityPoolUid "11111111-1111-1111-1111-111111111111" `
    -ADUserName "MyDomain\MyUserName" `
    -ADPassword SecurePassword `
    -Count 1 `
    -AdminAddress "MyDDC.MyDomain.Local"
<!--NeedCopy-->

创建包含持久性计算机的预配方案（不带计算机配置文件）

New-ProvScheme `
    -ProvisioningSchemeName "ProvisioningSchemeName" `
    -HostingUnitName "HostingUnitName" `
    -IdentityPoolName "IdentityPoolName" `
    -ProvisioningSchemeType "MCS" `
    -MasterImageVM "XDHyp:\HostingUnits\HostingUnitName\TargetNamespace.namespace\MasterImageVM.vm" `
    -NetworkMapping @{"0" = "XDHyp:\HostingUnits\HostingUnitName\TargetNamespace.namespace\MyNetwork.network" } `
    -VMCpuCount 1 `
    -VMMemoryMB 4096 `
    -InitialBatchSizeHint 1 `
    -AdminAddress "MyDDC.MyDomain.Local"
<!--NeedCopy-->

创建包含持久性计算机的预配方案（带计算机配置文件）

New-ProvScheme `
    -ProvisioningSchemeName "ProvisioningSchemeName" `
    -HostingUnitName "HostingUnitName" `
    -IdentityPoolName "IdentityPoolName" `
    -ProvisioningSchemeType "MCS" `
    -MasterImageVM "XDHyp:\HostingUnits\HostingUnitName\TargetNamespace.namespace\MasterImageVM.vm" `
    -NetworkMapping @{"0" = "XDHyp:\HostingUnits\HostingUnitName\TargetNamespace.namespace\MyNetwork.network" } `
    -VMCpuCount 1 `
    -VMMemoryMB 4096 `
    -InitialBatchSizeHint 1 `
    -AdminAddress "MyDDC.MyDomain.Local" `
    -MachineProfile "XDHyp:\HostingUnits\HostingUnitName\TargetNamespace.namespace\MachineProfileVM.vm"
<!--NeedCopy-->

创建新的 ProvVM

New-ProvVM `
    ProvisioningSchemeName "ProvisioningSchemeName" `
    ADAccountName "MyDomain\vm001" `
    AdminAddress "MyDDC.MyDomain.Local"

Lock-ProvVM `
    -ProvisioningSchemeName "ProvisioningSchemeName" `
    -Tag "Brokered" `
    -VMID "TargetNamespace:vm001"
<!--NeedCopy-->

创建新的代理目录

New-BrokerCatalog `
    -Name "ProvisioningSchemeName" `
    -ProvisioningType "MCS" `
    -SessionSupport "MultiSession" `
    -AllocationType "Random" `
    -PersistUserChanges "OnLocal" `
    -ZoneUid "00000000-0000-0000-0000-000000000000" `
    -AdminAddress "MyDDC.MyDomain.Local"
<!--NeedCopy-->

设置代理目录元数据

Set-BrokerCatalogMetadata `
    -CatalogId "1" `
    -Name "Citrix_DesktopStudio_IdentityPoolUid" `
    -Value "11111111-1111-1111-1111-111111111111"

Set-BrokerCatalog `
    -Name "ProvisioningSchemeName " `
    -ProvisioningSchemeId "22222222-2222-2222-2222-222222222222"
<!--NeedCopy-->

为新的 ProvVM 创建代理计算机

New-BrokerMachine `
    -CatalogUid "33333333-3333-3333-3333-333333333333" `
    -AdminAddress "MyDDC.MyDomain.Local" `
    -MachineName "S-0-0-00-0000000000-0000000000-000000000-000000"
<!--NeedCopy-->

后续步骤

如果这是创建的第一个目录，Web Studio 会引导您创建交付组
要查看整个配置过程，请参阅安装和配置
有关电源管理，请参阅电源管理 Red Hat OpenShift VM