Step 7: Deploy the Guests app

Verify your App Permission Policy

1. Access the Microsoft Teams admin center.
2. Go to Teams apps and select Permission policies at admin.teams.microsoft.com/policies/app-permission (opens in a new tab).
3. Ensure that Guests is included in your Permission policies. If any policy currently excludes certain apps, make sure to add Guests to the list of Third-party apps.

Install Guests in your organization

• Visit the Microsoft Teams admin center.
• Go to Teams apps and select Setup policies at admin.teams.microsoft.com/policies/app-setup (opens in a new tab).
• Open the Global (Org-wide default) policy.
• Under installed apps, add a new app and search for Guests.
• Save your changes to apply the installation of the Guests app to all users.

Pin Guests to personal apps in Microsoft Teams

1. Open the Global (Org-wide default) policy.
2. Under pinned apps, add a new app and search for Guests.
3. After adding it, you can customize the app order and click "Save."
4. The app will become visible to all users, including guest users, within 24 hours. If you wish to expedite the process, you can force a refresh of the Teams client by logging out and then logging back into Microsoft Teams.

To pin Guests for all users, modify the global app Setup Policy. However, if you only wish to pin Guests for specific users, refrain from altering the global policy and, instead, create a new app Setup Policy tailored to your specific requirements.

Create a new Setup Policy

1. Click the Add button to get started.
2. Provide a name for your policy, such as Guests Setup Policy.
3. Under Pinned apps, add a new app and search for Guests.
4. Once added, you can customize the app order as needed and then click Save.

Assign Setup Policy

To assign the Setup Policy to a user, follow these steps:

1. In the Teams admin center, go to the Users section.
2. Select a specific username, then proceed to the Policies tab. Alternatively, you can click View Policies in the list of all users.
3. Click Edit next to Assigned Policies.
4. In the App Setup Policy drop-down menu, choose the Guests Setup Policy and click Apply.

Assign Setup Policy to a user using PowerShell

Use the following comannd to assign the Setup Policy using PowerShell using the Microsoft Teams Module (opens in a new tab).

Grant-CsTeamsAppSetupPolicy -Identity <UserPrincipalName> -PolicyName 'Guests Setup Policy'

Assign Setup Policy to security groups using PowerShell

You can use PowerShell to assign an app Setup Policy to an Azure AD security group:

# Create a new Setup Policy for a security group
New-CsGroupPolicyAssignment -GroupId <Group Object Id> -PolicyType TeamsAppSetupPolicy -PolicyName 'Guests App Setup Policy' -Rank 1  
# View group policy assignments
Get-CsGroupPolicyAssignment -PolicyType TeamsAppSetupPolicy