Die Server-Eye-Sensoren, die Du zum Monitoring von VMware benutzen kannst, verwendet intern das VMware Kommandozeilentool "PowerCLI". Die Installation der PowerCLI erfolgt mit den aktuellen Versionen über die PowerShell, wie Du hierbei am besten vorgehst, erfährst Du in diesem Artikel. 


Es wird eine PowerShell in der Version 5.0 oder höher benötigt!

Solltest Du keine Version 5.0 haben kannst Du die PowerShell selbst updaten.

Info Link: Windows Management Framework

Technet: Install-Module

Du kannst das Modul auch nachinstallieren, falls Du eine ältere Version der PowerShell, aber größer/gleich 3.0 haben.

OneGet PackageManagement  GitHub 


Bitte beachten: 

Es sollte auch die PATH-Variable in den Umgebungsvariablen hinterlegt sein: 

"%SystemRoot%\System32\WindowsPowerShell\v1.0\"


Wenn diese fehlt, kann die PowerShell nicht gestartet werden und es kommt zu Problemen mit den Sensoren.

Installationsanleitung

  1. Starte eine administrative PowerShell. Wie Du hierzu vorgehst, findest Du hier: PowerShell - eine PowerShell mit Administratorberechtigung öffnen
  2. Gib hier nun ein:
    Install-Module -Name VCF.PowerCLI -Scope AllUsers

    In einigen wenigen Fällen hatte Scope AllUsers nicht geklappt. Hier kann es notwendig sein, mit den PSTools von PSEXEC die PowerShell, als SYSTEM zu starten "psexec -i -s powershell.exe".


    • Sollte es hierbei zu einer Fehlermeldung kommen, muss die verwendete Verschlüsselung auf TLS 1.2 gestellt werden. Dies erreichst Du mit folgendem Befehl:     
      [Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12

  3. Bestätige die folgende Frage, ob Du Module aus der PSGallery installieren möchtest mit J (bzw. Y, je nach Betriebssystemsprache) - oder mit A, um auch zukünftig ohne Rückfrage Module aus der PSGallery installieren zu können. 
  4. Die Installation wird nun durchgeführt. Dieser Vorgang kann einige Minuten dauern. 
  5. Nach der Installation kannst Du durch Eingabe von
    Get-Module -ListAvailable

    die verfügbaren Module anzeigen lassen. Außerdem sind die Module standardmäßig hier zu finden: C:\Program Files\WindowsPowerShell\Modules\VMware.PowerCLI


  6. Set-PowerCLIConfiguration -ParticipateInCEIP $false 
Set-PowerCLIConfiguration  -InvalidCertificateAction Ignore -Scope AllUsers -Confirm: $false

    (siehe hierzu weitere Informationen hier: PowerCLI - Connect-VIServer erzeugt Warnung wegen unzulässigem Zertifikat )


Testverbindung aufbauen

  1. Öffne eine PowerShell-Sitzung (normaler Benutzerkontext genügt) 
  2. Gib hier nun zum Import ein:
    import-module VCF.PowerCLI

  3. Nach dem Import versuchst Du einen Verbindungsaufbau mittels
    Connect-VIServer -Server SERVERNAME


    Gib anschließend Deine Zugangsdaten ein, um eine Verbindung herstellen zu können.
    Zertifikatsprüfung deaktivieren, sofern Du hier eine Fehlermeldung erhältst muss noch die Behandlung von Zertifikaten in der PowerCLI umgestellt werden.
    • Gib in der PowerShell nun ein und bestätige mit A für Alle. 
      Set-PowerCLIConfiguration -invalidcertificateAction Ignore -Scope AllUsers



Nun solltest Du mittels einer Verbindung aufbauen und mittels Get-VM die vorhanden VMs abrufen können.

Connect-VIServer -Server SERVERNAME



Troubleshooting

Fehlermeldung "Datei nicht gefunden"

Sollte die Meldung "PackageManagement\Install-Package : Package 'VMware.Vim' failed to be installed because: Die Datei

"C:\Windows\TEMP\1234567890\VMware.Vim\VMware.Vim.nupkg" konnte nicht gefunden werden." oder ähnlich auftreten, so stelle bitte sicher, dass eine aktuell verwendete Sicherheitssoftware das Entpacken von nuget-Paketen nicht blockiert. (Berichtet in Verbindung mit "Trend Micro WFBS")


Fehlermeldung "Authenticode issuer[...] is not matching with the authenticode issuer [...]"

Durch den Aufkauf von vmWare durch Broadcom hat sich der Inhaber des Stammzertifikats geändert - es kann daher durch vorangegangene PowerCLI-Installationen passieren, dass es hier zu einem Konflikt zwischen den CN-Einträgen der Zertifikate kommt. Um die Publisherprüfung zu umgehen bitte den Parameter "-SkipPublisherCheck" verwenden.


Fehlermeldung "Install-Module: Administrator rights are required to install modules in"

PowerShell bitte als Administrator öffnen, siehe PowerShell - eine PowerShell mit Administratorberechtigung öffnen

Andere Version des PowerShell-Moduls installieren

Du kannst alle Versionen unter https://www.powershellgallery.com/packages/VMware.PowerCLI/ finden. Solltest du eine ältere Version installieren wollen, so verwende den Parameter "-RequiredVersion" mit der gewünschten Version, beispielsweise "-RequiredVersion 13.2.1.22851661" - beachte hierbei, dass diese ältere Version nicht zwingend mit den servereye-Sensoren kompatibel ist. Ohne diesen Parameter wird stets die aktuellste Version installiert.