Microsoft has relayed that it is important to proactively install apps for all users using a Graph API. Because of this, we have created this script to assist with the installation. (See this Microsoft article: Proactive Messages)
If your organization has previously installed the BrainStorm Teams App Using a Global Policy and you would like to use the script that we have created, you will first need to complete the steps listed below.
- Turn OFF Global Policy
- WAIT until Azure AD updates (usually within 24 hours)
- Set up and Run Script to Delete users who do not have "Checkmark"
- Turn ON Global Policy
- WAIT until users have a chance to log in and complete an action in Teams (usually 48-72 hours)
- Run Script (as needed) to Upgrade users who still do not have "Checkmark"
The BrainStorm App is installed globally to your entire organization via the Microsoft Teams Admin Center.
NOTE: This step can only be completed by an O365 Global Admin.
Step I: Turn Off Global Policy (Pushing App Globally to All Users)
1. Go to the Microsoft Teams Admin Center > Teams app > Setup policies.
2. Click on Global (Org-wide default).
NOTE: Your organization may have changed the name or set up a different policy for Org-wide app policies.
3. Under Installed apps, find the BrainStorm Teams App and select X Remove.
4. Click Save.
Step II: WAIT until Azure AD updates (usually up to 24 hours)
Step III: Set up and Run Script to Delete users who do not have "Checkmark"
1. Go into the QuickHelp Admin Portal and Export a list of all users.
2. In that export, filter to all users who do NOT have the Teams app.
3. Create a CSV of these users.
NOTE : You will want to break this CSV down to no more than 4,000 users at a time to have the CSV run efficiently.
The CSV only will need to have one column (email).
4. Run the script using the following:
- Installation Mode: 3 (CSV).
- Update Mode: 2 (Delete).
Please find the complete setup and script in the following article:
Script to Push the BrainStorm Microsoft Teams App
Step IV: Turning Global Policy Back On for All Users
1. Go to the Microsoft Teams Admin Center > Teams app > Setup policies.
2. Click on Global (Org-wide default).
NOTE: Your organization may have changed the name or set up a different policy for Org-wide app policies.
3. Under Installed apps, click Add App.
4. Search for BrainStorm.
5. Click Add.
6. Click Save.
Step V: WAIT 48-72 hours. Users will start displaying with the checkmark in the QuickHelp Admin portal.
Step VI: Set up and Run Script to Update users who do not have "Checkmark"
1. Go into the QuickHelp Admin Portal and Export a list of all users.
2. In that export, filter to all users who do NOT have the Teams app.
3. Create a CSV of these users.
NOTE : You will want to break this CSV down to no more than 4,000 users at a time to have the CSV run efficiently.
The CSV only will need to have one column (email).
4. Run the script using the following:
- Installation Mode: 3 (CSV).
- Update Mode: 1 (Upgrade).
NOTE: It is not required to configure the Microsoft Office Graph API within the QuickHelp Admin portal to complete these steps.