Learning PowerCLI for VMware VSphere: Automate your Vmware vSphere environment by learning how to install and use PowerCLI. This book takes a practical tutorial approach that will have you automating your daily routine tasks in no time.

There are some PowerShell cmdlets that everyone should know. Knowing these cmdlets will help you to discover other cmdlets, their functions, parameters, and returned objects.

Get-Command [[-ArgumentList] <Object[]>] [-All] [-ListImported] [-Module <String[]>] [-Noun <String[]>] [-ParameterName <String[]>] [-ParameterType <PSTypeName[]>] [-Syntax] [-TotalCount <Int32>] [-Verb <String[]>] [<CommonParameters>]
Get-Command [[-Name] <String[]>] [[-ArgumentList] <Object[]>] [-All] [-CommandType <CommandTypes>] [-ListImported] [-Module <String[]>] [-ParameterName <String[]>] [-ParameterType <PSTypeName[]>] [-Syntax] [-TotalCount <Int32>] [<CommonParameters...

Until now, you have only seen cmdlets. Cmdlets are PowerShell commands. However, PowerShell has another import concept named providers. Providers are accessed through named drives or PSDrives. In the following sections, providers and PSDrives will be explained.

PowerCLI C:> Get-Command -Noun Item,ChildItem,Content,ItemProperty

CommandType Name                ModuleName
----------- ----                ----------
Cmdlet      Add-Content         Microsoft.PowerShell.Management
Cmdlet      Clear-Content       Microsoft...

In PowerCLI, you can create a list of objects. For example, "red","white","blue" is a list of strings. In PowerShell, a list of terms is called an array. An array can have zero or more objects. You can create an empty array and assign it to a variable:

PowerCLI C:\> $Array = @()

You can fill the array during creation using the following command line:

PowerCLI C:\> $Array = @("red","white")

You can use the += operator to add an element to an array:

PowerCLI C:\> $Array += "blue"
PowerCLI C:\> $Array
red
white
blue

If you want to retrieve a specific element of an array, you can use an index starting with 0 for the first element, 1 for the second element, and so on. If you want to retrieve an element from the tail of the array, you have to use -1 for the last element, -2 for the second to last, and so on. You have to use square brackets around the index number. In the next example, the first element of the array is retrieved using the following command...

You can use the Select-Object cmdlet to select certain properties of the objects that you want to return. For example, you can use the following code to return the name and the used space, in GB, of your virtual machines:

PowerCLI C:\> Get-VM | Select-Object -Property Name,UsedSpaceGB

But what if you want to return the used space in MB? The PowerCLI VirtualMachineImpl object has no UsedSpaceMB property. This is where you can use a calculated property. A calculated property is a PowerShell hash table with two elements: Name and Expression. The Name element contains the name that you want to give the calculated property. The Expression element contains a scriptblock with PowerCLI code to calculate the value of the property. To return the name and the used space in MB for all of your virtual machines, run the following command:

PowerCLI C:\> Get-VM |
>> Select-Object -Property Name,
>> @{Name="UsedSpaceMB";Expression={1KB*$_.UsedSpaceGB}}
&gt...

PowerCLI makes it easy to use the VMware vSphere application programming interface (API). There are two ways to do this. The first one is by using the ExtensionData property that most of the PowerCLI objects have. The Extensiondata property is a direct link to the vSphere API object related to the PowerCLI object. The second way is by using the Get-View cmdlet to retrieve the vSphere API object related to a PowerCLI object. Both these ways will be discussed in the following sections.

Sometimes you can have the feeling that a PowerCLI object is missing a property. Although the VMware PowerCLI team tried to include the most useful properties in the objects, you can have the need for an extra property. Luckily, PowerCLI has a way to extend a PowerCLI object using the New-VIProperty cmdlet. This cmdlet has the following syntax:

New-VIProperty [-Name] <String> [-ObjectType] <String[]> [-Value] <ScriptBlock> [-Force] [-BasedOnExtensionProperty <String[]>] [-WhatIf] [-Confirm][<CommonParameters>]
New-VIProperty [-Name] <String> [-ObjectType] <String[]> [-Force] [-ValueFromExtensionProperty] <String> [-WhatIf] [-Confirm] [<CommonParameters>]

Let's start with an example. You will add the VMware Tools' running statuses used in a previous example to the VirtualMachineImpl object using the New-VIProperty cmdlet:

PowerCLI C:\> New-VIProperty -ObjectType VirtualMachine...

In a VMware vSphere environment, you can use folders to organize your infrastructure. In the vSphere web client, you can create folders in the Hosts and Clusters, VMs and Templates, Storage, and Networking inventories. The following screenshot shows an example of folders in the VMs and Templates inventory.

You can browse through these folders using the vSphere PowerCLI Inventory Provider. PowerCLI also has a set of cmdlets to work with these folders: Get-Folder, Move-Folder, New-Folder, Remove-Folder, and Set-Folder.

You can use the Get-Folder cmdlet to get a list of all of your folders:

PowerCLI C:\> Get-Folder

Or you can select specific folders by name using the following command line:

PowerCLI C:\> Get-Folder –Name "Accounting"

All folders are organized in a tree structure under the root folder. You can retrieve the root folder with:

PowerCLI C:\> Get-Folder -NoRecursion

Name                           Type
----                           ----
Datacenters...

In this chapter, you looked at the Get-Help, Get-Command, and Get-Member cmdlets. You learned how to use providers and PSDrives. You also saw how to create a calculated property. Using the raw API objects with the ExtensionData property or the Get-View cmdlet was discussed, and you looked at extending PowerCLI objects with the New-VIProperty cmdlet. At the end, you learned to work with folders and you saw how you can use the New-VIProperty cmdlet to extend the Folder object of PowerCLI with a Path property.

In the next chapter, you will learn more about working with objects in PowerCLI.