使用 PowerShell 创建新的 Citrix PVS 计算机

在另一篇文章中，我介绍了如何创建新的 Citrix MCS（机器创建服务）计算机，该计算机仅需要使用 Citrix Studio cmdlet。另一方面，对于 PVS，我们必须对正在使用的虚拟机管理程序使用 PowerShell cmdlet，在本文中将使用 VMware vSphere、Citrix PVS cmdlet 将设备添加到 PVS，然后使用 Studio cmdlet 将新计算机添加到计算机目录然后到交付组。

为此，我们需要一台机器，最好不是 PVS 服务器或 Delivery Controller，它安装了 VMware PowerCLI、Citrix Studio 和 PVS 控制台，因为这将为我们提供所需的所有 cmdlet。

但是，使用 PowerShell 3.0 及更高版本，您可以使用隐式远程处理从远程计算机导入模块（假设已设置远程管理），这样它们就不需要在本地安装。请注意，我们无法针对此处的用例对 Studio cmdlet 执行此操作，因为我们需要访问由 Citrix 创建的 PowerShell (PS) 驱动器XDHyp：。主机管理单元/模块，不幸的是 PS 驱动器不能使用隐式远程处理。

创建虚拟机

与 MCS 中 Studio cmdlet 创建新 VM 不同，对于 PVS，我们必须使用虚拟机管理程序 cmdlet 自己创建新 VM。本文不讨论查找未使用的机器名称的机制，需要在虚拟机管理程序、PVS、Studio 和 Active Directory 中检查它们是否存在或是否存在。然而，它是可能的，并且在自动添加和删除机器时发挥作用。

在 vSphere 中，我之前为我的 PVS 计算机（服务器 2019）创建了一个模板，其中分配了所需的 CPU、内存和 NIC，并为事件日志配置了 40GB 硬盘驱动器，因此它们是持久的，并且用于 RAM 缓存溢出和页面文件。 New-VM cmdlet 需要此模板的句柄，因此我们首先获取它：

Import-Module -Name VMware.VimAutomation.Core -Verbose:$false
Connect-VIServer -Server yourvcenter
$template = Get-Template -Name $templateName

其中 $templateName 是唯一 vSphere 模板的名称或模式。在脚本中，我们将检查 $template 是否不为 null，也不是数组，因为后者意味着我们没有单个唯一的模板，因此 New-VM > 调用将会失败。

为了New-VM成功，我们至少需要指定一个资源池（通过Get-ResourcePool检索）和一个位置（通过Get-Folder 检索） ）。在我编写的用于创建新 PVS 设备的完整脚本中，可以指定现有 PVS 设备，其资源池和位置用于 New-VM 中的这些参数。

$newVM = New-VM -Template $template -Name $newMachine
-Description $descripticon -ResourcePool $resourcePool
-Location $folder

此操作同步运行，直到 VM 创建完成后才会返回，但由于模板使用大部分为空的精简配置磁盘，因此创建不会花费很长时间。

它可以通过 -RunAsync 参数异步运行，但其使用超出了本文的范围，因为我们需要确保它在继续后续步骤之前已完成。在继续之前，请确保检查 $newVM 不为空，这意味着创建失败。

将机器添加到 PVS

为了将新创建的 VM 添加到 PVS，我们需要拥有将从 PVS 服务器启动的 NIC 的 MAC 地址。我们这样做：

$NICs = Get-NetworkAdapter -VM $newVM

请注意，我们必须检查是否只返回一个 NIC - 我的完整脚本有一个网络名称的可选参数，如有必要，我们可以在其中过滤 NIC。另请注意，VMware 返回带有 : 分隔符的 MAC 地址，但 PVS 要求它们带有 - 分隔符，这可以使用 -replace 轻松修复。

MAC 地址只是我们需要作为参数传递的一条信息 - 我经常使用一种称为“splatting”的技术将参数传递给 cmdlet/函数，因为它允许您在哈希表（字典）中构建参数，然后传递哈希表代替常规参数或与常规参数一起使用。传递给 New-PVSDevice 的示例哈希表可能是：

韦克菲尔德

00-50-56-bd-57-4e

Citrix PVS 机器

XenApps

GLXA19PVS021

然后像这样传递：

Set-PvsConnection -Server yourpvsserver
$newPVSDevice = New-PvsDevice @pvs
$newPVSDevice = New-PvsDevice @pvsdeviceParameters

其中哈希表名为$pvsdeviceParameters，并注意如果需要，可以将用户名、域名和密码传递给Set-PVSConnection（例如，运行脚本的用户没有足够的权限） PVS 权限，但要注意存储/传递明文密码）。

假设调用成功，我们现在有了一个新的 PVS 设备，尽管它没有分配给它的 PVS 启动磁盘。我们使用 Add-PvsDiskLocatorToDevice 来完成此操作，然后通过调用 Add-PvsDeviceToDomain 将其添加到 Active Directory，该函数采用 DeviceName 和 OrganizationUnit 争论。后者要求 OU 采用斜杠分隔形式，例如“站点/韦克菲尔德/计算机/RDS/PVS”。

成功完成这些步骤后，该设备应出现在所选站点和集合的 PVS 控制台中（可能是预先存在的或通过 New-PvsSite 和 New-PvsCollection 新创建的）分别）。

将机器添加到目录

这是该过程中最麻烦的步骤，因为要将计算机添加到 Studio，我们需要知道新添加的虚拟机的托管计算机 ID。我们可以通过 XDHyp: PS 驱动器通过虚拟机管理程序连接来获取它。这是使用 cmdlet Get-Childltem 实现的，您之前可能通过其别名之一使用过该命令 - “dir ”或“Is ”（参见图 1）。

图。 1：Get-ChildItem的输出

请注意，我们传递 -AdminAddress 来指示 cmdlet 在特定的交付控制器上运行，就像我们对所有 Studio cmdlet 所做的那样，最好是通过 splatting。传递 -Verbose:$false 以便 cmdlet 不会生成详细输出，即使已使用 -verbose 或 $verbosePreference 调用包含脚本 内置变量设置为“继续”。

现在，我们可以使用我们希望机器进入的机器目录的 Uid（通过 Get-BrokerCatalog -Name）以及机器的名称来调用 New-BrokerMachine新机器本身、托管机器 ID（来自上面的 Get-ChildItem）以及虚拟机管理程序连接 uid（我们也从 Get-ChildItem 获取），如下所示：

图。 2：带有前面提到的参数的Get-ChildItem的输出

假设此操作成功，该计算机将在 Studio 中所选计算机目录中可见，尽管它尚未添加到交付组（这是最后一步）。

将计算机添加到交付组

用于将计算机从目录添加到交付组的 cmdlet 为 Add-BrokerMachinesToDesktopGroup, 但它的参数不包括要添加的计算机的名称 - 相反，我们告诉它源计算机目录、目标交付组以及我们希望添加的目录中的计算机数量，这实际上是您的方式将通过 Studio 中的用户界面手动执行此操作。

Add-BrokerMachinesToDesktopGroup 返回添加到交付组的计算机数量，因此我们检查该数量是否与我们通过 -Count 参数请求添加的计算机数量相同。
Studio 中的交付组现在应该显示这些新添加的计算机，或者您可以使用 Get-BrokerMachine -DesktopGroupName 检索它们：

图。 3：运行 Get-BrokerMachine -DesktopGroupName 的输出

示例脚本：创建新的 PVS 设备

为了帮助您将新发现的知识直接付诸实践，我创建了一个示例脚本，您可以从 ScriptRunner 的 GitHub 下载该脚本。

它允许您从 VMware vSphere 模板创建新的 Citrix PVS 设备，并可以选择将它们添加到 Citrix 计算机目录和部署组，也可以选择添加到已发布的桌面。

顺便说一句，该脚本与 PowerShell Get-Help 兼容。如果您对脚本还有任何疑问或反馈，请随时与我们联系！

update1 New PVS Devices.ps1:

#requires -version 3