Skip to content

A Powershell module to send messages using the Pushover API

Notifications You must be signed in to change notification settings

Kieranties/PS-Pushover

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 

Repository files navigation

PS-Pushover

A PowerShell module to send messages over the Pushover API

Requires: PowerShell 3.0

Install

To get up and running using the module run the following

<#
    .SYNOPSIS
    Simple install script for PS-Pushover
#>

$moduleName = "PS-Pushover"
$branch = "master"
$urlStub = "https://raw.github.com/Kieranties/$moduleName/$branch/"
$psm = "$urlStub$moduleName.psm1"

$client = New-Object System.Net.WebClient
$modPath = $env:PSModulePath.Split(";") | ? { $_ } | select -First 1 # or wherever you put your modules
$modFolder = New-Item (Join-Path $modPath $moduleName) -ItemType directory -Force # force used so you can use same script to update

$psm | % {
    $fileName = Split-Path $_ -leaf
    $client.DownloadFile($_, (Join-Path $modFolder $filename))
}

"$moduleName install complete"

Setup

You'll need to do the following before making use of the module

Create a Pushover Application

  • Visit the new application page and create an application for yourself
  • Take note of the API Token/Key
  • Visit the Pushover homepage
  • Take note of your User Key

(Optional) Setting session parameters in profile

The function Send-PushoverMessage (aliased to spm) allows all parameters to be passed in each call. If you're going to be using the function often, it's easier to set things once.

In your profile you can do the following:

	Import-Module PS-Pushover
	Set-PushoverSession -token <your API Token> -user <your User Key>

Other options are also available, call Set-PushoverSession -detailed for more information

Functions

The full list of functions available are:

  • Get-PushoverPriorities - Returns a list of valid priorities for use in sending messages
  • Get-PushoverSession - Returns details of the properties set for the current powershell session
  • Get-PushoverSounds - Returns a list of valid sounds for use in sending messages
  • Send-PushoverMessage - Sends a message using the Pushover API
  • Set-PushoverSession - Sets properties for use throughout the current powershell session

Examples

Some gist examples are available


Links

About

A Powershell module to send messages using the Pushover API

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published