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.

 

  1. Turn OFF Global Policy
  2. WAIT until Azure AD updates (usually within 24 hours)
  3. Set up and Run Script to Delete users who do not have "Checkmark"
  4. Turn ON Global Policy
  5. WAIT until users have a chance to log in and complete an action in Teams (usually 48-72 hours)
  6. 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.

A screenshot of a computer screen

Description automatically generated with medium confidence

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.

Graphical user interface, application

Description automatically generated

 

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.

A screenshot of a computer screen

Description automatically generated with medium confidence

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.

Graphical user interface, application

Description automatically generated

 

3. Under Installed apps, click Add App.

A picture containing graphical user interface

Description automatically generated

 

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.