La PowerCLI de VMWare est le moyen de facto de gérer vCenter avec PowerShell. Dans ce tutoriel, vous allez apprendre à partir de zéro ; télécharger, installer et comprendre comment PowerCLI peut vous aider à en faire plus.
Au cours de ce voyage, vous apprendrez :
- Comment repérer les versions historiques de PowerCLI que vous pouvez rencontrer dans les scripts hérités
- Comment installer la version la plus récente de PowerCLI
- Utiliser le code VMware comme ressource
- Comment installer VMware PowerCLI à travers à la fois Windows PowerShell 5.1 et PowerShell 6/7 pour une utilisation multiplateforme.
« À la plupart des égards, VMware PowerCLI est l’interface d’administration la plus cohérente dans l’histoire décennale de l’hyperviseur. »
Le commentaire paraphrasé ci-dessus a été partagé sur la résilience et l’importance de PowerCLI dans la boîte à outils d’un administrateur système. Il a été partagé lors d’une session VMware PowerCLI au PowerShell Summit en 2019.
L’interfaçage avec vSphere et VMware a connu une multitude d’itérations, depuis le client logiciel d’origine, le client flash, les versions HTML5 et flex web-client. Dans chaque nouvelle version, les interfaces ont changé de manière souvent boguée ou dépourvue de fonctionnalités.
D’un autre côté, la syntaxe de VMware PowerCLI est restée stable tout au long de son cycle de vie avec un seul changement de distribution. Ce grand changement était la transition d’un snapin PowerShell à un module PowerShell.
PowerCLI est effectivement le dernier homme debout pour la cohérence lors de l’administration des produits VMware.
Table des matières
Du snapin à aucun accès public
L’emplacement de téléchargement original de VMware PowerCLI était derrière un lien de page PowerCLI 5.1. En raison de cette restriction, le public n’avait qu’un accès limité à cet outil.
PowerCLI 5.1 et antérieur était également un PSSnapin plutôt qu’un module rendant la portabilité beaucoup plus difficile. En tant que suiveur de ce blog, vous reconnaîtrez probablement cela comme un format hérité pour de tels outils. En raison de la lourdeur des étapes d’installation, les snapins se sont avérés plus difficiles à faire adopter en masse par PowerCLI. Heureusement pour vous, PowerCLI à partir de la dernière version 6.0 est livré en tant que module PowerShell, et non en tant que snapin !
Avec cette sortie de PowerCLI 6.0 en septembre 2015, la donne avait commencé à changer. Cette version était la première itération publiée en tant que module PowerShell, expédiée avec environ 400 cmdlets au total. Cependant, la nécessité d’un compte my.vmware.com était toujours présente jusqu’à la version 6.5.1 publiée le 20/4/2017 dans la galerie PowerShell.
Dans la version actuelle (11.3.0) de VMware PowerCLI, le module compte un peu moins de 700 cmdlets pour une couverture administrative sur une multitude de produits VMware. Ces produits comprennent vCenter, vCloud Director, VMware Horizon et bien d’autres.
La liste des cmdlets continue de s’allonger avec le portefeuille VMware, mais les normes PowerCLI éprouvées tiennent bon comme une force de cohérence.
Prérequis
Nous sommes sur le point de sauter dans une démo, alors assurez-vous d’avoir tous ces prérequis pour pouvoir suivre avec moi.
- HôteVMware ou serveur vCenter pour les tests de validation
- Machine cliente Windows, Mac ou Linux
Téléchargement de VMware PowerCLI
Le nouveau foyer à long terme de l’équipe du projet PowerCLI est fixé à https://code.vmware.com. Toutes les demandes de fonctionnalités soulevées par la communauté, les commentaires et la documentation pour ce module font maintenant partie du même site que le SDK, l’API et les ressources de certification.
Si vous avez des questions ou souhaitez soulever des demandes de fonctionnalités directement avec l’équipe, vous pouvez atteindre à la fois l’équipe PowerCLI et la communauté entourant ce projet à code.vmware.com. La communauté et l’équipe du projet VMware sont toutes deux très réactives aux questions, aux préoccupations et aux nouvelles idées qui se présentent.
Si vous souhaitez effectuer un téléchargement PowerCLI via le Web, l’équipe PowerCLI fournit un lien direct vers deux options pour leur module PowerShell :
- Le lien PowerShell Gallery pour télécharger et installer à l’aide du gestionnaire de paquets de PowerShell
- Une .zip du contenu du module, à installer manuellement
La galerie PowerShell est, de loin, le moyen le plus courant de télécharger PowerCLI, mais l’archive zip fonctionnera également. Notez que vous n’êtes pas obligé d’utiliser le lien de la galerie PowerShell ici. Vous pouvez également le télécharger via PowerShell.
Installation de VMware PowerCLI dans Windows PowerShell
Il existe plusieurs façons différentes d’installer PowerCLI.
Extraction du fichier ZIP
Si vous l’avez téléchargé via le web à partir de la page susmentionnée, vous devrez l’installer manuellement. Vous devez obtenir PowerCLI dans un endroit où PowerShell peut le voir.
Pour installer le module via le paquet zip fourni, vous devrez extraire le contenu à l’emplacement du module de votre choix. Cet emplacement sera soit l’emplacement de votre profil utilisateur (pour la portée non administrative), soit le dossier des modules à l’échelle du système.
%UserProfile%\Documents\WindowsPowerShell\ModulesC:\Program Files\WindowsPowerShell\ModulesExtraire le contenu du .zip vers l’un des emplacements ci-dessus.
Galerie PowerShell
La façon la plus simple et la plus rapide de télécharger et d’installer PowerCLI aujourd’hui est d’utiliser le téléchargement du module à partir de la galerie PowerShell dans une console PowerShell. Vous trouverez ci-dessous une vidéo rapide sur les étapes générales d’installation d’un nouveau module à PowerShell avec cette méthode.
Mais, dans l’ensemble, vous pouvez effectuer ce qui suit à partir d’une invite PowerShell administrative pour faire le travail.
PS51> Install-Module VMware.PowerCLISi vous souhaitez effectuer une installation PowerCLI sur un poste de travail où vous n’avez pas de privilèges administratifs, vous pouvez utiliser le paramètre Scope pour installer le module dans le chemin du module de votre profil utilisateur.
PS51> Install-Module VMware.PowerCLI -Scope CurrentUserInstallation de VMware PowerCLI dans PowerShell 6 sur Linux
De nos jours, vous pouvez également installer PowerCLI sur des systèmes non Windows. Par exemple, nous pouvons installer PowerCLI dans PowerShell Core sur Ubuntu. Encore une fois, selon que vous avez choisi de télécharger le fichier zip, le lien web de la galerie PowerShell ou directement via la console PowerShell, le processus d’installation est un peu différent.
Extraction du fichier ZIP
Selon la saveur de Linux, vous extrairez le contenu du fichier .zip à différents endroits.
Ouvrez PowerShell sur Linux en exécutant pwsh dans votre terminal. Localisez les emplacements PSModulePath potentiels à l’aide de la commande suivante :
PS61> ($env:PSModulePath).split(":")
Une fois que vous avez déterminé où vous souhaitez installer les fichiers du module, téléchargez-les à cet emplacement et préparez le dézip. Vous les décompresserez soit dans le dossier /home/ pour l’accès utilisateur, soit dans l’emplacement /opt/ pour l’accès système.
Pour cet exemple d’installation basée sur Linux, j’utilise Ubuntu 18.04 et j’installerai VMware PowerCLI 11 en utilisant le fichier .zip téléchargé ici, en installant le module pour qu’il soit accessible par tous les utilisateurs de cette machine.
> cd /opt/microsoft/powershell/6/Modules> sudo apt install unzip> sudo wget https://vdc-download.vmware.com/vmwb-repository/dcr-public/8bf09c32-43c0-46d4-8816-92515c3b8228/15761272-b339-4da4-888a-4b8633f9a964/VMware-PowerCLI-11.3.0-13990089.zip> sudo unzip ./VMware-PowerCLI-11.3.0-13990089.zipVous pouvez ensuite importer ce module, car les fichiers du module sont maintenant dans l’un de vos $PSModulePath emplacements, via une exécution normale de :
Import-Module VMware.PowerCLIInstallation du snapin VMware PowerCLI hérité
Parfois, vous pouvez vous retrouver à devoir installer l’ancien snapin PowerCLI. Peut-être avez-vous pris la responsabilité d’un certain code hérité et devez-vous résoudre des problèmes. Pour éviter de réarchitecturer vos scripts existants, il est nécessaire d’installer l’ancien snapin.
Pour installer l’ancien snapin, vous aurez besoin d’un compte my.vmware.com pour vous connecter et récupérer le fichier VMware-PowerCLI-5.1.0-3090428.exe. Lors du téléchargement, installez le snapin via l’exécutable par le biais d’une installation d’application Windows normale.
Vous pouvez ensuite exécuter Add-PSSnapin pour charger les cmdlets VMware dans votre session, ou lancer la console VMware PowerCLI fournie de manière autonome.
Ci-après, vous pouvez voir que j’utilise le cmdlet Add-PSSnapin pour ajouter la version 5.1 de PowerCLI à ma session de console actuelle.
PS51> Add-PSSnapin VMware*
Lancement du raccourci VMware PowerCLI autonome installé qui s’installe avec la version 5.1.
Notez que le snapin ci-dessus n’est pas compatible avec PowerShell 6/7.
Vérification de l’installation de PowerCLI
Vérifier que votre installation de PowerCLI est réussie est la même, quelle que soit votre version de PowerShell. La première étape, confirmez la présence des modules depuis la console PowerShell.
Get-Module -ListAvailable VMware* 
Puis, essayez d’utiliser PowerCLI pour vous connecter à vCenter avec la cmdlet Connect-VIServer. Cela permettra non seulement de vérifier que le module a été installé avec succès, mais aussi de tester si vous vous connectez correctement à votre infrastructure.
Sur Windows
PS51> Connect-VIServer <FQDN of vCenter or ESXi Host>
Sur Linux
Lorsque vous vérifiez l’installation sur Linux, vous devez d’abord définir la configuration de la connexion pour tenir compte d’un certificat invalide (ou auto-signé par défaut) si vous rencontrez des problèmes de connexion. Ci-dessous, j’utilise PowerCLI pour me connecter à vCenter.
PS> Set-PowerCLIConfiguration -InvalidCertificateAction:ignorePS> Connect-VIServer <FQDN of vCenter or ESXi Host>
Puisque vous avez pu vous connecter avec succès à votre endpoint VMware, le PowerCLI est opérationnel avec succès!
Go Forth et PowerCLI !
À partir de ce point, vous êtes maintenant prêt à répondre à cette question proverbiale de « Comment puis-je installer VMware PowerCLI ? ». Vous pouvez maintenant commencer à travailler sur le scriptage de vos déploiements de configuration, des rapports VM et des tâches de maintenance. Restez à l’écoute de ce blog pour de nouveaux et prochains articles sur la façon de démarrer avec PowerCLI !
Lecture complémentaire
- Comment importer un fichier OVF dans VMware avec PowerShell
.