PrtgAPI 0.7.2
See the version list below for details.
dotnet add package PrtgAPI --version 0.7.2
NuGet\Install-Package PrtgAPI -Version 0.7.2
<PackageReference Include="PrtgAPI" Version="0.7.2" />
paket add PrtgAPI --version 0.7.2
#r "nuget: PrtgAPI, 0.7.2"
// Install PrtgAPI as a Cake Addin
#addin nuget:?package=PrtgAPI&version=0.7.2
// Install PrtgAPI as a Cake Tool
#tool nuget:?package=PrtgAPI&version=0.7.2
C#/PowerShell interface for PRTG Network Monitor
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET Framework | net452 is compatible. net46 was computed. net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
This package has no dependencies.
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last updated |
|---|---|---|
| 0.9.19 | 4,541 | 9/14/2023 |
| 0.9.18 | 2,695 | 11/28/2022 |
| 0.9.17 | 19,449 | 2/24/2022 |
| 0.9.16 | 9,562 | 6/2/2021 |
| 0.9.15 | 437 | 5/7/2021 |
| 0.9.14 | 705 | 11/25/2020 |
| 0.9.13 | 2,845 | 5/7/2020 |
| 0.9.12 | 20,985 | 2/13/2020 |
| 0.9.11 | 841 | 12/9/2019 |
| 0.9.10 | 540 | 12/5/2019 |
| 0.9.9 | 980 | 9/26/2019 |
| 0.9.8 | 728 | 8/19/2019 |
| 0.9.7 | 1,743 | 5/8/2019 |
| 0.9.6 | 660 | 4/3/2019 |
| 0.9.5 | 930 | 1/13/2019 |
| 0.9.4 | 923 | 1/3/2019 |
| 0.9.3 | 749 | 11/20/2018 |
| 0.9.2 | 745 | 11/1/2018 |
| 0.9.1 | 793 | 10/3/2018 |
| 0.9.0 | 817 | 8/27/2018 |
| 0.8.6 | 1,040 | 5/4/2018 |
| 0.8.5 | 1,086 | 4/23/2018 |
| 0.8.4 | 871 | 4/23/2018 |
| 0.8.3 | 977 | 4/2/2018 |
| 0.8.2 | 954 | 3/30/2018 |
| 0.8.1 | 984 | 3/11/2018 |
| 0.8.0 | 1,106 | 2/23/2018 |
| 0.7.3 | 1,270 | 11/20/2017 |
| 0.7.2 | 1,586 | 11/13/2017 |
| 0.7.1 | 1,373 | 10/15/2017 |
| 0.7.0 | 1,301 | 10/6/2017 |
| 0.6.10 | 1,024 | 8/2/2017 |
| 0.6.9 | 955 | 4/24/2017 |
| 0.6.8 | 942 | 4/19/2017 |
| 0.6.7 | 970 | 4/11/2017 |
| 0.6.6 | 921 | 4/10/2017 |
| 0.6.5 | 914 | 4/10/2017 |
| 0.6.4 | 934 | 3/25/2017 |
| 0.6.3 | 994 | 3/22/2017 |
| 0.6.2 | 924 | 3/19/2017 |
| 0.6.1 | 1,619 | 3/8/2017 |
New Features
-Sensors can now be created from scratch. For sensor types supported by PrtgAPI, a sensor parameters type can be used to specify all the settings that will be used for the sensor, with PrtgAPI validating that all required fields have values. For sensor types currently unsupported by PrtgAPI, facilities are provided for constructing a set of custom parameters, optionally including full levels of type safety
-PRTG event logs can now be retrieved from any object. If no object is specified, PrtgAPI automatically retrieves logs for today from the root node. Logs can be retrieved from a specific time frame, with a specific status, and can also be limited so that only a certain number of logs are retrieved
New Methods
-C#: AddSensors: Create a new sensor from a set of sensor parameters
-C#: GetLogs: Retrieve event logs for a PRTG object
-C#: GetStatus: retrieve the status, configuration and version info of a PRTG Server
New Cmdlets
-Add-Sensor: create a new sensor from a set of sensor parameters
-New-SensorParameters: create a new set of sensor parameters of a specified type
-Get-SensorFactorySource: retrieve the source sensors or channels of a Sensor Factory sensor
-Get-ObjectLog: retrieve event logs for a PRTG object (or if no object is specified, for the whole server)
-Get-PrtgStatus: retrieve the status, configuration and version info of a PRTG Server
Improvements
-PS: Move-Object, Set-ObjectPosition, Simulate-ErrorStatus, Sort-PrtgObject and Start-AutoDiscovery now support -WhatIf
-PS: Clone-Sensor, Clone-Group and Clone-Device now only make 4 retries when the new object can't be resolved instead of 5
-PS: Implemented Get-ObjectSetting alias for Get-ObjectProperty
-PS: Cmdlets that perform streaming now only calculate the total number of objects needed to retrieve once instead of twice
-ExeName of EXE/XML sensors can now be retrieved and modified
-InheritTriggers property of objects can now be modified
-If PrtgAPI detects more than 20,000 objects will need to be streamed, PrtgAPI will instead stream objects "serially" (500 items at a time)
-If PrtgAPI fails to deserialize an enum value due to it posessessing a value unknown to PrtgAPI, an exception will now be thrown describing the value that was missing
Bugfixes
-C#: Fixed a bug in GetObjectTotals wherein totals for probe objects would not be properly calculated
-C#: Fixed a bug wherein AddNotificationTriggersAsync and SetNotificationTriggersAsync were validating arguments with a synchronous method instead of an async one
-PS: Edit-NotificationTriggerProperty now throws an an exception when the specified property does not exist on the target trigger parameter type
-PS: Fixed an issue wherein New-SearchFilter would not work when specifying enum properties whose values require serialization
-SetObjectProperty now properly validates values for numeric types
-Fixed a bug wherein PrtgUrl construction would crash when an array of zero SearchFilter objects is specified
-Fixed a bug wherein NotificationTypes property of sensors, devices, groups and probes did not properly report when sensors aren't inherited
-Fixed a bug wherein PrtgAPI would crash attempting to parse a webpage containing an empty dropdown list
-Fixed an issue wherein progress would fail when performing variable progress on a chain containing Action -> Action or Action -> Object -> Action
-Fixed incorrect XmlEnum values for Access.None and Access.Inherited types
Breaking Changes
-C#: Renamed SensorParameters.StatusFilter to SensorParameters.Status
-PS: Renamed New-NotificationTriggerParameter to New-NotificationTriggerParameters
-Renamed NotificationTypes.TriggerInheritance to NotificationTypes.InheritTriggers
-SearchFilter objects now prevent specifying null as a value. If you wish to specify no value, specify an empty string
-Moved Comments property from base type ObjectTable to more derived type SensorOrDeviceOrGroupOrProbe
-Moved property Status from SensorOrDeviceOrGroupOrProbeOrMessageOrTicket to more derived type SensorOrDeviceOrGroupOrProbe
---
PrtgAPI is a C#/PowerShell library that abstracts away the complexity of interfacing with the PRTG HTTP API.
PrtgAPI implements a collection of methods and enumerations that help create and execute the varying HTTP GET requests required to interface with PRTG. All responses from PRTG are automatically deserialized by PrtgAPI.
Operations supported by PrtgAPI include enumerating channels, sensors, devices, groups and probes, modifying channel and sensor properties, creating and editing notification triggers, pausing, unpausing and acknowledging objects, renaming and removing items, and more.
PrtgAPI includes full XML Documentation and supports synchronous, asynchronous and "streaming" request modes.
This module can be installed in both Visual Studio and PowerShell via the Install-Package cmdlet. For PowerShell users without the nuget.org package source, this module is also available on the PowerShell Gallery.
For more information and usage examples, please see the Project Site.