Adam the Automator

PowerCLI od společnosti VMWare je de facto způsob správy vCenter pomocí prostředí PowerShell. V tomto návodu se dozvíte, jak začít od nuly; stáhnout, nainstalovat a pochopit, jak vám PowerCLI může pomoci udělat více práce.

Na této cestě se naučíte:

  • Jak rozpoznat historické verze PowerCLI, se kterými se můžete setkat ve starších skriptech
  • Jak nainstalovat nejnovější verzi PowerCLI
  • Použít kód VMware jako zdroj
  • Jak nainstalovat VMware PowerCLI v prostředí Windows PowerShell 5.1 a PowerShell 6/7 pro použití napříč platformami.

„Ve většině ohledů je VMware PowerCLI nejkonzistentnějším rozhraním pro správu v dlouholeté historii hypervizoru.“

Výše uvedený parafrázovaný komentář byl sdílen ohledně odolnosti a důležitosti PowerCLI v sadě nástrojů správce systému. Byl sdělen během zasedání VMware PowerCLI na konferenci PowerShell Summit 2019.

Připojení k vSphere a VMware prošlo mnoha iteracemi, od původního softwarového klienta, přes flashového klienta, HTML5 až po flexibilní verze webového klienta. V každé nové verzi se rozhraní měnila často s chybami nebo nedostatkem funkcí.

Na druhou stranu syntaxe VMware PowerCLI zůstala stabilní po celou dobu svého životního cyklu s jedinou distribuční změnou. Tou velkou změnou byl přechod od snapinu prostředí PowerShell k modulu prostředí PowerShell.

PowerCLI je fakticky posledním mužem, který zůstává v zájmu konzistence při správě produktů VMware.

Obsah

Od snapinu k neveřejnému přístupu

Původní umístění pro stažení VMware PowerCLI se nacházelo za odkazem na stránku PowerCLI 5.1. Kvůli tomuto omezení měla veřejnost k tomuto nástroji pouze omezený přístup.

PowerCLI 5.1 a starší byl také spíše PSSnapin než modul, což značně ztěžovalo přenositelnost. Jako příznivci tohoto blogu pravděpodobně poznáte, že se jedná o starší formát těchto nástrojů. Kvůli těžkopádným instalačním krokům se snapiny ukázaly jako obtížnější pro masové přijetí PowerCLI. Naštěstí pro vás se PowerCLI od nejnovější verze 6.0 dodává jako modul prostředí PowerShell, a nikoli jako snapin!

S tímto vydáním PowerCLI 6.0 v září 2015 se hra začala měnit. Tato verze byla první iterací vydanou jako modul prostředí PowerShell a dodávala se s celkem asi 400 rutinami. Potřeba účtu my.vmware.com však byla stále přítomna až do verze 6.5.1 vydané 20. 4. 2017 do galerie PowerShell.

V současné verzi (11.3.0) VMware PowerCLI má modul necelých 700 rutin pro pokrytí správy nad množstvím produktů VMware. Mezi tyto produkty patří vCenter, vCloud Director, VMware Horizon a mnoho dalších.

Seznam rutin se stále rozšiřuje spolu s portfoliem produktů VMware, ale osvědčené standardy PowerCLI se drží jako pevná síla konzistence.

Kmdlety v modulu PowerCLI PowerShell

Předpoklady

Brzy se vrhneme na ukázku, takže se ujistěte, že máte všechny tyto předpoklady, abyste mohli postupovat spolu se mnou.

  • Hostitel VMware nebo server vCenter pro ověřovací testování
  • Klientský počítač se systémem Windows, Mac nebo Linux

Stažení VMware PowerCLI

Nový dlouhodobý domov pro tým projektu PowerCLI je nastaven na adrese https://code.vmware.com. Veškeré požadavky na funkce vznesené komunitou, připomínky a dokumentace k tomuto modulu jsou nyní součástí stejného webu jako SDK, API a certifikační zdroje.

Pokud máte jakékoli dotazy nebo chcete vznést požadavky na funkce přímo s týmem, můžete se obrátit jak na tým PowerCLI, tak na komunitu kolem tohoto projektu na adrese code.vmware.com. Komunita i projektový tým VMware velmi ochotně reagují na dotazy, připomínky a nové nápady, které se objeví.

Pokud chcete provést stažení PowerCLI prostřednictvím webu, tým PowerCLI poskytuje přímý odkaz na dvě možnosti svého modulu PowerShell:

  • Odkaz na galerii PowerShell pro stažení a instalaci pomocí správce balíčků PowerShell
  • A .ZIP archiv s obsahem modulu, který se nainstaluje ručně

Galerie PowerShell je zdaleka nejčastějším způsobem stažení PowerCLI, ale ZIP archiv bude také fungovat. Všimněte si, že zde nemusíte použít odkaz na galerii PowerShell. Můžete jej stáhnout také prostřednictvím prostředí PowerShell.

Instalace VMware PowerCLI v prostředí Windows PowerShell

Existuje několik různých způsobů instalace PowerCLI.

Rozbalení souboru ZIP

Pokud jste jej stáhli prostřednictvím webu z výše uvedené stránky, budete jej muset nainstalovat ručně. Modul PowerCLI musíte dostat na místo, kde jej uvidí prostředí PowerShell.

Chcete-li modul nainstalovat prostřednictvím poskytnutého balíčku ZIP, budete muset jeho obsah rozbalit do zvoleného umístění modulu. Tímto umístěním bude buď umístění vašeho uživatelského profilu (pro neadministrátorský rozsah), nebo do složky modulů pro celý systém.

%UserProfile%\Documents\WindowsPowerShell\ModulesC:\Program Files\WindowsPowerShell\Modules

Extrahujte obsah .zip do jednoho z výše uvedených umístění.

Galerie PowerShell

Nejjednodušší a nejrychlejší způsob, jak můžete dnes stáhnout a nainstalovat modul PowerCLI, je použít stažení modulu z galerie PowerShell v rámci konzoly PowerShell. Níže naleznete rychlé video s obecnými kroky instalace nového modulu do prostředí PowerShell touto metodou.

Ale celkově můžete provést následující úkony z výzvy správce prostředí PowerShell, abyste měli práci hotovou.

PS51> Install-Module VMware.PowerCLI

Pokud chcete provést instalaci modulu PowerCLI na pracovní stanici, kde nemáte oprávnění správce, můžete použít parametr Scope pro instalaci modulu do cesty k modulu uživatelského profilu.

PS51> Install-Module VMware.PowerCLI -Scope CurrentUser

Instalace VMware PowerCLI v prostředí PowerShell 6 v systému Linux

V současné době můžete modul PowerCLI nainstalovat i na jiné systémy než Windows. Například můžeme nainstalovat PowerCLI v jádře PowerShell na Ubuntu. Opět v závislosti na tom, zda jste se rozhodli stáhnout soubor ZIP, webový odkaz galerie PowerShell nebo přímo prostřednictvím konzoly PowerShell, se postup instalace trochu liší.

Rozbalení souboru ZIP

V závislosti na příchuti systému Linux rozbalíte obsah souboru .zip do různých umístění.

Otevřete PowerShell v systému Linux spuštěním příkazu pwsh v terminálu. Vyhledejte potenciální umístění PSModulePath pomocí následujícího příkazu:

PS61> ($env:PSModulePath).split(":")
Adresáře v PSModulePath

Jakmile určíte, kam chcete soubory modulů nainstalovat, stáhněte je do tohoto umístění a připravte se na rozbalení. Buď je rozbalíte do složky /home/ pro uživatelský přístup, nebo do umístění /opt/ pro systémový přístup.

Pro tento příklad instalace v systému Linux používám Ubuntu 18.04 a nainstaluji VMware PowerCLI 11 pomocí souboru .zip staženého odtud, čímž nainstaluji modul, který bude přístupný všem uživatelům tohoto počítače.

> 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

Tento modul pak můžete importovat, protože soubory modulu jsou nyní v jednom z vašich $PSModulePath umístění, prostřednictvím běžného spuštění:

Import-Module VMware.PowerCLI

Instalace staršího modulu snapin VMware PowerCLI

Někdy se může stát, že budete muset nainstalovat starší modul snapin PowerCLI. Možná jste převzali odpovědnost za nějaký starší kód a potřebujete řešit problémy. Abyste předešli přearchivování stávajících skriptů, je nutné nainstalovat starý snapin.

Pro instalaci starého snapinu budete potřebovat účet my.vmware.com, ke kterému se přihlásíte a načtete soubor VMware-PowerCLI-5.1.0-3090428.exe. Po stažení nainstalujte snapin prostřednictvím spustitelného souboru běžnou instalací aplikace systému Windows.

Poté můžete spustit Add-PSSnapin a načíst rutiny VMware do relace nebo spustit poskytnutou konzolu VMware PowerCLI samostatně.

Níže vidíte, že pomocí rutiny Add-PSSnapin přidávám PowerCLI verze 5.1 do aktuální relace konzoly.

PS51> Add-PSSnapin VMware*
PowerCLI snapins

Spustím nainstalovaného samostatného zástupce VMware PowerCLI, který se nainstaluje s verzí 5.1.

PowerCLI v5.1 konzole

Upozorňujeme, že výše uvedený snapin není kompatibilní s prostředím PowerShell 6/7.

Ověření instalace PowerCLI

Ověření úspěšné instalace PowerCLI je stejné bez ohledu na verzi prostředí PowerShell. V prvním kroku potvrďte přítomnost modulů z konzoly prostředí PowerShell.

Get-Module -ListAvailable VMware* 
Dostupné moduly PowerCLI

Následujícím krokem je pokus o připojení k vCenter pomocí rutiny Connect-VIServer PowerCLI. Tím nejen ověříte, zda byl modul úspěšně nainstalován, ale také otestujete, zda se správně připojujete k infrastruktuře.

V systému Windows

PS51> Connect-VIServer <FQDN of vCenter or ESXi Host>
Připojení k vCenter pomocí VMware PowerCLI v systému Windows

V systému Linux

Při ověřování instalace v systému Linux musíte nejprve nastavit konfiguraci připojení tak, aby zohledňovala neplatný (nebo výchozí samopodepsaný certifikát), pokud narazíte na problémy s připojením. Níže pro připojení k vCenter používám PowerCLI.

PS> Set-PowerCLIConfiguration -InvalidCertificateAction:ignorePS> Connect-VIServer <FQDN of vCenter or ESXi Host>
Připojení k vCenter pomocí VMware PowerCLI v Linuxu

Protože se vám podařilo úspěšně připojit ke koncovému bodu VMware, je PowerCLI úspěšně zprovozněno!

Do toho a PowerCLI!

Od tohoto okamžiku jste nyní připraveni odpovědět na onu pověstnou otázku „Jak nainstalovat VMware PowerCLI?“. Nyní můžete začít pracovat na skriptování nasazení konfigurace, zpráv o virtuálních počítačích a úloh údržby. Sledujte tento blog, kde najdete nové a další články o tom, jak začít pracovat s PowerCLI!

Další čtení

  • Jak importovat soubor OVF ve VMware pomocí prostředí PowerShell

.

Napsat komentář

Vaše e-mailová adresa nebude zveřejněna.