Getting Started with PowerCLI: Setup and Configuration

Posted on September 20, 2013 by Jeff Hicks in VMware with 0 Comments

In part one of this multi-part series, we took a look at downloading and installing VMware vSphere PowerCLI, the free PowerShell snapin for managing your VMware infrastructure. Now we need to do something with it. Today I’ll go through the steps of setting up and configuring PowerCLI.

(Need to catch up? Check out the rest of this series! In part three: use PowerCLI to start and shutdown VMs. In part four: PowerCLI and PSDrives, and in part five: created a new VM. Finally, in part six: use PowerCLI to manage your ISO files.)

Add Snapin to PowerShell

Before we can do anything we need to add the snapin to our PowerShell session.

If you are ever in doubt about what version you are running, the snapin has a handy command.

Now we are ready to manage our environment, but first we need to connect to a server.

Sponsored

PowerCLI: Connect to Server

The cmdlet we need is called Connect-VIServer. Take some time to look at full help and examples. The PowerCLI cmdlets also support online help so you can run a command like this:

To connect to a server you need to specify a name or IP address and you need to be authenticated (assuming your current credentials don’t suffice). You can use a saved PSCredential object and specify a username and password, or you can simply run the command and enter credentials when prompted.

If you prefer a simple one-line approach, you can even enter the password as part of the command.

I’m going to connect with a previously created credential object.

A feature you might want to take advantage of – assuming you need to specify credentials – is to securely keep them in the local credential store. When you logon use the –SaveCredentials parameter.

In the future, when you connect to the server all you need to do is specify the server name. Although Connect-VIServer has a cool parameter, -Menu, which will display a text list of recently connected servers.

Sponsored

Configure PowerCLI

The first time you connect you might see a warning like you see below in Figure 1.

Configuring PowerCLI

 

In my environment I’m not using any sort of certificates. But I don’t want to be bothered with the warning, so I’ll follow the suggestion and use the Set-PowerCLIConfiguration cmdlet.

These are the possible values you can use:

  • Unset – This is the default value and is essentially the same as Warn.
  • Prompt – If the server certificate is not trusted the cmdlet will prompt you for a course of action before it continues.
  • Fail – The cmdlet will not establish connection if the certificate is not valid.
  • Ignore – The cmdlet will establish the connection without taking into account that the certificate is invalid or not.
  • Warn – The cmdlet will display a warning saying that the certificate is not valid, the reason why it is not considered valid and then will print additional information about the certificate.

You can always run:

To see the current configuration and change it any time.

Now that we have that out of the way let’s see what servers we can work with using Get-VMHost.

In my case, I only have a single ESXi server but you might see more servers listed. You can also specify a host by name.

Configuring PowerCLI

 

And as with most objects in PowerShell, there is more to the object than what you see here.

Configuring PowerCLI

There are some settings you might want to configure, but we’ll cover those in a future article.

Disconnecting

As long as you are connected to the server you can perform all sorts of management magic, which I will be discussing later. If you close your PowerShell session you will automatically be disconnected. But you can also manually disconnect.

This will disconnect you from the server you are currently connected to. You will be prompted for confirmation. If you prefer not to be bothered, set the confirm parameter to false.

 

I’ve covered several cmdlets for connecting to a VMware infrastructure server and configuring some basic PowerCLI settings. I didn’t cover every possible setting, and your environment may require additional steps. So take the time to read full help and examples for all the cmdlets I’ve demonstrated in this article. Next time we’ll look at some basic virtual machine management.

Sponsored

Tagged with