Con los cmdlets de VMware.Image Builder, puede aprovechar todas las funciones de PowerCLI.

Los cmdlets de VMware.Image Builder se implementan como cmdlets de Microsoft PowerShell y se incluyen en PowerCLI. Puede aprovechar todas las funciones de PowerCLI mediante cmdlets de VMware.Image Builder. Los usuarios avanzados de PowerShell también pueden utilizar los cmdlets de VMware.Image Builder del mismo modo que otros cmdlets de PowerShell. Si estos son sus primeros pasos con PowerShell y PowerCLI, siga estos consejos.

Puede escribir cmdlets, parámetros y valores de parámetros en el shell de PowerCLI.

  • Obtenga ayuda para cualquier cmdlet a través de Get-Help nombre_del_cmdlet.
  • Recuerde que PowerShell no distingue mayúsculas de minúsculas.
  • Utilice la opción de finalización con tabulación para los nombres de cmdlets y parámetros.
  • Formatee cualquier variable y salida de cmdlet utilizando Format-List o Format-Table o sus formas cortas fl o ft. Consulte Get-Help Format-List.
  • Utilice caracteres comodín para la búsqueda y filtrado de VIB y perfiles de imagen. Son compatibles todas las expresiones con comodines.

Transmitir parámetros por nombre

Puede transmitir parámetros por nombre en la mayoría de los casos y rodear los valores de parámetros que contienen espacios o caracteres especiales con comillas dobles. 

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

Transmitir parámetros como objetos

Puede pasar los parámetros como objetos si desea realizar el scripting y automatización. Puede utilizar la técnica con cmdlets que devuelven varios objetos o con cmdlets que devuelven un solo objeto.

  1. Asocie la salida de un cmdlet que devuelve varios objetos a una variable. 
    $profs = Get-EsxImageProfile
  2. Cuando ejecute el cmdlet que necesita el objeto como entrada, acceda al objeto por posición, con la lista comenzando con 0. 
    Add-EsxSoftwarePackage -ImageProfile $profs[4] -SoftwarePackage partner-pkg

El ejemplo agrega el paquete de software especificado al quinto perfil de imagen de la lista devuelto por Get-EsxImageProfile.

La mayoría de los ejemplos de la documentación Instalar y configurar vCenter Server pasan parámetros por nombre. Flujos de trabajo de vSphere ESXi Image Builder con cmdlets de PowerCLI incluye ejemplos que pasan parámetros como objetos.

Descripción general de los cmdlets de VMware.ImageBuilder

El componente VMware.Image Builder de VMware PowerCLI proporciona cmdlets para administrar VIB, perfiles de imagen y otro contenido en almacenes de software.

vSphere 7.0 y otras versiones posteriores introducen nuevas formas de empaquetar los VIB junto con boletines y revisiones heredados, y los almacenes de software contienen imágenes base, componentes y complementos de proveedor, junto con VIB y perfiles de imagen. VMware PowerCLI 12.0 y versiones posteriores proporcionan cmdlets que funcionan con el nuevo contenido existente en los almacenes de software.

VMware.ImageBuilder incluye los siguientes cmdlets.
Nota: Al ejecutar cmdlets de VMware.ImageBuilder, proporcione todos los parámetros en la línea de comandos cuando invoque el cmdlet. No se recomienda proporcionar parámetros en modo interactivo.
Ejecute Get-Help nombre_del_cmdlet en el símbolo de PowerCLI para obtener información de referencia detallada.
Tabla 1. Cmdlets de VMware.ImageBuilder utilizados con contenido heredado en almacenes de software
Cmdlet Descripción
Add-EsxSoftwareDepot Agregar el almacén de software o el archivo ZIP en la ubicación especificada del entorno actual. Descarga metadatos del almacén y analiza los VIB para comprobar si tienen dependencias.
Remove-EsxSoftwareDepot Se desconecta del almacén de software especificado.
Get-EsxSoftwareDepot Devuelve una lista de almacenes de software que se encuentran en el entorno actual. Si desea examinar y administrar perfiles de imagen y VIB, primero debe agregar el almacén de software correspondiente al entorno.
Get-EsxSoftwarePackage Devuelve una lista de objetos de paquete de software (VIB). Utilice estas opciones del cmdlet para filtrar los resultados.
Get-EsxImageProfile Devuelve una matriz de objetos ImageProfile de todos los almacenes agregados actualmente.
New-EsxImageProfile Crea un nuevo perfil de imagen. En la mayoría de los casos, se recomienda crear un nuevo perfil mediante la clonación de un perfil existente. Consulte Clonar un perfil de imagen con cmdlets de PowerCLI.
Set-EsxImageProfile Modifica un objeto ImageProfile local y realiza pruebas de validación en el perfil modificado. El cmdlet devuelve el objeto modificado pero no lo conserva.
Export-EsxImageProfile Exporta un perfil de imagen como una imagen ISO de ESXi para instalar ESXi, o bien como un archivo ZIP.
Compare-EsxImageProfile Devuelve una estructura ImageProfileDiff que muestra si dos perfiles tienen la misma lista de VIB y el mismo nivel de aceptación. Consulte Trabajar con niveles de aceptación.
Remove-EsxImageProfile Elimina el perfil de imagen del almacén de software.
Add-EsxSoftwarePackage Agrega uno o más paquetes (VIB) nuevos a un perfil de imagen existente.
Remove-EsxSoftwarePackage Elimina uno o más paquetes (VIB) de un perfil de imagen.
Set-ESXImageProfileAssociation Asocia el perfil de imagen especificado con el sistema ESXi especificado.
Tabla 2. Cmdlets de VMware.ImageBuilder utilizados con nuevo contenido en almacenes de software
Cmdlet Descripción
Get-DepotAddons Recupera una matriz de objetos que proporciona información básica sobre los complementos de un almacén de software.
Get-DepotBaseImages Recupera una matriz de objetos que proporciona información básica sobre las imágenes base en un almacén de software.
Get-DepotComponents Recupera una matriz de objetos que proporciona información básica sobre los componentes de un almacén de software.
Get-DepotInfo Recupera información básica acerca del almacén de software ubicado en la ruta de archivos o la dirección URL especificada.
Get-DepotVibs Recupera una matriz de objetos que proporciona información básica sobre los VIB en un almacén de software.
New-IsoImage Genera una imagen ISO usando el almacén de software y la descripción de software especificados en la ruta de archivo indicada.
New-PxeImage Genera una imagen PXE usando el almacén de software y la descripción de software especificados en la ruta de archivo indicada.