1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106

function Get-VMGuestInfo
{
<#
    .SYNOPSIS
 
        Gets virtual machine guest information
 
    .EXAMPLE
 
        Get-VMGuestInfo -VMName Test01
 
    .EXAMPLE
 
        Get-VMGuestInfo -VMName Test01 -HyperVHost Host01
 
    .NOTES
 
        Author: Yusuf Ozturk
        Website: http://www.yusufozturk.info
        Email: ysfozy[at]gmail.com
 
#>
 
[CmdletBinding(SupportsShouldProcess = $true)]
param (
 
    [Parameter(
        Mandatory = $true,
        HelpMessage = 'Virtual Machine Name')]
    $VMName,
 
    [Parameter(
        Mandatory = $false,
        HelpMessage = 'Hyper-V Host Name')]
    $HyperVHost = "localhost",
 
	[Parameter(
        Mandatory = $false,
        HelpMessage = 'Debug Mode')]
    [switch]$DebugMode = $false
)
	# Enable Debug Mode
	if ($DebugMode)
	{
		$DebugPreference = "Continue"
	}
	else
	{
		$ErrorActionPreference = "silentlycontinue"
	}
 
	$VMState = (Get-VM -ComputerName $HyperVHost -Name $VMName).State
 
	if ($VMState -eq "Running")
	{
		filter Import-CimXml
		{
			$CimXml = [Xml]$_
			$CimObj = New-Object -TypeName System.Object
			foreach ($CimProperty in $CimXml.SelectNodes("/INSTANCE/PROPERTY"))
			{
				if ($CimProperty.Name -eq "Name" -or $CimProperty.Name -eq "Data")
				{
					$CimObj | Add-Member -MemberType NoteProperty -Name $CimProperty.NAME -Value $CimProperty.VALUE
				}
			}
			$CimObj
		}
 
		$VMConf = Get-WmiObject -ComputerName $HyperVHost -Namespace "root\virtualization\v2" -Query "SELECT * FROM Msvm_ComputerSystem WHERE ElementName like '$VMName' AND caption like 'Virtual%' "
		$KVPData = Get-WmiObject -ComputerName $HyperVHost -Namespace "root\virtualization\v2" -Query "Associators of {$VMConf} Where AssocClass=Msvm_SystemDevice ResultClass=Msvm_KvpExchangeComponent"
		$KVPExport = $KVPData.GuestIntrinsicExchangeItems
 
		if ($KVPExport)
		{
			# Get KVP Data
			$KVPExport = $KVPExport | Import-CimXml
 
			# Get Guest Information
			$VMOSName = ($KVPExport | where {$_.Name -eq "OSName"}).Data
			$VMOSVersion = ($KVPExport | where {$_.Name -eq "OSVersion"}).Data
			$VMHostname = ($KVPExport | where {$_.Name -eq "FullyQualifiedDomainName"}).Data
		}
		else
		{
			$VMOSName = "Unknown"
			$VMOSVersion = "Unknown"
			$VMHostname = "Unknown"
		}
	}
	else
	{
		$VMOSName = "Unknown"
		$VMOSVersion = "Unknown"
		$VMHostname = "Unknown"
	}
 
	$Properties = New-Object Psobject
	$Properties | Add-Member Noteproperty VMName $VMName
	$Properties | Add-Member Noteproperty VMHost $HyperVHost
	$Properties | Add-Member Noteproperty VMState $VMState
	$Properties | Add-Member Noteproperty VMOSName $VMOSName
	$Properties | Add-Member Noteproperty VMOSVersion $VMOSVersion
	$Properties | Add-Member Noteproperty VMHostname $VMHostname
	Write-Output $Properties
}

function Get-VMGuestInfo { <# .SYNOPSIS Gets virtual machine guest information .EXAMPLE Get-VMGuestInfo -VMName Test01 .EXAMPLE Get-VMGuestInfo -VMName Test01 -HyperVHost Host01 .NOTES Author: Yusuf Ozturk Website: http://www.yusufozturk.info Email: ysfozy[at]gmail.com #> [CmdletBinding(SupportsShouldProcess = $true)] param ( [Parameter( Mandatory = $true, HelpMessage = 'Virtual Machine Name')] $VMName, [Parameter( Mandatory = $false, HelpMessage = 'Hyper-V Host Name')] $HyperVHost = "localhost", [Parameter( Mandatory = $false, HelpMessage = 'Debug Mode')] [switch]$DebugMode = $false ) # Enable Debug Mode if ($DebugMode) { $DebugPreference = "Continue" } else { $ErrorActionPreference = "silentlycontinue" } $VMState = (Get-VM -ComputerName $HyperVHost -Name $VMName).State if ($VMState -eq "Running") { filter Import-CimXml { $CimXml = [Xml]$_ $CimObj = New-Object -TypeName System.Object foreach ($CimProperty in $CimXml.SelectNodes("/INSTANCE/PROPERTY")) { if ($CimProperty.Name -eq "Name" -or $CimProperty.Name -eq "Data") { $CimObj | Add-Member -MemberType NoteProperty -Name $CimProperty.NAME -Value $CimProperty.VALUE } } $CimObj } $VMConf = Get-WmiObject -ComputerName $HyperVHost -Namespace "root\virtualization\v2" -Query "SELECT * FROM Msvm_ComputerSystem WHERE ElementName like '$VMName' AND caption like 'Virtual%' " $KVPData = Get-WmiObject -ComputerName $HyperVHost -Namespace "root\virtualization\v2" -Query "Associators of {$VMConf} Where AssocClass=Msvm_SystemDevice ResultClass=Msvm_KvpExchangeComponent" $KVPExport = $KVPData.GuestIntrinsicExchangeItems if ($KVPExport) { # Get KVP Data $KVPExport = $KVPExport | Import-CimXml # Get Guest Information $VMOSName = ($KVPExport | where {$_.Name -eq "OSName"}).Data $VMOSVersion = ($KVPExport | where {$_.Name -eq "OSVersion"}).Data $VMHostname = ($KVPExport | where {$_.Name -eq "FullyQualifiedDomainName"}).Data } else { $VMOSName = "Unknown" $VMOSVersion = "Unknown" $VMHostname = "Unknown" } } else { $VMOSName = "Unknown" $VMOSVersion = "Unknown" $VMHostname = "Unknown" } $Properties = New-Object Psobject $Properties | Add-Member Noteproperty VMName $VMName $Properties | Add-Member Noteproperty VMHost $HyperVHost $Properties | Add-Member Noteproperty VMState $VMState $Properties | Add-Member Noteproperty VMOSName $VMOSName $Properties | Add-Member Noteproperty VMOSVersion $VMOSVersion $Properties | Add-Member Noteproperty VMHostname $VMHostname Write-Output $Properties }

Get-VMGuestInfo -VMName TEST01 -HyperVHost VMHOSTT01

Get-VMGuestInfo -VMName TEST01 -HyperVHost VMHOSTT01

VMName      : TEST01
VMHost      : VMHOSTT01
VMState     : Running
VMOSName    : Windows Server 2008 R2 Enterprise
VMOSVersion : 6.1.7601
VMHostname  : TEST01.domain.contoso.com

VMName : TEST01 VMHost : VMHOSTT01 VMState : Running VMOSName : Windows Server 2008 R2 Enterprise VMOSVersion : 6.1.7601 VMHostname : TEST01.domain.contoso.com