How-To

How To Install and Use PowerShell and PowerCLI on Linux

PowerShell isn't only for Windows anymore.

• By Tom Fenton
• 06/01/2017

PowerShell is a scripting language and an automation and configuration management framework built on the Microsoft .NET Framework. PowerShell is installed by default on Windows Server 2016 and Windows 10, and can also be installed on many other Windows platforms. In 2016, Microsoft open-sourced PowerShell by releasing Linux and macOS installers for the scripting language.

PowerCLI is a PowerShell interface developed by VMware. It's designed to manage vSphere. When Microsoft open-sourced PowerShell, the company truly made it a cross-platform scripting language. Moreover, shortly after PowerShell was open-sourced, VMware labs released the PowerCLI Core Fling, which enables PowerCLI scripts to run on Linux and macOS, as well as Windows systems running PowerShell.

In this article, I'll demonstrate how to install and configure PowerShell and PowerCLI by using either GitHub as the repository or apt-get on a Linux system.

The Base Virtual Machine
The system on which I installed PowerShell/PowerCLI was an Ubuntu 16.04 2vCPU, 4GB virtual machine (VM) with a 50GB virtual disk, running on a Dell PowerEdge R610. The only applications installed, other than the basic Ubuntu server package, were openssh-server and Lynx (a command-line browser). These two programs were installed on the Ubuntu by running:

apt-get install lynx

apt-get install  openssh-server

I completed the installation, configuration, and running of PowerShell and PowerCLI in the bash shell as root by running:

sudo bash

Installing from GitHub
Because PowerShell was initially released on GitHub, I'll first walk through how I installed it using the PowerShell GitHub repository.

I used Lynx to find and download the package to install PowerShell on Ubuntu 16.04 at the PowerShell for Linux project's page on GitHub (Figure 1). I started Lynx, which was pointed to the PowerShell GitHub repository, by running:

lynx https://github.com/PowerShell/PowerShell/releases/

I downloaded the latest PowerShell installation package for Ubuntu 16.04 (powershell_6.0.0-alpha.18-1ubuntu1.16.04.1_amd64.deb). I then installed it, updated the apt-get index, and installed the PowerShell dependences by running these three commands:

dpkg -i powershell_6.0.0-alpha*deb

apt-get update

apt-get install –f

(Note that the first command will produce errors that can be ignored, as the next two commands will automatically take care of the error issues).

Installing and Using apt-get
In February 2017, Microsoft made packages available that allowed PowerShell to be installed from packages. Because many people prefer to use a package management tool such as apt-get for installation, I'll detail the steps I took to install PowerShell on Ubuntu using apt-get. However, as a precaution, you should use either the GitHub method outlined above or the method below, but not both of them.

First, I imported the public repository GPG keys:

curl  https://packages.microsoft.com/keys/microsoft.asc > MS.key

apt-key add MS.key

Next, I registered the Microsoft repository with apt:

curl https://packages.microsoft.com/config/ubuntu/16.04/prod.list | sudo tee /etc/apt/sources.list.d/microsoft.list

Then I updated apt-get:

sudo apt-get update

Finally, I installed PowerShell:

sudo apt-get install  -y powershell

Using the PowerShell Command Line
After installing PowerShell, I was able to run PowerShell commands from the command line (Figure 2). To confirm that PowerShell was operational, I entered some PowerShell commands:

$PSVersionTable

Get-Date –Format U

Update-help

Get-help

Help get-service

Update-help

Get-Process

get-help  Get-Process –examples

get-help Get-Date  -detailed

exit

Installing PowerCLI on Linux
After installing PowerShell and verifying that it was working, I installed the PowerCLI Core Fling. I used Lynx to locate and download the correct PowerCLI file for my Linux distribution. I then created the directory into which to install the PowerCLI file, moved the file to that directory, installed unzip, unzipped the file and unzipped two files that were zipped inside the zip file. Here are the commands:

lynx https://labs.vmware.com/flings/powercli-core

mkdir -p ~/.local/share/powershell/Modules

cp PowerCLI_Core.zip  ~/.local/share/powershell/Modules

cd   ~/.local/share/powershell/Modules

apt-get install  unzip

unzip  PowerCLI_Core.zip

unzip  PowerCLI.ViCore.zip

unzip  PowerCLI.Vds.zip

After installing the PowerCLI files (Figure 3), it's necessary for PowerShell to have the PowerCLI modules imported into it. PowerShell also needs to be told to ignore certificate problems from vSphere. Do it like this:

powershell

Get-Module  -ListAvailable PowerCLI* | Import-Module

Set-PowerCLIConfiguration  -InvalidCertificateAction Ignore

I then ran a basic PowerCLI command to ensure that PowerCLI was working, then exited out of PowerShell:

Get-VICommand

Exit

Using PowerCLI
Once I had both PowerShell and PowerCLI installed, I created and ran a simple PowerShell script (PCL_Test.ps1) to test it:

Get-Module  -ListAvailable PowerCLI* | Import-Module

Connect-VIServer  -Server 10.0.0.99

Get-VMHost

Get-VM | Select  Name,VMHost, PowerState, MemoryGB

Get-VM | Select  Name, @{N="IP Address";E={@($_.guest.IPAddress[0])}}

$VMs = Get-VM |  Where-Object { $_.PowerState -ne "PoweredOff" -and  $_.Guest.GuestFamily -ne "WindowsGuest" }

$VMs.guest |  Select-Object VM,OSFullName,IPAddress

The start of the output of the script PCL_Test.ps1 can be seen in Figure 4.

Power In Your Hands
PowerCLI is a tool that should be in every vSphere user's toolkit. Now that PowerCLI runs on Linux, even the most Linux-centric users can use PowerCLI to help manage and monitor their vSphere environment.