Using Get-MgTeamInstalledApp in Graph PowerShell

This guide explains how to use the Get-MgTeamInstalledApp cmdlet in Microsoft Graph PowerShell to retrieve apps installed in Microsoft Teams. Learn how to list installed apps for specific teams and export app details with practical examples.

The Get-MgTeamInstalledApp cmdlet is a useful tool for administrators managing Microsoft Teams, allowing them to list all apps installed in a specific team. This cmdlet is particularly useful for monitoring and ensuring the proper applications are available for teams, streamlining workflows and troubleshooting issues.

In this article, we’ll explore the syntax, practical usage examples, tips, potential use cases, and solutions to common errors associated with the cmdlet.

Cmdlet Syntax

Get-MgTeamInstalledApp -TeamId <String>

Key Parameter:

• -TeamId: (Required) The ID of the team where you want to query installed apps.

Usage Examples

1. Listing All Installed Apps for a Team

This example retrieves all the installed apps for a specific Microsoft Team by providing the team’s ID.

Get-MgTeamInstalledApp -TeamId "ffe1047b-bdd7-48e1-a103-56d65c783ba9"

In this scenario, you will get a list of apps installed within the team identified by the provided Team ID. This is useful for auditing and management purposes to see what third-party or internal apps are in use.

Cmdlet Tips

• Filtering Results: Use the -Filter parameter to narrow down the results based on specific app properties. For instance, if you want to filter apps that contain the word "Planner," you can apply a filter for that.
• Pagination: Use the -Top and -Skip parameters for handling large result sets. This is especially helpful if you manage teams with many installed apps.
• Expand App Details: The -ExpandProperty parameter can help retrieve more detailed information about the apps, such as permissions or specific settings.

Use Cases

1. App Auditing

Administrators frequently need to ensure that only approved apps are installed in specific teams. By using the Get-MgTeamInstalledApp cmdlet, you can audit each team’s installed apps and verify compliance with internal policies.

2. Troubleshooting Team Issues

Sometimes team members report issues related to third-party apps not working as expected. Using this cmdlet, you can quickly see whether the app is correctly installed in the team and retrieve details such as its version. This allows you to troubleshoot app-related issues and ensure smooth operation.

3. Performance Optimization

Organizations might want to analyze the usage of various installed apps across teams to determine which apps are heavily used or underutilized. By regularly running this cmdlet, you can gather data that helps optimize app usage and reduce unnecessary resource allocation to unused apps.

Possible Errors & Solutions

Error 1: "ResourceNotFound"

Cause: This error typically occurs if the TeamId is incorrect or the specified team doesn’t exist.

Solution: Double-check the TeamId to ensure it is accurate and that the team is valid within your tenant. You can retrieve the Team ID from the Microsoft Teams admin center or by using the Get-MgTeam cmdlet.

Error 2: "Access Denied"

Cause: This is likely due to insufficient permissions to view the installed apps in the team.

Solution: Ensure that you have the required permissions. You may need to be a Team Owner or a Teams Administrator to execute this command successfully. Make sure that your Azure AD application has the correct Graph API permissions such as TeamsAppInstallation.Read.All.

Error 3: "BadRequest"

Cause: This may happen if an invalid or unsupported parameter value is passed.

Solution: Review the syntax and parameter values to ensure they are supported. For example, ensure you're using correct property names with the -Select parameter.

Frequently Asked Questions

1. What is Get-MgTeamInstalledApp used for?

Get-MgTeamInstalledApp is a Microsoft Graph PowerShell cmdlet used to retrieve details about apps installed in Microsoft Teams, including their names, IDs, and versions.

2. Can I retrieve details of a specific installed app in a team?

Use the -InstalledAppId parameter to fetch details for a specific app:

Get-MgTeamInstalledApp -TeamId "<TeamId>" -InstalledAppId "<AppId>"

3. How can I export installed app details to a CSV file?

Use this script to export app details like name, ID, and distribution method:

$Apps = Get-MgTeamInstalledApp -TeamId "<TeamId>"
$Apps | Select-Object DisplayName, Id, TeamsAppDistributionMethod | Export-Csv -Path "C:\Path\To\InstalledApps.csv" -NoTypeInformation

4. What permissions are required to retrieve installed apps in Teams?

You need the TeamsApp.Read.All or TeamsAppInstallation.ReadWrite.All permission in Microsoft Graph PowerShell. Ensure appropriate permissions are granted in Azure AD.

Conclusion

The Get-MgTeamInstalledApp cmdlet is a powerful tool for Microsoft Teams administrators, providing an easy way to audit, monitor, and troubleshoot installed apps within teams. Whether you are ensuring compliance, solving issues, or optimizing performance, this cmdlet helps maintain smooth operations across your organization’s Teams environment. By understanding and utilizing this cmdlet effectively, you can greatly simplify app management tasks and improve your Microsoft Teams governance practices.