PrtgAPI

0.8.6

C#/PowerShell interface for interacting with the PRTG HTTP API

Installation Options

Copy and Paste the following command to install this package using PowerShellGet More Info

Install-Module -Name PrtgAPI -RequiredVersion 0.8.6

You can deploy this package directly to Azure Automation. Note that deploying packages with dependencies will deloy all the dependencies to Azure Automation. Learn More

Manually download the .nupkg file to your system's default download location. Note that the file won't be unpacked, and won't include any dependencies. Learn More

Author(s)

lordmilko

Copyright

(c) 2015 lordmilko. All rights reserved.

Owners

Tags

Prtg Sensor Device Group Probe Channel Notification Action Trigger Remove Pause Resume Check Acknowledge PowerShell Setting Property

Cmdlets

Get-DeviceTemplate Disable-PrtgProgress Enable-PrtgProgress Get-SensorType Get-SensorTarget Add-Device Add-Group New-DeviceParameters New-GroupParameters Backup-PrtgConfig Clear-PrtgCache Sync-PrtgConfigFile Restart-PrtgCore Restart-Probe Get-ObjectLog Add-Sensor Get-SensorFactorySource New-SensorParameters Get-SensorHistory Move-Object Set-ObjectPosition Test-ErrorStatus Start-SortPrtgObject Open-PrtgObject Start-AutoDiscovery Copy-Object Get-PrtgSchedule New-SensorFactoryDefinition Add-NotificationTrigger Set-NotificationTrigger Edit-NotificationTriggerProperty Get-NotificationAction Get-PrtgStatus Get-NotificationTrigger Get-ModificationHistory New-NotificationTriggerParameters Remove-NotificationTrigger Set-ObjectProperty Confirm-Sensor Get-Channel Get-Group Get-Probe Get-ObjectProperty Get-PrtgClient Get-SensorTotals Update-Object Suspend-Object Rename-Object Resume-Object Set-ChannelProperty Remove-Object Get-Device Connect-PrtgServer Disconnect-PrtgServer Get-Sensor New-SearchFilter

Functions

New-Credential Connect-GoPrtgServer Get-GoPrtgServer Install-GoPrtgServer Set-GoPrtgAlias Uninstall-GoPrtgServer Update-GoPrtgCredential

Dependencies

This module has no dependencies.

Release Notes


New Features
---------------
* Implemented support for specifying a hashtable of -RawParameters to Set-ObjectProperty

New Cmdlets
---------------
* Get-PrtgSchedule: Retrieve all monitoring schedules supported by PRTG

Improvements
----------------
* Implemented support for retrieving Proxy Settings for HTTP Sensors, *Scanning Intervals and Schedules, Dependencies and Maintenance Window settings from devices, groups and probes
* New-SearchFilter now accepts a -Value of type object rather than string
* Implemented support for opening notification actions and schedules via Open-PrtgObject
* Removed unnecessary call to PrtgClient.GetGroups in Get-Sensor when specifying -Resolve:$false

Bugfixes
----------

* Fixed an issue wherein NotificationAction objects returned as part of a NotificationTrigger did not lazily deserialize all of their properties
* Probe parameters now prevent filtering by a ParentId other than 0
* PrtgAPI now correctly serializes DateTime and TimeSpan objects specified in search filters
* A more descriptive error message is now thrown when attempting to filter by a Status of 0
* Fixed several instances of cmdlets not properly unwrapping PSObject values
* Fixed a bug wherein Channel parameter of Set-ChannelProperty was not mandatory on Default and Dynamic parameter sets
* PrtgAPI now consistently displays all results when performing queries like Get-Sensor ping -Count 1. For more information, see the release notes for this version on GitHub

---

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 and formatted appropriately when output to the pipeline (when using PowerShell)

All cmdlets in PrtgAPI support some level of piping, allowing you to directly chain multiple cmdlets together, further filtering search results as you go.

PrtgAPI supports a number of undocumented features, including manipulating notification triggers, and viewing and editing channel properties (error limits, etc).

PrtgAPI includes full Cmdlet Comment/XmlDoc documentation. Detailed information on any cmdlet can be found within PowerShell by running Get-Help <cmdlet> or Get-Help <cmdlet> -Full

For examples and usage scenarios, please see the Project Site.

Version History

Version Downloads Last updated
0.9.11 160 12/9/2019
0.9.10 128 12/5/2019
0.9.9 1,425 9/26/2019
0.9.8 788 8/19/2019
0.9.7 1,814 5/8/2019
0.9.6 687 4/3/2019
0.9.5 1,306 1/13/2019
0.9.4 120 1/3/2019
0.9.3 43,306 11/20/2018
0.9.2 411 11/1/2018
0.9.1 254 10/3/2018
0.9.0 197 8/27/2018
0.8.6 (current version) 810 5/4/2018
0.8.5 36 4/23/2018
0.8.4 8 4/23/2018
0.8.3 48 4/2/2018
0.8.2 7 3/30/2018
0.8.1 58 3/11/2018
0.8.0 155 2/23/2018
0.7.3 151 11/20/2017
0.7.2 30 11/13/2017
0.7.1 32 10/15/2017
0.7.0 15 10/6/2017
0.6.10 48 8/2/2017
0.6.9 74 4/24/2017
0.6.8 27 4/19/2017
0.6.7 14 4/11/2017
0.6.6 7 4/10/2017
0.6.5 7 4/10/2017
0.6.4 15 3/25/2017
0.6.3 7 3/22/2017
0.6.2 8 3/19/2017
0.6.1 9 3/14/2017
Show less