lordmilko/PrtgAPI v0.9.2

PrtgAPI 0.9.2

on GitHub

New Features

• Implemented support for retrieving sub object properties via new GetObjectPropertyRaw overload on PrtgClient and new -SubId and -RawSubType parameters on Get-ObjectProperty (#39)

New Methods

PrtgClient.RefreshSystemInfo: refresh one or more types of system information of a specified device

New Cmdlets

Refresh-SystemInfo: refresh one or more types of system information of a specified device

Improvements

General

• Implemented brand new high performance deserialization engine based on XmlReader and expression trees. Massively decreases memory usage and improves deserialization performance in applications that continuously retrieve a large amount of data from PRTG
• System Information objects now include a LastUpdated property. Specifies the last date/time the specified information was retrieved by PRTG from the source device
• PrtgAPI now automatically uses default network credentials when connecting behind a proxy (#41)
• Geolookups performed when setting ObjectProperty.Location now automatically use HERE maps when utilizing PRTG 17.4+
• Implemented new -Id parameter on Get-ObjectProperty. Allow retrieving properties from a single object ID
• ObjectProperty based members defined on NewObjectParameters types now automatically set any dependent properties when they are modified. e.g. setting the Interval property of a NewSensorParameters object will now automatically set InheritInterval to false.

Note that if you have defined your own custom parameter type that derives from RawSensorParameters, dependent properties will only be set when modifying a property that already exists in the underlying parameter set, This ensures that parameters initialized to their default values in the constructor do not inadvertently start flipping dependent properties before the user has done anything. To ensure reliable operation of your parameters object, either initialize your properties on the constructor or use the property's raw string name in your getter/setter rather than an ObjectProperty enum value.

PowerShell

• Set-ObjectPosition now allows specifying a directional (Up, Down, Top, Bottom) or absolute (3) position
• Implemented new -LogLevel parameter on Connect-GoPrtgServer (GoPrtg)

Bugfixes

General

• Fixed TriggerSensorState.PartialDown failing to deserialize in PRTG 18.4
• Fixed decimal values potentially not deserializing properly when there is a mismatch between number culture of the PRTG Core and system running PrtgAPI
• Fixed an issue wherein PrtgAPI would crash attempting to retrieve System Information when info contained properties not quoted properly (such as serial numbers presented as numbers that contain letters)

Breaking Changes

General

• IParameters.Cookie is no longer settable
• Merged duplicate ObjectProperty / SensorSettings properties EnableChangeTriggera and NotifyStarted into new property NotifyChanged

C#

• Renamed enum HTTPMode to HttpMode