Die PowerCLI von VMWare ist die de-facto Methode zur Verwaltung von vCenter mit PowerShell. In diesem Tutorial lernen Sie, wie Sie bei Null anfangen; herunterladen, installieren und verstehen, wie PowerCLI Ihnen helfen kann, mehr zu erreichen.
Auf diesem Weg lernen Sie:
- Wie Sie historische Versionen von PowerCLI erkennen, die Sie möglicherweise in älteren Skripten finden
- Wie Sie die neueste Version von PowerCLI installieren
- Nutzen Sie VMware-Code als Ressource
- Wie Sie VMware PowerCLI sowohl in Windows PowerShell 5.1 und PowerShell 6/7 für den plattformübergreifenden Einsatz
„In vielerlei Hinsicht ist VMware PowerCLI die konsistenteste Verwaltungsschnittstelle in der langen Geschichte des Hypervisors.“
Der obige paraphrasierte Kommentar bezog sich auf die Widerstandsfähigkeit und die Bedeutung von PowerCLI im Werkzeugkasten eines Systemadministrators. Er wurde während einer VMware PowerCLI-Sitzung auf dem PowerShell Summit 2019 geteilt.
Die Schnittstelle zu vSphere und VMware hat eine Vielzahl von Iterationen durchlaufen, vom ursprünglichen Software-Client über den Flash-Client bis hin zu HTML5- und Flex-Web-Client-Versionen. In jeder neuen Version änderten sich die Schnittstellen auf oft fehlerhafte oder funktionsarme Weise.
Auf der anderen Seite ist die Syntax von VMware PowerCLI über den gesamten Lebenszyklus hinweg mit nur einer einzigen Distributionsänderung stabil geblieben. Diese große Änderung war der Übergang von einem PowerShell-Snapin zu einem PowerShell-Modul.
PowerCLI ist praktisch der letzte Mann, der bei der Verwaltung von VMware-Produkten für Konsistenz sorgt.
Inhaltsverzeichnis
Von einem Snapin zu keinem öffentlichen Zugang
Der ursprüngliche Download-Speicherort für VMware PowerCLI befand sich hinter einem PowerCLI 5.1-Seitenlink. Aufgrund dieser Einschränkung hatte die Öffentlichkeit nur begrenzten Zugang zu diesem Tool.
PowerCLI 5.1 und früher war außerdem ein PSSnapin und kein Modul, was die Portabilität erheblich erschwerte. Wenn Sie diesen Blog verfolgen, werden Sie wahrscheinlich erkennen, dass dies ein altes Format für solche Tools ist. Aufgrund der umständlichen Installationsschritte erwies es sich als schwieriger, die Massenanwendung von PowerCLI zu erreichen. Zum Glück für Sie wird PowerCLI ab der neuesten Version 6.0 als PowerShell-Modul und nicht als Snapin ausgeliefert!
Mit der Veröffentlichung von PowerCLI 6.0 im September 2015 begann sich das Spiel zu ändern. Diese Version war die erste Iteration, die als PowerShell-Modul veröffentlicht wurde und insgesamt etwa 400 Cmdlets enthielt. Die Notwendigkeit eines my.vmware.com-Kontos bestand jedoch noch bis zur Version 6.5.1, die am 20.4.2017 in der PowerShell-Galerie veröffentlicht wurde.
In der aktuellen Version (11.3.0) von VMware PowerCLI verfügt das Modul über knapp 700 Cmdlets zur administrativen Abdeckung einer Vielzahl von VMware-Produkten. Zu diesen Produkten gehören vCenter, vCloud Director, VMware Horizon und viele andere.
Die Liste der Cmdlets wächst mit dem VMware-Portfolio weiter, aber die bewährten PowerCLI-Standards halten sich hartnäckig wie eine Kraft der Beständigkeit.
Voraussetzungen
Wir sind gleich bereit für eine Demo, also stellen Sie sicher, dass Sie alle diese Voraussetzungen haben, damit Sie mir folgen können.
- VMware-Host oder vCenter-Server für Validierungstests
- Windows-, Mac- oder Linux-Client-Rechner
Herunterladen von VMware PowerCLI
Das neue langfristige Zuhause des PowerCLI-Projektteams befindet sich unter https://code.vmware.com. Alle von der Community gestellten Feature-Anfragen, Kommentare und Dokumentationen für dieses Modul sind nun Teil derselben Website wie das SDK, die API und die Zertifizierungsressourcen.
Wenn Sie Fragen haben oder Feature-Anfragen direkt an das Team richten möchten, können Sie sich sowohl an das PowerCLI-Team als auch an die Community rund um dieses Projekt unter code.vmware.com wenden. Sowohl die Community als auch das VMware-Projektteam haben ein offenes Ohr für Fragen, Anliegen und neue Ideen, sobald diese auftauchen.
Wenn Sie einen PowerCLI-Download über das Internet durchführen möchten, bietet das PowerCLI-Team einen direkten Link zu zwei Optionen für das PowerShell-Modul:
- Der PowerShell-Galerie-Link zum Herunterladen und Installieren mit dem PowerShell-Paketmanager
- ein .Zip-Archiv mit dem Inhalt des Moduls, das manuell installiert werden muss
Die PowerShell-Galerie ist bei weitem die häufigste Methode zum Herunterladen von PowerCLI, aber das Zip-Archiv funktioniert auch. Beachten Sie, dass Sie hier nicht den Link zur PowerShell Gallery verwenden müssen. Sie können es auch über PowerShell herunterladen.
Installieren von VMware PowerCLI in Windows PowerShell
Es gibt verschiedene Möglichkeiten, PowerCLI zu installieren.
Extrahieren der ZIP-Datei
Wenn Sie es über das Internet von der oben genannten Seite heruntergeladen haben, müssen Sie es manuell installieren. Sie müssen PowerCLI an einen Ort bringen, an dem PowerShell es sehen kann.
Um das Modul über das bereitgestellte ZIP-Paket zu installieren, müssen Sie den Inhalt an den gewünschten Speicherort des Moduls extrahieren. Dieser Speicherort ist entweder der Speicherort Ihres Benutzerprofils (für den nicht-administrativen Bereich) oder der systemweite Modulordner.
%UserProfile%\Documents\WindowsPowerShell\ModulesC:\Program Files\WindowsPowerShell\ModulesExtrahieren Sie den .zip-Inhalt in einen der oben genannten Speicherorte.
PowerShell Gallery
Die einfachste und schnellste Möglichkeit, PowerCLI herunterzuladen und zu installieren, ist der Download des Moduls aus der PowerShell Gallery innerhalb einer PowerShell-Konsole. Nachfolgend finden Sie ein kurzes Video zu den allgemeinen Installationsschritten für ein neues Modul in der PowerShell mit dieser Methode.
Allerdings können Sie die folgenden Schritte von einer administrativen PowerShell-Eingabeaufforderung aus durchführen, um die Arbeit zu erledigen.
PS51> Install-Module VMware.PowerCLIWenn Sie eine PowerCLI-Installation auf einer Workstation durchführen möchten, auf der Sie keine administrativen Rechte haben, können Sie den Parameter Scope verwenden, um das Modul in den Modulpfad Ihres Benutzerprofils zu installieren.
PS51> Install-Module VMware.PowerCLI -Scope CurrentUserInstallieren von VMware PowerCLI in PowerShell 6 auf Linux
Heutzutage können Sie PowerCLI auch auf Nicht-Windows-Systemen installieren. Zum Beispiel können wir PowerCLI in PowerShell Core auf Ubuntu installieren. Je nachdem, ob Sie die ZIP-Datei, den Weblink der PowerShell-Galerie oder direkt über die PowerShell-Konsole heruntergeladen haben, unterscheidet sich der Installationsprozess ein wenig.
Extrahieren der ZIP-Datei
Abhängig von der Linux-Variante entpacken Sie den Inhalt der ZIP-Datei an unterschiedliche Orte.
Öffnen Sie PowerShell unter Linux, indem Sie pwsh in Ihrem Terminal ausführen. Suchen Sie die potenziellen PSModulePath-Speicherorte mit dem folgenden Befehl:
PS61> ($env:PSModulePath).split(":")
Wenn Sie festgestellt haben, wo Sie die Moduldateien installieren möchten, laden Sie sie an diesen Speicherort herunter und bereiten Sie das Entpacken vor. Sie entpacken sie entweder in den Ordner /home/ für den Benutzerzugriff oder in den Ordner /opt/ für den Systemzugriff.
Für dieses Beispiel einer Linux-basierten Installation verwende ich Ubuntu 18.04 und installiere VMware PowerCLI 11 mit der von hier heruntergeladenen .zip-Datei, wobei das Modul so installiert wird, dass alle Benutzer dieses Rechners darauf zugreifen können.
> 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.zip Anschließend können Sie dieses Modul importieren, da sich die Moduldateien nun an einem Ihrer $PSModulePath Speicherorte befinden, und zwar über eine normale Ausführung von:
Import-Module VMware.PowerCLIInstallieren des älteren VMware PowerCLI-Snapins
Es kann vorkommen, dass Sie das ältere PowerCLI-Snapin installieren müssen. Vielleicht haben Sie die Verantwortung für einen Legacy-Code übernommen und müssen Probleme beheben. Um zu verhindern, dass Sie Ihre vorhandenen Skripte neu archivieren müssen, ist es notwendig, das alte Snapin zu installieren.
Um das alte Snapin zu installieren, benötigen Sie ein my.vmware.com-Konto, um sich anzumelden und die Datei VMware-PowerCLI-5.1.0-3090428.exe abzurufen. Nach dem Herunterladen installieren Sie das Snapin über die ausführbare Datei durch eine normale Windows-Anwendungsinstallation.
Sie können dann Add-PSSnapin ausführen, um die VMware-Cmdlets in Ihre Sitzung zu laden, oder die bereitgestellte VMware PowerCLI-Konsole eigenständig starten.
Unten sehen Sie, dass ich das Cmdlet Add-PSSnapin verwende, um PowerCLI Version 5.1 zu meiner aktuellen Konsolensitzung hinzuzufügen.
PS51> Add-PSSnapin VMware*
Aufrufen der installierten eigenständigen VMware PowerCLI-Verknüpfung, die mit Version 5.1 installiert wird.
Beachten Sie, dass das obige Snapin nicht mit PowerShell 6/7 kompatibel ist.
Überprüfen der Installation von PowerCLI
Die Überprüfung der erfolgreichen Installation von PowerCLI ist unabhängig von Ihrer PowerShell-Version gleich. Im ersten Schritt bestätigen Sie das Vorhandensein der Module in der PowerShell-Konsole.
Get-Module -ListAvailable VMware* 
Als Nächstes versuchen Sie, mithilfe von PowerCLI mit dem Cmdlet Connect-VIServer eine Verbindung zu vCenter herzustellen. Dadurch wird nicht nur überprüft, ob das Modul erfolgreich installiert wurde, sondern auch, ob die Verbindung zu Ihrer Infrastruktur korrekt ist.
Unter Windows
PS51> Connect-VIServer <FQDN of vCenter or ESXi Host>
Unter Linux
Beim Überprüfen der Installation unter Linux müssen Sie zunächst die Verbindungskonfiguration so einstellen, dass ein ungültiges (oder standardmäßig selbstsigniertes) Zertifikat berücksichtigt wird, wenn Sie Verbindungsprobleme haben. Im Folgenden verwende ich PowerCLI, um mich mit vCenter zu verbinden.
PS> Set-PowerCLIConfiguration -InvalidCertificateAction:ignorePS> Connect-VIServer <FQDN of vCenter or ESXi Host>
Da Sie sich erfolgreich mit Ihrem VMware-Endpunkt verbinden konnten, ist PowerCLI erfolgreich eingerichtet und läuft!
Los geht’s und PowerCLI!
Ab diesem Punkt sind Sie nun bereit, die sprichwörtliche Frage zu beantworten: „Wie installiere ich VMware PowerCLI?“. Sie können nun damit beginnen, Skripte für Ihre Konfigurationsbereitstellungen, VM-Berichte und Wartungsaufgaben zu erstellen. Bleiben Sie auf diesem Blog für neue und kommende Artikel über den Einstieg in PowerCLI dran!
Weitere Lektüre
- Wie importiert man eine OVF-Datei in VMware mit PowerShell