Quick Summary

  1<#
  2.SYNOPSIS
  3    Get Specified ConfigMgr Managed Application version.
  4.DESCRIPTION
  5    Get Specified ConfigMgr Managed Application version, by querying the
  6    ConfigMgr Client SDK and optionally check the version.
  7.PARAMETER Name
  8    Specifies the name of the application. Supports Wildcards.
  9.PARAMETER Version
 10    Specifie the version to check.
 11.EXAMPLE
 12    Test-CMApplication.ps1 -Name '*Autocad'
 13.EXAMPLE
 14    Test-CMApplication.ps1 -Name '*Autocad' -Version '9.0.0'
 15.INPUTS
 16    None.
 17.OUTPUTS
 18    None.
 19.NOTES
 20    Created by Ioan Popovici
 21    If more than one application is detected the script will throw 'Multiple Applications (x) Found!' error.
 22.LINK
 23    https://MEMZ.one/Test-CMApplication
 24.LINK
 25    https://MEMZ.one/Test-CMApplication-CHANGELOG
 26.LINK
 27    https://MEMZ.one/Test-CMApplication-GIT
 28.LINK
 29    https://MEM.Zone/ISSUES
 30.COMPONENT
 31    Configuration Manager
 32.FUNCTIONALITY
 33    Gets Managed Application
 34#>
 35
 36## Set script requirements
 37#Requires -Version 3.0
 38
 39##*=============================================
 40##* VARIABLE DECLARATION
 41##*=============================================
 42#region VariableDeclaration
 43
 44## Get script parameters
 45[CmdletBinding()]
 46Param (
 47    [Parameter(Mandatory = $true, HelpMessage = "Enter application name", Position = 0)]
 48    [ValidateNotNullorEmpty()]
 49    [SupportsWildcards()]
 50    [string]$Name,
 51    [Parameter(Mandatory = $false, HelpMessage = "Enter application version", Position = 1)]
 52    [ValidateNotNullorEmpty()]
 53    [string]$Version
 54)
 55
 56#endregion
 57##*=============================================
 58##* END VARIABLE DECLARATION
 59##*=============================================
 60
 61##*=============================================
 62##* FUNCTION LISTINGS
 63##*=============================================
 64#region FunctionListings
 65
 66#region Function Test-CMApplication
 67Function Test-CMApplication {
 68<#
 69.SYNOPSIS
 70    Get ConfigMgr Managed Application version.
 71.DESCRIPTION
 72    Get ConfigMgr Managed Application version, by querying the
 73    ConfigMgr Client SDK and optionally check the version.
 74.PARAMETER Name
 75    Specifies the name of the application.
 76.PARAMETER Version
 77    Specifie the version to check.
 78.EXAMPLE
 79    Test-CMApplication -Name '*Autocad'
 80.EXAMPLE
 81    Test-CMApplication -Name '*Autocad' -Version '9.0.0'
 82.INPUTS
 83    None.
 84.OUTPUTS
 85    None.
 86.NOTES
 87    Created by Ioan Popovici
 88.LINK
 89    https://MEMZ.one/Test-CMApplication
 90.LINK
 91    https://MEMZ.one/Test-CMApplication-CHANGELOG
 92.LINK
 93    https://MEMZ.one/Test-CMApplication-GIT
 94.LINK
 95    https://MEM.Zone/ISSUES
 96.COMPONENT
 97    Configuration Manager
 98.FUNCTIONALITY
 99    Gets Managed Application
100#>
101    [CmdletBinding()]
102    Param (
103        [Parameter(Mandatory = $true, HelpMessage = "Enter application name", Position = 0)]
104        [ValidateNotNullorEmpty()]
105        [string]$Name,
106        [Parameter(Mandatory = $false, HelpMessage = "Enter application version", Position = 1)]
107        [ValidateNotNullorEmpty()]
108        [string]$Version
109    )
110
111    Begin {
112        [string]$Output = 'Not-Detected'
113    }
114    Process {
115        Try {
116
117            ## Get the application object
118            $Application = (Get-CimInstance -ClassName 'CCM_Application' -Namespace 'Root\ccm\ClientSDK').Where({ $PSItem.FullName -like $Name })
119
120            ## Check for multple applications found
121            If ( $($Application.FullName).Count -gt 1 ) {
122
123                ## Return custom error
124                $Message       = [string]"Multiple Applications ({0}) Found! {1}" -f $($Application.FullName).Count, $($PsItem.Exception.Message)
125                $Exception     = [Exception]::new($Message)
126                $ExceptionType = [Management.Automation.ErrorCategory]::OperationStopped
127                $ErrorRecord   = [System.Management.Automation.ErrorRecord]::new($Exception, $PsItem.FullyQualifiedErrorId, $ExceptionType, $Application)
128                $Output = $Message
129                $PSCmdlet.ThrowTerminatingError($ErrorRecord)
130            }
131            If ($Application) {
132                $Output = 'Detected'
133
134                ## Compare versions
135                If ([string]::IsNullOrEmpty($Version)) {
136                    If ([version]$Application.SoftwareVersion -eq [version]$Version) { $Output = 'Detected' } Else { $Output = 'Not-Detected' }
137                }
138            }
139        }
140        Catch {
141
142            ## Return custom error
143            $Message       = [string]"Error getting application '{0}'.`n{1}" -f $Application, $($PsItem.Exception.Message)
144            $Exception     = [Exception]::new($Message)
145            $ExceptionType = [Management.Automation.ErrorCategory]::OperationStopped
146            $ErrorRecord   = [System.Management.Automation.ErrorRecord]::new($Exception, $PsItem.FullyQualifiedErrorId, $ExceptionType, $Application)
147            $Output        = $Message
148            $PSCmdlet.ThrowTerminatingError($ErrorRecord)
149        }
150        Finally {
151            Write-Output -InputObject $Output
152        }
153    }
154    End {
155    }
156}
157#endregion
158
159#endregion
160##*=============================================
161##* END FUNCTION LISTINGS
162##*=============================================
163
164##*=============================================
165##* SCRIPT BODY
166##*=============================================
167#region ScriptBody
168
169Test-CMApplication @PSBoundParameters
170
171#endregion
172##*=============================================
173##* END SCRIPT BODY
174##*=============================================