Les applets de commande VMware.Image Builder sont implémentées comme des applets de commande Microsoft PowerShell et sont incluses dans PowerCLI. Les utilisateurs des applets de commande VMware.Image Builder peuvent tirer parti de toutes les fonctionnalités PowerCLI.

Les utilisateurs de PowerShell expérimentés peuvent utiliser les applets de commande VMware.Image Builder comme les autres applets de commande PowerShell. Si PowerShell et PowerCLI ne vous sont pas familiers, suivez les conseils ci-dessous.

Vous pouvez taper des cmdlets, des paramètres et des valeurs de paramètres dans le shell PowerCLI.

  • Pour obtenir de l'aide sur un applet de commande, exécutez Get-Help cmdlet_name.
  • Notez que PowerShell ne tient pas compte de la casse.
  • Utilisez la saisie semi automatique pour les noms de cmdlet et de paramètre.
  • Formatez les sorties de variable et de cmdlet en utilisant Format-List ou Format-Table ou leur version abrégée fl ou ft. Reportez-vous à la section Get-Help Format-List.
  • Utilisez des caractères génériques pour rechercher et filtrer des VIB et des profils d'image. Toutes les expressions génériques sont prises en charge.

Envoi des paramètres en fonction du nom

Vous pouvez envoyer les paramètres en fonction du nom dans la plupart des cas et placer entre guillemets doubles les valeurs de paramètres qui contiennent des espaces ou des caractères spéciaux.

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

Envoi des paramètres sous forme d'objets

Vous pouvez envoyer les paramètres sous forme d'objet si vous voulez utiliser des scripts et l'automatisation. Vous pouvez utiliser la technique avec les applets de commande qui retournent plusieurs objets ou les applets de commande qui retournent un seul objet.

  1. Liez à une variable la sortie d'une applet de commande qui retourne plusieurs objets.
    $profs = Get-EsxImageProfile
  2. Lorsque vous exécutez l'applet de commande qui nécessite d'utiliser l'objet comme entrée, accédez à l'objet en fonction de la position avec la liste commençant à 0.
    Add-EsxSoftwarePackage -ImageProfile $profs[4] -SoftwarePackage partner-pkg

L'exemple ajoute le progiciel spécifié au cinquième profil d'image dans la liste retournée par Get-EsxImageProfile.

La plupart des exemples de la Installation et configuration de vCenter Server documentation transmettent les paramètres par nom. Workflows vSphere ESXi Image Builder avec des applets de commande PowerCLI inclut des exemples qui transmettent les paramètres en tant qu'objets.

Présentation des applets de commande VMware.ImageBuilder

Le composant VMware.Image Builder de VMware PowerCLI fournit des applets de commande pour la gestion des VIB, des profils d'image et d'autres contenus dans les dépôts de logiciels.

vSphere 7.0 et versions ultérieures introduisent de nouvelles méthodes de création de modules VIB avec des bulletins et des correctifs hérités, et les dépôts de logiciels contiennent des images de base, des modules complémentaires et des composants fournisseur, ainsi que des VIB et des profils d'image. VMware PowerCLI 12.0 et versions ultérieures fournissent des applets de commande qui fonctionnent avec le nouveau contenu dans les dépôts de logiciels.

VMware.ImageBuilder inclut les applets de commande suivantes.
Note : Lorsque vous exécutez des applets de commande VMware.ImageBuilder, indiquez tous les paramètres sur la ligne de commande lorsque vous appelez l'applet de commande. Il n'est pas recommandé d'indiquer des paramètres en mode interactif.
Exécutez Get-Help cmdlet_name à la suite de l'invite PowerCLI pour obtenir des informations de référence détaillées.
Tableau 1. Applets de commande VMware.ImageBuilder utilisées avec du contenu hérité dans les dépôts de logiciels
Applet de commande Description
Add-EsxSoftwareDepot Ajoute le dépôt de logiciels ou le fichier ZIP à l'emplacement spécifié à votre environnement actuel. Télécharge les métadonnées du dépôt et analyse les bundles VIB pour rechercher les dépendances.
Remove-EsxSoftwareDepot Se déconnecte du dépôt de logiciels défini.
Get-EsxSoftwareDepot Renvoie la liste des dépôts de logiciels qui se trouvent dans l'environnement actuel. Si vous voulez examiner et gérer les profils d'image et les VIB, vous devez préalablement ajouter le dépôt de logiciels correspondant à l'environnement.
Get-EsxSoftwarePackage Renvoie la liste des objets de modules logiciels (VIB). Utilisez les options de cette cmdlet pour filtrer les résultats.
Get-EsxImageProfile Retourne le tableau des objets ImageProfile de tous les dépôts actuellement ajoutés.
New-EsxImageProfile Crée un profil d'image. Dans la plupart des cas, il est recommandé de créer un profil en clonant un profil existant. Reportez-vous à la section Cloner un profil d'image avec des applets de commande PowerCLI.
Set-EsxImageProfile Modifie un objet local ImageProfile et exécute des tests de validation sur le profil modifié. L'applet de commande retourne l'objet modifié, mais ne le fait pas persister.
Export-EsxImageProfile Exporte un profil d'image sous la forme d'une image ISO d'ESXi pour l'installation d'ESXi ou sous la forme d'un fichier ZIP.
Compare-EsxImageProfile Retourne une structure ImageProfileDiff qui indique si les deux profils disposent de la même liste de bundles VIB et du même niveau d'acceptation. Reportez-vous à la section Utilisation des niveaux d'acceptation.
Remove-EsxImageProfile Supprime le profil d'image du dépôt de logiciels.
Add-EsxSoftwarePackage Ajoute un ou plusieurs nouveaux packages (VIB) à un profil d'image existant.
Remove-EsxSoftwarePackage Supprime un ou plusieurs packages (VIB) d'un profil d'image.
Set-ESXImageProfileAssociation Associe le profil d'image spécifié au système ESXi spécifié.
Tableau 2. Applets de commande VMware.ImageBuilder utilisées avec un nouveau contenu dans les dépôts de logiciels
Applet de commande Description
Get-DepotAddons Récupère un tableau d'objets qui fournissent des informations de base sur les modules complémentaires d'un dépôt de logiciels.
Get-DepotBaseImages Récupère un tableau d'objets qui fournissent des informations de base sur les images de base dans un dépôt de logiciels.
Get-DepotComponents Récupère un tableau d'objets qui fournissent des informations de base sur les composants d'un dépôt de logiciels.
Get-DepotInfo Récupère les informations de base sur le dépôt de logiciels situé à l'adresse URL ou au chemin d'accès au fichier spécifié.
Get-DepotVibs Récupère un tableau d'objets qui fournissent des informations de base sur les VIB dans un dépôt de logiciels.
New-IsoImage Génère une image ISO en utilisant le dépôt de logiciels et la spécification logicielle spécifiés dans le chemin d'accès au fichier spécifié.
New-PxeImage Génère une image PXE en utilisant le dépôt de logiciels et la spécification logicielle spécifiés dans le chemin d'accès au fichier spécifié.