PushoverForPS

1.6

The PowerShell PushoverForPS module provides commands for interacting with the Pushover API to send notifications to Android, iOS, and desktop browsers such as Chrome, Firefox, and Safari directly from PowerShell.

PushoverForPS closely follows the API documentation for Pushover. It checks that all tokens, keys, and device names conform to the specified character se
The PowerShell PushoverForPS module provides commands for interacting with the Pushover API to send notifications to Android, iOS, and desktop browsers such as Chrome, Firefox, and Safari directly from PowerShell.

PushoverForPS closely follows the API documentation for Pushover. It checks that all tokens, keys, and device names conform to the specified character sets. The list of availble sounds are not hard-coded; they are retrieved and stored automatically from Pushover. Any parameters that have character limitations are checked for compliance.

The Pushover Groups API is also fully implemented. This allows retrieving of group membership, adding and removing users from groups, enabling and disabling users temporarily, and renaming groups.

Commands are available for the Licensing API that allow you to assign a license to a user, and to check the remaining licenses for an application.

PushoverForPS also includes automatic rate limiting. According to the Pushover API, any identical requests should not be repeated within five seconds of each other. This module checks each request to ensure that it does not match a request sent within the last five seconds. If it has, it will hold the request until five seconds has elapsed.
   
Receive-PushoverReceipt can be set up to poll the Pushover API periodically as a background job to wait until the Emergency notification has been acknowledged. See Get-Help Receive-PushoverReceipt for more information.

For more information run Get-Help PushoverForPS.

To learn about Pushover, go to https://pushover.net/

Minimum PowerShell version

3.0

Installation Options

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

Install-Module -Name PushoverForPS

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)

Chris Carter

Copyright

(c) 2016 Chris Carter. All rights reserved.

Owners

Tags

Pushover PushoverAPI Notifications Android iOS Desktop Chrome Firefox Safari

Functions

Send-Pushover Test-PushoverKey Receive-PushoverReceipt Stop-PushoverRetry Receive-PushoverSound Receive-PushoverGroup Add-PushoverUserToGroup Remove-PushoverUserFromGroup Disable-PushoverUser Enable-PushoverUser Rename-PushoverGroup Set-PushoverLicense Receive-PushoverLicense

Dependencies

This module has no dependencies.

Release Notes

There are now two commands available for the Licensing API: Set-PushoverLicense and Receive-PushoverLicense that let you assign a license to a user, and check the remaining licenses for an application respectively.

I'm still going back and forth on the type of the response returns from the various commands. Right now they are PSCustomObject, but I thought about making them a custom type. Plus, I also keep going back and forth about whether the properties returned should be more in line with .NET and be $response.CalledBackAt vs their current form straight from the Pushover API, $response.Called_Back_At. Any opinions on this would be welcome.

Version History

Version Downloads Last updated
1.6 (current version) 709 6/24/2016
1.5 14 6/22/2016
1.2.1 13 6/22/2016
1.2 10 6/22/2016
1.1.1 9 6/21/2016
1.1 8 6/21/2016
1.0 9 6/20/2016