lordmilko/PrtgAPI v0.8.2

PrtgAPI 0.8.2

on GitHub

New Features

• PrtgAPI can now generate dynamic sensor parameters for almost any sensor type, allowing almost all sensor types to be programatically created. Parameters for sensor types that require additional information before device interrogation (such as Oracle Tablespace) cannot be dynamically generated.
• Sensor Targets can now be retrieved for unsupported sensor types. Supports all sensor types excluding types that require additional information prior to device interrogation (such as Oracle Tablespace)
• Multiple object and channel properties can now be modified in a single request

Improvements

General

• NewSensorParameters now include properties for common sensor parameters, including Name, Interval, Priority, etc
• Common sensor parameters that are not specified will not be included in the parameter set, allowing PRTG to instantiate these fields with their default values
• RawSensorParameters now have an indexer, allowing instances to be accessed like a Dictionary
• SensorType on RawSensorParameters can now be modified
• Implemented native support for creating new HTTP sensors via HttpSensorParameters
• Sensor history records returned by GetSensorHistory / Get-SensorHistory are now ordered from newest to oldest

C#

• Multiple object properties can now be modified in a single request by specifying a collection of PropertyParameter, ChannelParameter or CustomParameter objects to SetObjectProperty / SetObjectPropertyRaw
• GetSensorHistory now supports specifying a count, limiting the number of results returned within the specified timespan

PowerShell

• RawSensorParameeters now presents as a hybrid PSObject, allowing values to be modified and retrieved from real property names
• New-SensorParameters now have an -Empty parameter. Allows constructing a completely empty set of RawSensorParameters for allowing instantiation without constructing a hashtable
• Set-ObjectProperty / Set-ChannelProperty now support specifying object property names as parameters, allowing multiple properties to be modified in a single request
• Get-ObjectProperty now supports specifying multiple individual properties to retrieve
• Get-SensorHistory will now stream records from PRTG when an -EndDate is specified
• Implemented -Count parameter on Get-SensorHistory. Allows limiting the number of results returned within the specified timespan

New Methods

• PrtgClient.GetDynamicSensorParameters: Create sensor parameters for a specified sensor type
• PrtgClient.Targets.GetSensorTargets: Retrieve sensor targets for unsupported sensor types
• PrtgClient.StreamSensorHistory: Stream large collections of sensor history records from a PRTG Server

New Cmdlets

• Get-SensorType: Retrieve sensor types supported by PRTG

Bugfixes

PowerShell

• Fixed a bug wherein Get-ObjectLog would fail to retrieve records -Since AllTime against certain objects

Breaking Changes

General

• Switched meaning of start date and end date when used with GetSensorHistory / Get-SensorHistory for consistency with GetLogs / Get-ObjectLog. StartDate now refers to the point in time closest to now, whereas EndDate now refers to the point in time furthest from now

C#

• Sensor parameters no longer accept Priority and InheritTriggers in their constructors
• All enum and bool properties on NewSensorParameters are now nullable