Retrieve The List Of Apps Installed In The Specified Team Using Microsoft Teams Graph API In PowerShell

Graph API can be used to automate Microsoft Teams lifecycle such as creating teams, channels, adding members etc.

 

Refer to this link to know the list of Graph APIs available for Microsoft Teams.

 

You will see how to retrieve the list of apps installed in the specified team by calling Graph API in PowerShell.

 

List apps in team.

 

Microsoft Graph Explorer

 

HTTP - GET https://graph.microsoft.com/v1.0/teams/{id}/installedApps?$expand=teamsAppDefinition

 

 

In this article, you will see how to perform the following tasks:

• Register an Application in Azure - Register an app in Azure AD and add the required permissions to access the Graph API
• Create and execute the PowerShell script

Register an application in Azure

 

Register an application in Azure AD to access the Teams Graph API.

1. Navigate to Azure portal.
2. Search for App Registrations. Click App Registrations as show below.
   
   
   

3. Click New Registration.
   
   
   

4. Enter the Name and click Register.
   
   
   

5. App registered successfully. In the left navigation, click API Permissions.
   
   
   

6. Click Add a permission.
   
   
   

7. Select Microsoft Graph API as shown below.
   
   
   

8. Click Application Permissions.
   
   
   

9. Select Read.All permission and click Add permissions.
   
   
   

10. Click Grant admin consent.
    
    
    
    
    

11. In the left navigation, click Overview. Copy the Application (client) ID value. This value will be used in PowerShell for authentication.
    
    
    

12. In the left navigation, click certificates & secrets. Click New client secret.
    
    
    

13. Enter the description and click Add.
    
    
    

14. Copy the secret value which will be used in PowerShell for authentication.
    
    
    

Create and execute the PowerShell script

1. Open Notepad and paste the following code. Save the file as ps1.
   

   # Input Parameters
   $clientId = "c714f180-c8cc-4f70-b720-409c798274a9"
   $clientSecret = "fXzmWCUDmeXXqQ@D3b4xxd6GzrAY5[@="
   $tenantName = "c986.onmicrosoft.com"
   $resource = "https://graph.microsoft.com/"
   $URL = "https://graph.microsoft.com/v1.0/teams/daba3aa7-6622-4f75-8e27-a9587c6642dc/installedApps/?`$expand=teamsAppDefinition"
   
   
   $tokenBody = @{
       Grant_Type    = "client_credentials"
       Scope         = "https://graph.microsoft.com/.default"
       Client_Id     = $clientId
       Client_Secret = $clientSecret
   }
   
   $tokenResponse = Invoke-RestMethod -Uri "https://login.microsoftonline.com/$TenantName/oauth2/v2.0/token" -Method POST -Body $tokenBody
   $result=Invoke-RestMethod -Headers @{Authorization = "Bearer $($tokenResponse.access_token)"} -Uri $URL -Method Get
   ($result| Select-Object value).Value.teamsAppDefinition

2. Open PowerShell window. Navigate to the folder path where the script file is saved.
3. Execute the following script.
   
   .\ListAllApps.ps1
   
   
   

Summary

 

Thus, in this article, you saw how to retrieve the list of apps installed in the specified team using Microsoft Teams Graph API in PowerShell.