Get-AzureRmVmPublicIP.ps1

Function Get-AzureRmVmPublicIP {
<#
    .SYNOPSIS
        Correlate AzureRM VMs, NetworkInterfaces, and Public IPs
    
    .DESCRIPTION
        Correlate AzureRM VMs, NetworkInterfaces, and Public IPs

        Prerequisites:
            
            * You have the AzureRM module
            * You're authenticated
            * You're running PowerShell 4 or later

    .PARAMETER ResourceGroupName
        Query this resource group

    .PARAMETER VMName
        One or more VM names to include.  Accepts wildcards.  Defaults to all.

    .PARAMETER IncludeObjects
        If specified, include VM, NIC, and PIP (Public IP) properties on each entry

    .PARAMETER VMStatus
        If specified, the VM property from IncludeObjects will include data from Get-AzureRmVm '-Status'

        Using this switch will trigger IncludeObjects

    .EXAMPLE
        Login-AzureRmAccount
        Get-AzureRmVmPublicIP -ResourceGroupName 'my-resource-group'

            # VMName  NICName    PublicIP
            # ------  -------    --------
            # VM-2    VM-2-NIC   23.96.1.2
            # VM-3    VM-3-NIC   23.96.1.3
            # VM-4    VM-4-NIC   168.61.2.1
            # VM-16   VM-16-NIC  168.61.10.27
            # VM-17   VM-17-NIC  23.96.17.56
            # VM-18   VM-18-NIC  23.96.19.71
            # VM-1    VM-1-NIC   Not Assigned

        # List VMs, NICS, and Public IPs in 'my-resource-group'

    .EXAMPLE
        Login-AzureRmAccount
        Get-AzureRmVmPublicIP -ResourceGroupName 'my-resource-group' -VMName VM-1* -IncludeObjects

            # ...
            # VMName   : VM-18
            # NICName  : VM-18-NIC
            # PublicIP : 23.96.19.71
            # VM       : Microsoft.Azure.Commands.Compute.Models.PSVirtualMachine
            # NIC      : Microsoft.Azure.Commands.Network.Models.PSNetworkInterface
            # PIP      : Microsoft.Azure.Commands.Network.Models.PSPublicIpAddress

            # VMName   : VM-1
            # NICName  : VM-1-NIC
            # PublicIP : Not Assigned
            # VM       : Microsoft.Azure.Commands.Compute.Models.PSVirtualMachine
            # NIC      : Microsoft.Azure.Commands.Network.Models.PSNetworkInterface
            # PIP      : Microsoft.Azure.Commands.Network.Models.PSPublicIpAddress

        # Get VMs, NICs, and Public IPs in 'my-resource-group'
        # with name like VM-1*
        # Include the VM, Network Interface (NIC), and Public IP (PIP) objects properties

    .EXAMPLE
        $Details = Get-AzureRmVmPublicIP -ResourceGroupName 'my-resource-group' -VMStatus
        $Details[0]

            # VMName   : VM-18
            # NICName  : VM-18-NIC
            # PublicIP : 23.96.19.71
            # VM       : Microsoft.Azure.Commands.Compute.Models.PSVirtualMachineInstanceView <<<<
            # NIC      : Microsoft.Azure.Commands.Network.Models.PSNetworkInterface
            # PIP      : Microsoft.Azure.Commands.Network.Models.PSPublicIpAddress

        # All sorts of data to explore in the VM property.  Output from Get-AzureRmVm -Name <ThisVm> -Status
        $Details[0].VM.VMAgent.ExtensionHandlers

            # Type                                        TypeHandlerVersion Status                                                      
            # ----                                        ------------------ ------                                                      
            # Microsoft.Azure.Diagnostics.IaaSDiagnostics 1.7.1.0            Microsoft.Azure.Management.Compute.Models.InstanceViewStatus
            # Microsoft.Compute.BGInfo                    2.1                Microsoft.Azure.Management.Compute.Models.InstanceViewStatus
            # Microsoft.Compute.CustomScriptExtension     1.8                Microsoft.Azure.Management.Compute.Models.InstanceViewStatus

    .EXAMPLE

        Get-AzureRmVmPublicIP -ResourceGroupName $ResourceGroup -VMName VM-18 -VMStatus |
        Select -Property VMName,
                         PublicIP,
                         @{ label = "PrivateIP"; expression = {$_.NIC.IpConfigurations.PrivateIpAddress} },
                         @{ label = "VMAgentStatus"; expression = {$_.VM.VMAgent.Statuses[0].DisplayStatus} }

            # VMName PublicIP    PrivateIP    VMAgentStatus
            # ------ --------    ---------    -------------
            # VM-18  23.96.19.71 10.1.2.5     Ready       

        # Pull details from VM-18,
        # extract private IP from the NIC, and the first VMAgent status we find from the VM

    .FUNCTIONALITY
        Azure
#>
    [cmdletbinding()]
    param(
        [string[]]$ResourceGroupName,
        [string[]]$VMName,
        [switch]$IncludeObjects,
        [switch]$VMStatus
    )

    foreach($ResourceGroup in $ResourceGroupName)
    {

        # Here's an absurd snippet of code to extract all VMs, NICs, and Public IPs, and correlate them together.
        # From what I can tell, the Azure team didn't provide the usual pipeline support...
        # This method will skip public IPs that aren't bound to a NIC, or NICs that aren't bound to a VM
        Try
        {
            $AllVMs = @( Get-AzureRMVm -ResourceGroupName $ResourceGroup -ErrorAction Stop )
        }
        Catch
        {
            Write-Error $_
            Write-Error "Could not extract VMs from resource group '$ResourceGroup'"
            continue
        }
        Try
        {
            $NICS = @( Get-AzureRmNetworkInterface -ResourceGroupName $ResourceGroup -ErrorAction Stop )
        }
        Catch
        {
            Write-Error $_
            Write-Error "Could not extract network interfaces from resource group '$ResourceGroup'"
            continue
        }
        Try
        {
            $PublicIPS = @( Get-AzureRmPublicIpAddress -ResourceGroupName $ResourceGroup -ErrorAction Stop)
        }
        Catch
        {
            Write-Error $_
            Write-Error "Could not extract public IPs from resource group '$ResourceGroup'"
            continue
        }

        # Allow wildcard support for each name in array... filter dupes
        $TheseVMs = foreach($VM in $AllVMs)
        {
            if($VMName)
            {
                foreach($Name in $VMName)
                {
                    if($VM.Name -like $Name)
                    {
                        $VM
                    }
                }
            }
            else
            {
                $VM
            }
        }
        $TheseVMs = @( $TheseVMs | Sort Name -Unique )

        # Correlate. Uses PS4 language.
        Foreach($nic in $nics)
        {
            $VMs = $null   
            $VMs = $TheseVMs.Where({$_.Id -eq $nic.virtualmachine.id})
            $PIPS = $null
            $PIPS = $PublicIPS.Where({$_.Id -eq $nic.IpConfigurations.publicipaddress.id})
            foreach($VM in $VMs)
            {
                if($VMStatus)
                {
                    Try
                    {
                        $VMDetail = Get-AzureRMVm -ResourceGroupName $ResourceGroup -Status -Name $VM.Name -ErrorAction stop
                    }
                    Catch
                    {
                        Write-Error $_
                        Write-Error "Could not extract '-Status' details from $($VM.Name) in resource group $ResourceGroup. Falling back to non detailed"
                        $VMDetail = $VM
                    }
                    if(-not $IncludeObjects)
                    {
                        $IncludeObjects = $True
                    }
                }
                else
                {
                    $VMDetail = $VM
                }

                foreach($PIP in $PIPS)
                {
                    # Include VM, NIC, Public IP (PIP) raw objects if desired
                    $Output = [ordered]@{
                        ResourceGroupName = $ResourceGroup
                        VMName = $VM.Name
                        NICName = $nic.Name
                        PublicIP = $PIP.IpAddress
                    }

                    if($IncludeObjects)
                    {
                        $Output.Add('VM', $VMDetail)
                        $Output.Add('NIC', $NIC)
                        $Output.Add('PIP', $PIP)
                    }

                    [pscustomobject]$Output
                }
            }
        }
    }
}