Windows Mangement Remote Mangement / WinRM can be configured as HTTPS / encrypted connection instead of using clear text transfer of the provided information. In order to do this you need to configure it accordingly and have a valid machine certificate installed on the system.
Now – the advantage here is clearly the added security layer while you request and receive those information. More information on how to do this can be found here: https://support.microsoft.com/en-us/help/2019527/how-to-configure-winrm-for-https
Only it becomes a challenge when you want to use PowerShell and e.g. PRTG to use this HTTPS encrypted system. I came across this request and had to create a script that actually works with such an HTTPS encrypted SSL session to WinRM. You can find it below.
What it does is rather simple:
- set the CimSessionOptions to use SSL
- additionally it bypasses the certification checks by default – you might want to adjust this depending on your network configuration
- it creates a new CimSession to your target system using the UseSSL option
- and finally it executes a few queries against this session
- the data in this example is then translated in to a PRTG compatible XML structure so you could use it in a Advanced EXE/XML sensor within PRTG
The data in this example combines information about the CPU(s), HardDrives / HDD(s) (only installed drives, not USB) and Memory usage to PRTG in a single sensor while using channels.
Due to some dynamic of the script, you want to make sure you have fixed upper and lower error limits on especially the channel Total Disks – so if something changes you can re-create the sensor due to it’s fixed channels once it did run the first time.
In theory you could provide limits within the XML response to PRTG – this is up to you – I always liked it more to configure them solely in PRTG in the sensor channels so I could adjust them per device.
PS: This was originally posted in the private PRTG channel on SpiceWorks here.
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 | param( [string]$device ) #$cred = Get-Credential #you need to somehow get them in - from a file or as parameters... up to you actually... in theory the PRTG Probe would do that already and you wouldn't need it $CIMSessionOptions = New-CimSessionOption -SkipCACheck -SkipCNCheck -SkipRevocationCheck -UseSsl #-UseSSL is important - the rest - well - I bypassed the certificate checks.. up to your environment in the end... $CIMSession = New-CimSession -ComputerName $Server -SessionOption $CIMSessionOptions #-Credential $cred $WMI_OS = Get-CimInstance -CimSession $CIMSession -ClassName Win32_OperatingSystem $WMI_CPU = Get-CimInstance -CimSession $CIMSession -ClassName win32_processor $WMI_DISK = Get-CimInstance -CimSession $CIMSession -ClassName Win32_LogicalDisk #CPU table processing foreach ($CPU in $WMI_CPU){ $CPUsTotal += 1 $XMLCPUs += "<result><channel>CPU Load #$CPUsTotal</channel><value>" + $CPU.LoadPercentage + "</value><unit>Percent</unit></result>" } #DISK table processing foreach ($Disk in $WMI_DISK){ if ($Disk.DriveType -eq 3) { #DriveType = 3 means it is a LOCAL FIXED DISK $DISKsTotal += 1 $XMLDisks += "<result><channel>Drive " + $Disk.DeviceID + "</channel><value>" + $Disk.FreeSpace + "</value><VolumeSize>Byte</VolumeSize></result>" $XMLDisks += "<result><channel>Drive " + $Disk.DeviceID + "</channel><value>" + [math]::Round(($Disk.FreeSpace/$Disk.Size)*100,2).tostring("###") + "</value><float>1</float><unit>Percent</unit></result>" } } $XML="<prtg> <result> <channel>Total CPUs</channel> <value>" + $CPUsTotal + "</value> <unit>Count</unit> </result> $XMLCPUs <result> <channel>Total Disks</channel> <value>" + $DISKsTotal + "</value> <unit>Count</unit> </result> $XMLDisks <result> <channel>Memory total</channel> <value>" + $WMI_OS.TotalVisibleMemorySize + "</value> <VolumeSize>Bytes</VolumeSize> </result> <result> <channel>Memory free</channel> <value>" + $WMI_OS.FreeVirtualMemory + "</value> <VolumeSize>Bytes</VolumeSize> </result> <result> <channel>Memory used</channel> <value>" + ($WMI_OS.TotalVisibleMemorySize - $WMI_OS.FreeVirtualMemory) + "</value> <VolumeSize>Bytes</VolumeSize> </result> <result> <channel>Memory free in percent</channel> <value>" + [math]::Round(($WMI_OS.FreePhysicalMemory/$WMI_OS.TotalVisibleMemorySize)*100,2) + "</value> <float>1</float> <unit>Percent</unit> </result> <result> <channel>Memory used in percent</channel> <value>" + [math]::Round(100-(($WMI_OS.FreePhysicalMemory/$WMI_OS.TotalVisibleMemorySize)*100),2) + "</value> <float>1</float> <unit>Percent</unit> </result> </prtg> " Function WriteXmlToScreen ([xml]$xml) #just to make it clean XML code... { $StringWriter = New-Object System.IO.StringWriter; $XmlWriter = New-Object System.Xml.XmlTextWriter $StringWriter; $XmlWriter.Formatting = "indented"; $xml.WriteTo($XmlWriter); $XmlWriter.Flush(); $StringWriter.Flush(); Write-Output $StringWriter.ToString(); } WriteXmlToScreen "$XML" |