On a recent project, I needed a list of all the VMs running in a subscription with some of each VMs properties. We had an Excel Spreadsheet with all the VMs and properties, but going through that was a real pain. So, I wrote a basic PowerShell script to collect the information I needed and figured I would share it. The script is pretty straightforward (full script is at the end of the post) and does the following:
- Logs into Azure
- Gets all the Virtual Machines
- Gets specific properties of each VM
- Generates a Grid View with all the selected properties
Logging into Azure
Logging into Azure from PowerShell is a simple command:
[powershell]Login-AzureRmAccount[/powershell]
Note that this may fail if you have never used your computer to connect to Azure using PowerShell. If that is the case, you will need to download and import the PublishSettings file form Windows Azure and import it into your computer. Instructions on how to do this are found here.
Once that command is executed, you'll be presented with the Azure Login page (as shown below). Simply log into Azure using your Azure credentials and your PowerShell session will be authenticated with your Azure account.
If the login is successful, you'll get something similar to the screenshot below:
Get Virtual Machines
Next, let's get all the VMs in our subscription using the Get-AzureRMVM command. Once you run that command, you'll see a ton of information scroll by on the screen, to make it simpler, lets store the output in a variable:
[powershell]$RMVMs=Get-AzurermVM[/powershell]
We'll use this object in the next section...
Get VM Properties
One of the most important properties we'll use is the name of the VM. If you look at the text that flew by earlier (or type in $RMVMs to see it again), you'll notice all the properties that are available to you. One of them, is Name:
We can display just the names of the VMs in the $RMVMs object by appending .Name on the end:
[powershell]$RMVMs.Name[/powershell]
The output will return just the names:
[powershell]VM1
VM2[/powershell]
Nested properties, such as OSType are just as straightforward to get:
[powershell]$RMVMs.storageprofile.osdisk.ostype[/powershell]
Will return:
[powershell]Windows
Windows[/powershell]
Feel free to look through the properties available. Next, we will display it in the Grid View.
Display in a Grid View
For the Grid View, we need an array with all the properties that we want to collect. First, we need an empty array that we'll call $RMVMArray:
[powershell]$RMVMArray = @()[/powershell]
Next, we'll loop through each of the VMs in the RMVMs object:
[powershell]foreach ($vm in $RMVMs) { ... }[/powershell]
And add some properties we want to see:
[powershell] foreach ($vm in $RMVMs) { # Generate Array $RMVMArray += New-Object PSObject -Property @{
Name = $vm.Name; Location = $vm.Location; OSType = $vm.StorageProfile.OsDisk.OsType; } }[/powershell]
Finally, we can display the Grid View:
[powershell]$RMVMArray | Out-Gridview[/powershell]
You'll get a Grid View similar to the one below:
Pulling it all together
Now that we have each of the pieces, lets pull it into a script that we can simply run every time we want to get a list of the VMs in our Subscription and their properties. In my case, I called the script GetRMVMProperties.ps1. And the full code:
[powershell]# Log in to Azure Login-AzureRmAccount
# Make sure there is at least one VM in the Subscription ($RMVMs=Get-AzurermVM) > 0
# Create array to contain all the VMs in the subscription $RMVMArray = @()
# Loop through VMs foreach ($vm in $RMVMs) { # Get VM Status (for Power State) $vmStatus = Get-AzurermVM -Name $vm.Name -ResourceGroupName $vm.ResourceGroupName -Status
# Generate Array $RMVMArray += New-Object PSObject -Property @{`
# Collect Properties Name = $vm.Name; PowerState = (get-culture).TextInfo.ToTitleCase(($vmStatus.statuses)[1].code.split("/")[1]); Location = $vm.Location; Tags = $vm.Tags Size = $vm.HardwareProfile.VmSize; ImageSKU = $vm.StorageProfile.ImageReference.Sku; OSType = $vm.StorageProfile.OsDisk.OsType; OSDiskSizeGB = $vm.StorageProfile.OsDisk.DiskSizeGB; DataDiskCount = $vm.StorageProfile.DataDisks.Count; DataDisks = $vm.StorageProfile.DataDisks; } }
# Gridview output $title = "VMs in the '{0}' Subscription" -f $Subscriptions.SubscriptionName $RMVMArray | Sort-Object -Property Name | Out-Gridview -Title $title[/powershell]
Next Steps
It actually took considerably longer to write this blog post than to write the script. The customer that I wrote this script for has multiple subscriptions, so that's the next step.... Modify the script to automatically step through each subscription and generate a Grid View for each.