How To Access Microsoft Teams Graph API In PowerShell

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

 

Refer to this link to see the list of Graph API’s available for Microsoft Teams.

 

You will see how to retrieve all the teams by calling Graph API in PowerShell.

 

See how to list all teams here.

 

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 is 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 permissions 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/beta/groups?`$filter=resourceProvisioningOptions/Any(x:x eq 'Team')"
   
   $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 | Select-Object id, displayName, visibility

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

Summary

 

Thus, in this article, you saw how to access Microsoft Teams Graph API in PowerShell.