.. _manage-teams-ms-subscribers: Teams ----------------- .. _21.4|VOSS-1048: .. _21.4-PB3|EKB-16813: .. _24.1|VOSS-1368: .. tip:: :ref:`use-action-search-to-navigate-automate` Overview .......... Automate allows you to manage Microsoft Teams from within the Admin portal. Changes you make to teams in Automate or in the Microsoft Teams online portal are synced. A team comprises its members, its channels (where team members share messages and other resources), and its privacy and permissions settings. .. note:: A Microsoft Team is a collection of people, content, and tools that are grouped together for a common purpose. For example, you may want to add a group of engineers working for the same project, to a team. In the Microsoft Teams online portal, an admin user can: * Add or update a team, and give it a name and description * Make the team private or public. * Add a team owner * Move a team (Provider admin only) When using a Microsoft client (desktop or phone), a Microsoft end user can add teams from teams templates. .. image:: /src/images/view-ms-teams-detail.png .. rubric:: Related topics * :ref:`teams-templates-ms-subscribers` * :ref:`groups-ms-subscribers` * .. raw:: html Microsoft syncs .. raw:: latex Microsoft syncs in the Best Practice Guide Add and update Teams .......................... This procedure adds, edits, or deletes teams and team members in Automate. .. note:: Changes you make to MS teams in Automate syncs to the Microsoft Teams online portal. You can also view changes made to MS teams in the MS Teams portal online, from Automate. **Pre-requisites**: * When configuring Automate for Microsoft, you will need to assign the following permissions to the API registration in the MS Entra admin portal to allow MS Teams objects to successfully sync in to Automate, and to allow you to manage these objects in Automate: * TeamMember.Read.All, * TeamMember.ReadWrite.All, * TeamMember.Read.Group **To add and update Teams**: 1. In the Automate Admin Portal, go to **Teams**. 2. View existing teams in the list view. .. note:: * The number of Teams in the list view matches the number of Teams in the Microsoft Portal. * The **Teams** list view displays synced in data for MS Teams. Clicking on a Team to view its details triggers a live update from the Microsoft Entra ID portal to fetch additional details for the Team, including its members and channels. This is to ensure efficient and fast data syncing for Teams and Groups from Microsoft Entra ID. Data syncs for Teams and Groups are handled in the same way in the Automate GUI. Microsoft doesn't differentiate between Teams and Groups on the MS Entra ID portal so both the Teams and Groups list view and details page point to the same Automate model, ``device/msgraph/Group``. 3. Choose an option: * **Edit a team**: To edit a MS team, click on the relevant team in the list view to open its management page, then update settings, and click **Save**. .. note:: You can add or remove members, change member roles, update Team settings, and archive, unarchive, or delete a team, and move a team (Provider admin only). However, channel membership type is read-only in the Automate Admin Portal, and will need to be updated in the Microsoft Portal, if required. To archive or unarchive a Team, select the relevant team(s) in the list view, then click the relevant toolbar option (Archive Team or Unarchive Team). The **Is Archived** checkbox is read-only when a team is archived, and you can't add or update team members and channels. All changes are synced to the Microsoft Teams online portal. .. image:: /src/images/view-ms-teams-detail-member.png * **Move a team**: As a Provider admin, you can move one or more MS teams via the list view, or click on a team to open its configuration page, then move the team. .. image:: /src/images/manage-teams-edit.png .. note:: When moving a team, team members remain at their existing location. Only the team is moved. However, let's say you moved a team to a site and you want to add additional members, then you can add new members that are at the site where the team now exists, even though the team still contains members that may be at a different location in the hierarchy. * **Add a team**: To add a MS team, click the Plus icon (+) to open the **Teams** page, then fill out team details: * Fill out a display name (mandatory) and (optionally) a description. * Choose a privacy policy, either public or private. .. note:: The default is `Public`. * At **Is Archived** define whether the team may be archived. * At **Teams Templates**, choose a template, if you wish to create the team from a predefined, custom template. * At **Members**, click the Plus icon (+) to add team members (one or more), and define the member's role, either owner or member. .. note:: At least one user must be assigned the team owner role. * At **Channels**, click the Plus icon (+) to add channels (one or more). .. note:: The first channel (*General*), is added by default. All members you add to the team are added to this channel. Automate only supports adding channels with membership type `Standard`. In the Microsoft Teams online portal, you can add channels that have any of the following membership types: Private, Standard, or Shared * At **Member Settings**, select permissions that will apply to team members. For example, you can define whether to allow team members to add or update channels, to create private channels, to add or remove apps, or to delete channels. * At **Guest Settings**, define whether to allow guest team members to add, update, or delete channels. * At **Messaging Settings**, define permissions for messages, for example, choose whether to allow ordinary members to edit or delete messages, define whether team owners can delete messages, and whether to allow team or channel mentions. * At **Fun Settings**, define whether to allow Giphy, set a content rating for Giphy, and define whether to allow stickers and memes.