Public/Get-IntuneWin32AppSupersedence.ps1
|
function Get-IntuneWin32AppSupersedence { <# .SYNOPSIS Retrieve supersedence configuration from an existing Win32 application. .DESCRIPTION Retrieve supersedence configuration from an existing Win32 application. .PARAMETER ID Specify the ID for an existing Win32 application to retrieve supersedence configuration. .NOTES Author: Nickolaj Andersen Contact: @NickolajA Created: 2021-04-02 Updated: 2023-09-04 Version history: 1.0.0 - (2021-04-02) Function created 1.0.1 - (2021-08-31) Updated to use new authentication header 1.0.2 - (2023-09-04) Updated with Test-AccessToken function #> [CmdletBinding(SupportsShouldProcess = $true)] param( [parameter(Mandatory = $true, HelpMessage = "Specify the ID for an existing Win32 application to retrieve supersedence configuration.")] [ValidateNotNullOrEmpty()] [string]$ID ) Begin { # Ensure required authentication header variable exists if (-not (Test-AuthenticationState)) { Write-Warning -Message "Authentication token was not found, use Connect-MSIntuneGraph before using this function"; break } # Set script variable for error action preference $ErrorActionPreference = "Stop" } Process { # Retrieve Win32 app by ID from parameter input Write-Verbose -Message "Querying for Win32 app using ID: $($ID)" $Win32App = Invoke-MSGraphOperation -Get -APIVersion "Beta" -Resource "deviceAppManagement/mobileApps/$($ID)" if ($null -ne $Win32App) { $Win32AppID = $Win32App.id try { # Attempt to call Graph and retrieve supersedence configuration for Win32 app $Win32AppRelationsResponse = Invoke-MSGraphOperation -Get -APIVersion "Beta" -Resource "deviceAppManagement/mobileApps/$($Win32AppID)/relationships" -ErrorAction Stop # Handle return value if ($null -ne $Win32AppRelationsResponse -and $Win32AppRelationsResponse.Count -gt 0) { # Filter for supersedence relationships $SupersedenceRelationships = $Win32AppRelationsResponse | Where-Object { $_.'@odata.type' -eq "#microsoft.graph.mobileAppSupersedence" } if ($null -ne $SupersedenceRelationships -and $SupersedenceRelationships.Count -gt 0) { Write-Verbose -Message "Found $(@($SupersedenceRelationships).Count) supersedence relationship(s)" return $SupersedenceRelationships } else { Write-Verbose -Message "No supersedence relationships found for Win32 app: $($Win32AppID)" } } } catch [System.Exception] { Write-Warning -Message "An error occurred while retrieving supersedence configuration for Win32 app: $($Win32AppID). Error message: $($_.Exception.Message)" } } else { Write-Verbose -Message "Query for Win32 app returned an empty result, no apps matching the specified search criteria with ID '$($ID)' was found" } # Return empty array for consistency return @() } } |