How to Roll Out the Teams Service App to Specific Users

​

Introduction to Setup Policies

​

Use Cases

• If you have multiple customer companies sharing the same Microsoft 365 tenant, you can create custom setup policies that map to each organization in the tenant. You can then deploy different Teams Service apps to the different organizations through the setup policies.
• If you want to roll out the Teams Service app to an internal testing group before rolling out to the entire company, you can deploy the app to a custom Setup Policy and assign your testing group to that policy.

​

How to Guide

1

Deploy the app up to the Global Setup Policy step

Follow this guide on how to deploy the Teams Service App to a customer until you get to the step to install the app on the Global Setup Policy. Make sure you’ve uploaded your custom zip file to the Teams tenant, but don’t deploy the app to the Global Setup Policy.

2

Open Setup policies in the Teams Admin Center

Navigate to Microsoft Teams Admin Center -> Teams apps -> Setup policies.

3

Select or create a setup policy

Find and click on a Teams Setup policy you wish to link your Thread Service app to, or click + Add to create a new one.Using the Global (org-wide default) policy will ensure the app is rolled out to all Teams users in the environment. In this example, we’ll be creating our own policy.

4

Add and pin the Thread Service App

If you’re creating a new policy, name it. Then, follow these steps…

1. Under Installed apps, click + Add apps to add your Thread Service App, search for the app, select it and click Add.
2. Under Pinned apps, click + Add apps to add your Thread Service App, search for the app, select it and click Add.
3. Click Save to save your changes.

5

Configure an Entra ID group

Before proceeding, make sure an Entra ID group is configured in Microsoft 365 with the users you want to deploy the app to. Teams \App Setup policies support both Dynamic and Manual Assigned groups.

6

Open the Group policy assignment tab

Back on the Setup policies screen, click on the Group policy assignment tab.

7

Add a group policy assignment

Click + Add to create a new Group policy assignment.

1. To the right, select the Entra ID group you want to assign to the policy.
2. Select the Setup Policy you created in the previous step.
3. Set rank to 1. In the event of a conflict, the user inherits the setup policy with the lowest rank. Setting the rank to 1 will override the Global policy for the user with the new custom policy you created.
4. Click Apply -> Confirm to save.

8

Wait for the policy to apply

The users that are assigned to the group/policy will see the app in their Teams in the next 24 hours.It can take a full 24 hours for Microsoft to reflect the policy application in Teams. After this period of time, the user should see the app pinned in their Teams app.

​

FAQ