PowerShellUsefulScripts/Get-OnlineVerPostman.ps1 at master · thecatdidit/PowerShellUsefulScripts · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
<#
    .NOTES
	===========================================================================
	 Created with: 	PowerShell ISE (Win10 19342)
	 Revision:	v2
	 Last Modified: 24 May 2021
	 Created by:   	Jay Harper (github.com/thecatdidit/powershellusefulscripts)
	 Organizaiton: 	Happy Days Are Here Again
	 Filename:     	Get-OnlineVerPostman.ps1
	===========================================================================
    .CHANGELOG
        v2 (24 May 2021)
        Code cleanup and 'UseBasicParsing' added to content pull
        v1 (24 May 2018)
        Script created

    .SYNOPSIS
        Queries the Postman Website for the current version of
        the app and returns the version, date updated, and
        download URLs if available.

    .DESCRIPTION
	This function retrieves the latest data associated with Postman.
        Utilizes Invoke-WebRequest to query the Postman download page and
        pulls out the Version, Update Date and Download URLs for
        the app (x64 only) It then outputs the information as a
        PSObject to the Host.

    .EXAMPLE
        PS C:\> Get-OnlineVerPostman

        Software_Name    : Postman
        Software_URL     : https://dl.pstmn.io/changelog?channel=stable&platform=win
        Online_Version   : 8.5.1
        Online_Date      : 2021-05-21
        Download_URL_x64 : https://dl.pstmn.io/download/version/8.5.1/windows64

        PS C:\> Get-OnlineVerPostman -Quiet
        8.5.1

    .INPUTS
        -Quiet
            Use of this parameter will output just the current version of
            Postman instead of the entire object. It will always be the
            last parameter.

    .OUTPUTS
        An object containing the following:
        Software Name: Name of the software
        Software URL: The URL info was sourced from
        Online Version: The current version found
        Online Date: The date the version was updated
        Download URL x86: Download URL for the win32 version
        Download URL x64: Download URL for the win64 version

        If -Quiet is specified then just the value of 'Online Version'
        will be displayed.

    .NOTES
        Resources/Credits:
        https://github.com/itsontheb

#>

function Get-OnlineVerPostman {
    [cmdletbinding()]
    param (
        [Parameter(Mandatory = $false,
            Position = 0)]
        [switch]
        $Quiet
    )

    begin {
        # Initial Variables
        $SoftwareName = 'Postman'
        $URI = 'https://dl.pstmn.io/changelog?channel=stable&platform=win'

        $hashtable = [ordered]@{
            'Software_Name'    = $softwareName
            'Software_URL'     = $uri
            'Online_Version'   = 'UNKNOWN'
            'Online_Date'      = 'UNKNOWN'
            'Download_URL_x64' = 'UNKNOWN'
        }

        $swObject = New-Object -TypeName PSObject -Property $hashtable
    }


    Process {
        # Get the Version & Release Date
        try {

            $postmanDetails = (Invoke-WebRequest $uri -UseBasicParsing | ConvertFrom-Json)
            $postmanVersion = $postmanDetails.changelog[0].name
            $postmanDate = $postmandetails.changelog[0].createdAt.Substring(0, 10)
            $postmanDownload = $postmanDetails.changelog[0].assets.url
            $swObject.Online_Version = $postmanVersion
            $swObject.Online_Date = $PostmanDate
            $swObject.Download_URL_x64 = $postmanDownload

        }
        catch {
            Write-Verbose -Message "Error accessing the below URL: `n $URI"
            $message = $("Line {0} : {1}" -f $_.InvocationInfo.ScriptLineNumber, $_.exception.message)
            $swObject | Add-Member -MemberType NoteProperty -Name 'ERROR' -Value $message
        }
        finally {

        }
    }
    End {
        # Output to Host
        if ($Quiet) {
            Write-Verbose -Message '$Quiet was specified. Returning just the version'
            Return $swObject.Online_Version
        }
        else {
            Return $swobject
        }
    }
}  # END Function Get-OnlineVerPostman