使用 VMware.Image Builder cmdlet，可以利用所有 PowerCLI 功能。

VMware.Image Builder cmdlet 作为 Microsoft PowerShell cmdlet 实施并包含在 PowerCLI 中。可以通过 VMware.Image Builder cmdlet 来利用所有 PowerCLI 功能。具有丰富经验的 PowerShell 用户可以像使用其他 PowerShell cmdlet 一样使用 VMware.Image Builder cmdlet。如果您是 PowerShell 和 PowerCLI 的新用户，请遵循以下提示。

您可以在 PowerCLI shell 中键入 cmdlet、参数和参数值。

  • 通过运行 Get-Help cmdlet_name 获取有关任何 cmdlet 的帮助。
  • 请记住，PowerShell 不区分大小写。
  • 对 cmdlet 名称和参数名称使用 Tab 自动补全。
  • 使用 Format-List 或 Format-Table 或它们的缩写 fl 或 ft 格式化任何变量和 cmdlet 输出。请参见 Get-Help Format-List。
  • 使用通配符搜索和筛选 VIB 及映像配置文件。支持所有通配符表达式。

通过名称传递参数

在大多数情况下，可以通过名称传递参数，并使用双引号将包含空格或特殊字符的参数值引起来。 

Add-EsxSoftwarePackage -ImageProfile profile42 -SoftwarePackage "partner package 35"

将参数作为对象传递

如果希望执行脚本操作并实现自动化，则可以将参数作为对象传递。您可以将此技术用于返回多个对象或返回单个对象的 cmdlet。

  1. 将返回多个对象的 cmdlet 的输出绑定到变量。 
    $profs = Get-EsxImageProfile
  2. 当运行需要将对象作为输入的 cmdlet 时，通过位置访问该对象（列表以 0 开头）。 
    Add-EsxSoftwarePackage -ImageProfile $profs[4] -SoftwarePackage partner-pkg

该示例将指定的软件包添加到 Get-EsxImageProfile 返回的列表中的第五个映像配置文件中。

《vCenter Server 安装和设置》文档中的大多数示例均按名称传递参数。使用 PowerCLI Cmdlet 的 vSphere ESXi Image Builder 工作流中包含将参数作为对象传递的示例。

VMware.ImageBuilder Cmdlet 概览

VMware PowerCLI 的 VMware.Image Builder 组件提供了用于管理软件库中的 VIB、映像配置文件和其他内容的 cmdlet。

vSphere 7.0 及更高版本引入了将 VIB 与旧版公告和修补程序一起打包的新方法，软件库包含基础映像、供应商加载项和组件以及 VIB 和映像配置文件。VMware PowerCLI 12.0 及更高版本提供了用于处理软件库中新内容的 cmdlet。

VMware.ImageBuilder 包含以下 cmdlet。
注： 运行 VMware.ImageBuilder cmdlet 时，请在调用 cmdlet 时在命令行上提供所有参数。不建议以交互模式提供参数。
有关详细参考信息，请在 PowerCLI 提示符处运行 Get-Help cmdlet_name。
表 1. 用于处理软件库中旧内容的 VMware.ImageBuilder Cmdlet
Cmdlet 描述
Add-EsxSoftwareDepot 将指定位置的软件库或 ZIP 文件添加到当前环境。从库中下载元数据，并分析 VIB 的依赖关系。
Remove-EsxSoftwareDepot 从指定的软件库断开连接。
Get-EsxSoftwareDepot 返回当前环境中软件库列表。如果您想要检查和管理映像配置文件及 VIB，则必须首先将相应软件库添加到环境中。
Get-EsxSoftwarePackage 返回软件包对象 (VIB) 的列表。使用此 cmdlet 的选项筛选结果。
Get-EsxImageProfile 从当前添加的所有库返回 ImageProfile 对象的阵列。
New-EsxImageProfile 创建新的映像配置文件。在大多数情况下，建议通过克隆现有配置文件来创建新的配置文件。请参见使用 PowerCLI Cmdlet 克隆映像配置文件。
Set-EsxImageProfile 修改本地 ImageProfile 对象并对已修改配置文件执行验证测试。cmdlet 返回已修改的对象，但不会保留它。
Export-EsxImageProfile 将映像配置文件导出为 ESXi 安装的 ESXi ISO 映像，或者导出为 ZIP 文件。
Compare-EsxImageProfile 返回 ImageProfileDiff 结构，显示这两个配置文件是否具有相同的 VIB 列表和接受程度。请参见使用接受级别。
Remove-EsxImageProfile 从软件库中删除映像配置文件。
Add-EsxSoftwarePackage 向现有映像配置文件添加一个或多个新软件包 (VIB)。
Remove-EsxSoftwarePackage 从映像配置文件中移除一个或多个软件包 (VIB)。
Set-ESXImageProfileAssociation 将指定的映像配置文件与指定的ESXi系统相关联。
表 2. 用于处理软件库中新内容的 VMware.ImageBuilder Cmdlet
Cmdlet 描述
Get-DepotAddons 检索提供软件库中加载项相关基本信息的一系列对象。
Get-DepotBaseImages 检索提供软件库中基础映像相关基本信息的一系列对象。
Get-DepotComponents 检索提供软件库中组件相关基本信息的一系列对象。
Get-DepotInfo 检索位于指定文件路径或 URL 地址的软件库的基本信息。
Get-DepotVibs 检索提供软件库中 VIB 相关基本信息的一系列对象。
New-IsoImage 使用指定文件路径中的指定软件库和软件规范生成 ISO 映像。
New-PxeImage 使用指定文件路径中的指定软件库和软件规范生成 PXE 映像。