De PowerCLI van VMWare is de de-facto manier om vCenter te beheren met PowerShell. In deze tutorial leert u hoe u vanaf nul kunt beginnen: downloaden, installeren en begrijpen hoe PowerCLI u kan helpen meer voor elkaar te krijgen.
Tijdens deze reis leert u:
- Hoe u historische versies van PowerCLI kunt vinden die u kunt tegenkomen in oudere scripts
- Hoe u de meest recente versie van PowerCLI installeert
- VMware Code gebruiken als bron
- Hoe u VMware PowerCLI installeert in zowel Windows PowerShell 5.1 en PowerShell 6/7 voor cross-platform gebruik.
“In de meeste opzichten is VMware PowerCLI de meest consistente beheerinterface in de lange geschiedenis van de hypervisor.”
De bovenstaande geparafraseerde opmerking werd gedeeld over de veerkracht en het belang van PowerCLI in de toolkit van een systeembeheerder. Het werd gedeeld tijdens een VMware PowerCLI-sessie op de PowerShell Summit in 2019.
Interfacing met vSphere en VMware heeft een veelheid aan iteraties doorgemaakt, van de oorspronkelijke softwareclient, flashclient, HTML5- en flex web-clientversies. In elke nieuwe release veranderden de interfaces op vaak buggy- of functieloze manieren.
Aan de andere kant is de syntaxis van VMware PowerCLI gedurende de hele levenscyclus stabiel gebleven met slechts één distributiewijziging. Die grote verandering was de overgang van een PowerShell-snapin naar een PowerShell-module.
PowerCLI is in feite de laatste man die overeind blijft omwille van de consistentie bij het beheren van VMware-producten.
Inhoudsopgave
Van snapin naar geen openbare toegang
De oorspronkelijke downloadlocatie voor VMware PowerCLI bevond zich achter een PowerCLI 5.1-paginakoppeling. Door deze beperking had het publiek slechts beperkte toegang tot deze tool.
PowerCLI 5.1 en eerder was ook een PSSnapin in plaats van een module waardoor portabiliteit veel moeilijker was. Als volger van deze blog, zult u dit waarschijnlijk herkennen als een legacy formaat voor dergelijke tools. Vanwege de omslachtige installatiestappen bleken snapins moeilijker om PowerCLI massaal ingang te doen vinden. Gelukkig voor u wordt PowerCLI vanaf de nieuwste versie 6.0 geleverd als een PowerShell-module, en niet als een snapin!
Met die release van PowerCLI 6.0 in september van 2015 was het spel begonnen te veranderen. Deze versie was de eerste iteratie die werd vrijgegeven als een PowerShell-module en werd geleverd met in totaal ongeveer 400 cmdlets. De noodzaak van een my.vmware.com-account was echter nog steeds aanwezig tot versie 6.5.1 die op 4/20/2017 werd vrijgegeven voor de PowerShell Gallery.
In de huidige versie (11.3.0) van VMware PowerCLI heeft de module iets minder dan 700 cmdlets voor administratieve dekking over een veelheid aan VMware-producten. Deze producten omvatten vCenter, vCloud Director, VMware Horizon, en vele anderen.
De lijst met cmdlets blijft groeien met het VMware-portfolio, maar de beproefde PowerCLI-standaarden houden stand als een kracht van consistentie.
Voorvereisten
We staan op het punt om in een demo te springen, dus zorg ervoor dat u over al deze vereisten beschikt, zodat u mij kunt volgen.
- VMware host of vCenter server voor validatietests
- Windows, Mac, of Linux client machine
Downloaden van VMware PowerCLI
De nieuwe lange termijn thuisbasis voor het PowerCLI project team is ingesteld op https://code.vmware.com. Alle door de community ingediende verzoeken om functies, opmerkingen en documentatie voor deze module maken nu deel uit van dezelfde site als de SDK, API en certificeringsbronnen.
Als u vragen hebt of verzoeken om functies rechtstreeks bij het team wilt indienen, kunt u contact opnemen met zowel het PowerCLI-team als de community rond dit project op code.vmware.com. Zowel de community als het VMware-projectteam zijn zeer ontvankelijk voor vragen, problemen en nieuwe ideeën wanneer deze zich voordoen.
Als u een PowerCLI-download via het web wilt uitvoeren, biedt het PowerCLI-team een directe link naar twee opties voor hun PowerShell-module:
- De PowerShell Gallery-link om te downloaden en te installeren met behulp van PowerShell’s pakketbeheerder
- Een .zip-archief van de inhoud van de module, om handmatig te installeren
De PowerShell-galerij is verreweg de meest gebruikelijke manier om PowerCLI te downloaden, maar het zip-archief werkt ook. Merk op dat u hier niet de PowerShell Gallery-link hoeft te gebruiken. U kunt het ook downloaden via PowerShell.
VMware PowerCLI installeren in Windows PowerShell
Er zijn een paar verschillende manieren om PowerCLI te installeren.
Het ZIP-bestand uitpakken
Als u het via het web hebt gedownload van de eerder genoemde pagina, moet u het handmatig installeren. U moet PowerCLI op een plaats zetten waar PowerShell het kan zien.
Om de module via het meegeleverde zip-pakket te installeren, moet u de inhoud uitpakken op de door u gewenste locatie voor de module. Deze locatie is ofwel de locatie van uw gebruikersprofiel (voor niet-administratief bereik) of naar de systeembrede module-map.
%UserProfile%\Documents\WindowsPowerShell\ModulesC:\Program Files\WindowsPowerShell\ModulesUitpakken van de .zip-inhoud naar een van de bovenstaande locaties.
PowerShell Gallery
De gemakkelijkste en snelste manier waarop u PowerCLI vandaag kunt downloaden en installeren, is door de module te downloaden vanuit de PowerShell Gallery binnen een PowerShell-console. Hieronder vindt u een korte video over de algemene installatiestappen voor een nieuwe module voor PowerShell met deze methode.
Maar al met al kunt u het volgende uitvoeren vanaf een administratieve PowerShell-prompt om de klus te klaren.
PS51> Install-Module VMware.PowerCLIAls u een PowerCLI-installatie wilt uitvoeren op een werkstation waar u geen beheerdersrechten hebt, kunt u de parameter Scope gebruiken om de module in het modulepad van uw gebruikersprofiel te installeren.
PS51> Install-Module VMware.PowerCLI -Scope CurrentUserInstallatie van VMware PowerCLI in PowerShell 6 op Linux
Heden ten dage kunt u PowerCLI ook op niet-Windows-systemen installeren. We kunnen bijvoorbeeld PowerCLI in PowerShell Core op Ubuntu installeren. Nogmaals, afhankelijk van of u hebt gekozen voor het downloaden van het zip-bestand, de PowerShell Gallery’s web link of rechtstreeks via de PowerShell console, het installatieproces is een beetje anders.
Het uitpakken van het ZIP-bestand
Afhankelijk van de smaak van Linux, zult u de inhoud van het .zip-bestand uit te pakken op verschillende locaties.
Open PowerShell op Linux door het uitvoeren van pwsh in uw terminal. Zoek de mogelijke PSModulePath-locaties met het volgende commando:
PS61> ($env:PSModulePath).split(":")
Als u eenmaal hebt bepaald waar u de modulebestanden wilt installeren, downloadt u ze naar die locatie en bereidt u zich voor op het uitpakken. U kunt ze unzippen naar de map /home/ voor gebruikerstoegang of naar de locatie /opt/ voor systeemtoegang.
Voor dit voorbeeld van een installatie onder Linux gebruik ik Ubuntu 18.04 en installeer ik VMware PowerCLI 11 met behulp van het .zip-bestand dat u hier hebt gedownload, waarbij de module wordt geïnstalleerd voor toegang door alle gebruikers van deze 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.zipU kunt deze module vervolgens importeren, omdat de modulebestanden zich nu op een van uw $PSModulePath locaties bevinden, via een normale uitvoering van:
Import-Module VMware.PowerCLIInstallatie van de Legacy VMware PowerCLI Snapin
Soms kan het voorkomen dat u de oudere PowerCLI snapin moet installeren. Misschien hebt u de verantwoordelijkheid voor legacy code overgenomen en moet u problemen oplossen. Om te voorkomen dat uw bestaande scripts opnieuw moeten worden ge-architectureerd, moet u de oude snapin installeren.
Om de oude snapin te installeren, hebt u een my.vmware.com-account nodig om in te loggen en het VMware-PowerCLI-5.1.0-3090428.exe-bestand op te halen. Na het downloaden installeert u de snapin via de executable via een normale Windows applicatie-installatie.
U kunt vervolgens Add-PSSnapin uitvoeren om de VMware cmdlets in uw sessie te laden, of de meegeleverde VMware PowerCLI console op een stand-alone manier starten.
Hieronder ziet u dat ik het cmdlet Add-PSSnapin gebruik om PowerCLI versie 5.1 aan mijn huidige consolesessie toe te voegen.
PS51> Add-PSSnapin VMware*
Lanceert de geïnstalleerde stand-alone VMware PowerCLI-snelkoppeling die wordt geïnstalleerd met versie 5.1.
Merk op dat de bovenstaande snapin niet compatibel is met PowerShell 6/7.
De installatie van PowerCLI verifiëren
Het verifiëren of uw installatie van PowerCLI is geslaagd, is hetzelfde, ongeacht uw versie van PowerShell. De eerste stap is het bevestigen van de aanwezigheid van de modules vanaf de PowerShell-console.
Get-Module -ListAvailable VMware* 
Volgende stap is het proberen om PowerCLI te gebruiken om verbinding te maken met vCenter met het cmdlet Connect-VIServer. Hiermee wordt niet alleen gecontroleerd of de module met succes is geïnstalleerd, maar wordt ook getest of u al dan niet correct verbinding maakt met uw infrastructuur.
Op Windows
PS51> Connect-VIServer <FQDN of vCenter or ESXi Host>
Op Linux
Wanneer u de installatie op Linux controleert, moet u eerst de verbindingsconfiguratie zo instellen dat rekening wordt gehouden met een ongeldig (of standaard zelfondertekend certificaat) als u verbindingsproblemen ondervindt. Hieronder gebruik ik PowerCLI om verbinding te maken met vCenter.
PS> Set-PowerCLIConfiguration -InvalidCertificateAction:ignorePS> Connect-VIServer <FQDN of vCenter or ESXi Host>
Nadat u met succes verbinding hebt kunnen maken met uw VMware-eindpunt, is de PowerCLI met succes in gebruik genomen.
Ga voorwaarts en PowerCLI!
Vanaf dit punt bent u nu voorbereid om die spreekwoordelijke vraag te beantwoorden van “Hoe installeer ik VMware PowerCLI?”. U kunt nu aan de slag met het scripten van uw configuratie-implementaties, VM-rapporten en onderhoudstaken. Houd deze blog in de gaten voor nieuwe en toekomstige artikelen over het aan de slag gaan met PowerCLI!
Verder lezen
- Hoe importeer ik een OVF-bestand in VMware met PowerShell