PowerShell

Using Invoke-MgGraphRequest to Update Microsoft Team

Updating Microsoft Teams settings is essential for administrators to tailor communication, collaboration, and governance in their organization. While dedicated Graph PowerShell cmdlets handle many tasks, there are situations where Invoke-MgGraphRequest provides flexibility by allowing custom API requests. This article covers using Invoke-MgGraphRequest specifically to update Microsoft Teams, highlighting syntax, examples, common errors, and use cases to leverage this cmdlet effectively.

Cmdlet Syntax

Invoke-MgGraphRequest -Method PATCH -Uri "https://graph.microsoft.com/v1.0/teams/{TeamID}" -Body @{
    memberSettings = @{
        allowCreateUpdateChannels = $true
    }
    messagingSettings = @{
        allowUserEditMessages = $true
        allowUserDeleteMessages = $true
    }
    funSettings = @{
        allowGiphy = $true
        giphyContentRating = "strict"
    }
}

Usage Examples

Example 1: Enable Channel Creation and Message Deletion

This example updates a team to allow members to create channels and delete their messages.

Invoke-MgGraphRequest -Method PATCH -Uri "https://graph.microsoft.com/v1.0/teams/6903fa93-605b-43ef-920e-77c4729f8258" -Body @{
    memberSettings = @{
        allowCreateUpdateChannels = $true
    }
    messagingSettings = @{
        allowUserDeleteMessages = $true
    }
}

Example 2: Restrict GIF Content and Prevent Message Editing

This example restricts Giphy content to a strict content rating and prevents users from editing their messages.

Invoke-MgGraphRequest -Method PATCH -Uri "https://graph.microsoft.com/v1.0/teams/6903fa93-605b-43ef-920e-77c4729f8258" -Body @{
    funSettings = @{
        allowGiphy = $true
        giphyContentRating = "strict"
    }
    messagingSettings = @{
        allowUserEditMessages = $false
    }
}

Cmdlet Tips

Use JSON Formatting: Ensure you structure your request body as JSON to match the Graph API schema.
Permissions Required: Ensure your Azure AD app or user has the necessary permissions, such as TeamSettings.ReadWrite.All.
Test in a Non-Production Environment: Always test your configurations in a non-production environment before applying them widely.

Common Errors & Solutions

Error	Cause	Solution
401 Unauthorized	Missing required permissions for TeamSettings.ReadWrite.All.	Check if the user or app has the necessary permissions, then re-authenticate if necessary.
403 Forbidden	The authenticated user lacks admin privileges.	Verify that the user executing the command has the required administrative privileges.
400 Bad Request	JSON format error or invalid property names in the request body.	Double-check the JSON syntax and confirm all properties match Graph API requirements.
404 Not Found	Incorrect or invalid Team ID provided in the URL.	Verify that the Team ID exists and is correctly specified.

Use Cases

Enhanced Control over Team Settings: Adjust settings like channel creation permissions or restrict GIF content, providing granular control to align team collaboration with organizational standards.
Quick Response to Policy Changes: Changes in company policy regarding team communication or content sharing can be implemented instantly using Invoke-MgGraphRequest.
Automating Configurations Across Multiple Teams: For organizations managing numerous Teams, automating updates with Invoke-MgGraphRequest reduces repetitive work, ensuring consistent configurations across departments.
Fallback for Unsupported Cmdlets: When no dedicated cmdlet exists for a particular setting, Invoke-MgGraphRequest offers a way to execute custom Graph API requests directly.

Conclusion

The Invoke-MgGraphRequest cmdlet offers powerful customization for Microsoft Teams, allowing admins to update team settings dynamically when specific Graph API endpoints are needed. With the flexibility to implement unique configurations, adjust to policy shifts, or automate settings across multiple Teams, this cmdlet is an essential tool in the admin’s toolkit. Understanding how to manage potential errors and leverage this cmdlet's strengths enables admins to maintain a well-structured, compliant Teams environment.