Créez et gérez des équipes et des canaux Microsoft avec PowerShell / Blogs / Perficient

Dans ce blog, nous passerons en revue le processus de création d’une équipe, d’ajout de canaux d’équipe et de gestion des propriétaires et des membres au sein de Microsoft Teams à l’aide de scripts PowerShell. Vous apprendrez à automatiser la création d’équipes, à les organiser avec différents canaux et à gérer efficacement les rôles et autorisations des utilisateurs, tels que l’attribution de propriété ou d’adhésion. Cela vous aidera à rationaliser les tâches administratives dans Microsoft Teams, vous permettant de maintenir un meilleur contrôle et une meilleure organisation au sein de votre environnement Teams.

Conditions préalables à la création et à la gestion de Microsoft Teams avec PowerShell

Pour exécuter certaines commandes, le module Microsoft Teams PowerShell doit être installé sur votre ordinateur. Utilisez l’applet de commande PowerShell ci-dessous pour installer le module Microsoft Teams PowerShell. J’effectue cela dans PowerShell ISE.

Install-Module -Name MicrosoftTeams -Force -AllowClobber

Une fois la configuration terminée, ouvrez PowerShell ISE en mode administrateur et configurez une nouvelle équipe.

Créer une équipe avec PowerShell

Pour travailler avec Teams à l’aide de PowerShell, connectez le module Teams en l’important dans le code comme suit :

# Sign into Teams online
Import-Module -Name MicrosoftTeams
$credential = Get-Credential
Connect-MicrosoftTeams -Credential $credential

Vous serez invité à saisir vos informations d’identification lorsque vous exécuterez les commandes ci-dessus. Assurez-vous de fournir les informations d’identification d’administrateur pour Microsoft Teams.

Ensuite, créez l’équipe en tant que privée ou publique à l’aide de la commande suivante :

New-Team -DisplayName <TeamName> -Visibility <Private/Public> -Description <DescriptionAboutTeam> -MailNickName <AliasName> -Owner <TeamOwnerEmail>

Ex : New-Team -DisplayName « Test Team » -Description « Cette équipe est à des fins de test » -Visibilité privée -MailNickName TestTeam -Propriétaire abc@xyz.com

Note: Les modifications apportées à Teams via PowerShell peuvent prendre jusqu’à deux heures pour prendre effet et apparaître à la fois dans le portail d’administration Office 365 et dans le client Teams.

Une fois l’équipe créée, elle affichera les informations sur l’équipe nouvellement créée comme suit :

Paramètres

• Visibilité: Les équipes publiques permettent à n’importe quel utilisateur de rejoindre le groupe, tandis que les équipes privées nécessitent l’approbation d’un propriétaire avant qu’un utilisateur puisse le rejoindre.
• NomPseudoMail : Alias ​​de messagerie du groupe Office 365 associé. MailNickName sera utilisé comme PrimarySmtpAddress.
• Propriétaire: Le propriétaire de l’équipe peut ajouter ou supprimer des personnes de l’équipe. Si le propriétaire n’est pas spécifié, il s’agit de l’utilisateur administrateur qui a créé l’équipe.

Ajouter des utilisateurs à une équipe

Pour ajouter des utilisateurs, vous avez besoin du GroupId. Utilisez la commande PowerShell ci-dessous pour récupérer le GroupId en fonction du nom d’affichage des équipes.

# Get Team ID
$Group = Get-Team -DisplayName <TeamDisplayName> | select GroupId

Cette commande renverra le GroupId, le nom d’affichage, la visibilité, la description et d’autres détails. Ensuite, ajoutez les utilisateurs au groupe en exécutant l’applet de commande suivante.

# Add user to Team
Add-TeamUser -GroupID $Group.GroupId -User username@xyz.com

Par défaut, il ajoute l’utilisateur en tant que membre de l’équipe. Pour ajouter un utilisateur en tant que propriétaire d’une équipe, incluez le paramètre -Role et définissez sa valeur pour le propriétaire.

Supprimer des utilisateurs d’une équipe

# Get Team ID
$Group = Get-Team -DisplayName <TeamDisplayName> | select GroupId
# Remove user from Team
Remove-TeamUser -GroupID $Group.GroupId -User abc@xyz.cloud

Une fois qu’un utilisateur est supprimé d’une équipe, il ne peut plus accéder aux chaînes, fichiers ou conversations de l’équipe.

Note: Seul le propriétaire de l’équipe a le pouvoir d’exécuter cette commande et de supprimer un utilisateur

Créer des canaux pour une équipe

Une fois l’équipe créée, vous pouvez y ajouter une chaîne. Pour ce faire, utilisez la cmdlet New-TeamChannel avec la syntaxe suivante.

New-TeamChannel -GroupId $GroupId -DisplayName <NewChannelDisplayName> -MembershipType <Private/Shared/Standard> -Owner <UserEmail>

Paramètres

• Type d’adhésion : Type d’abonnement à la chaîne : Standard, Partagé ou Privé.
• Nom d’affichage : Nom de la chaîne à créer
• Propriétaire: UPN du propriétaire qui peut être spécifié lors de la création d’une chaîne privée.

Note: Un site SharePoint est également généré lorsqu’un canal privé ou partagé est créé dans une équipe. L’accès à ce site est réservé aux propriétaires et aux membres de la chaîne privée ou partagée respective.

Un site d’équipe est automatiquement créé dans SharePoint chaque fois qu’une nouvelle équipe ou un canal privé/partagé est créé dans Microsoft Teams. La description ou la classification du site peut être modifiée dans les paramètres du canal dans Teams.

Ajouter/Supprimer des utilisateurs à un canal d’équipe

Nous pouvons gérer les utilisateurs au sein d’une chaîne spécifique, ce qui nous permet de les attribuer en tant que propriétaires ou membres de la chaîne.

La commande reviendra immédiatement, mais l’application Teams ne reflétera pas la mise à jour immédiatement. Pour voir la mise à jour, vous devez actualiser la page des membres.

# Get the Group ID of a Team
$GroupId = (Get-Team -DisplayName <TeamDisplayName>).GroupId
#Add user to the Channel in Teams
Add-TeamChannelUser -GroupId $GroupId -DisplayName <ChannelDisplayName> -User <UserEmail>

Vous pouvez inclure un paramètre de rôle si l’utilisateur doit être le propriétaire du canal. Actualisez la page des membres pour afficher les modifications dans l’application Équipe.

Note: En raison des limitations techniques des chaînes privées, les utilisateurs doivent d’abord être membres de l’équipe pour être ajoutés en tant que membres d’une chaîne. De plus, pour devenir propriétaire d’une chaîne, quelqu’un doit d’abord être membre de cette chaîne.

De même, la commande suivante peut être utilisée pour supprimer un utilisateur du canal d’équipe :

# Get the Group ID of a Team
$GroupId = (Get-Team -DisplayName <TeamDisplayName>).GroupId
#Remove user from the Channel in Teams
Remove-TeamChannelUser -GroupId $GroupId  -DisplayName <ChannelDisplayName> -User <UserEmail>

Supprimer une chaîne d’une équipe

L’applet de commande suivante supprime un canal spécifique d’une équipe Microsoft Teams à l’aide de l’applet de commande suivante. PowerShell module.

# Get the Group ID of a Team 
$GroupId = (Get-Team -DisplayName <TeamDisplayName>).GroupId
Remove-TeamChannel -GroupId $GroupId -DisplayName <ChannelDisplayName>

Cette action ne supprimera aucun contenu des onglets associés à la chaîne. De plus, seuls les administrateurs d’équipe ou les utilisateurs disposant d’autorisations spécifiques sont autorisés à supprimer une chaîne de l’équipe.

Note: Cela entraînera une « suppression logicielle » d’une chaîne, ce qui signifie que son contenu n’est pas immédiatement supprimé définitivement. Vous pouvez le restaurer dans les 21 jours avant qu’il ne soit définitivement supprimé. Ainsi, toute nouvelle demande de création de chaîne avec les mêmes informations échouera pendant 21 jours.

La suppression d’une chaîne standard ne supprime pas le site de la chaîne. La chaîne est supprimée, mais les fichiers restent. La suppression d’une chaîne privée supprime l’intégralité du site, y compris tous les fichiers et conversations.

Enfin, déconnectez l’environnement Microsoft Teams de PowerShell à l’aide de la commande suivante :

Disconnect-MicrosoftTeams

Conclusion

Vous pouvez créer et gérer efficacement des équipes et des canaux Microsoft en utilisant les commandes fournies, permettant une administration transparente. Cela offre également la flexibilité de gérer les utilisateurs au sein des équipes et des canaux individuels, qu’ils soient privés ou partagés. Cela vous donne un contrôle total sur les rôles des utilisateurs, les autorisations et l’accès.