Installation et connexion sécurisée à Microsoft Teams PowerShell

1. Prérequis : Préparer votre Environnement PowerShell

Avant d'installer quoi que ce soit, nous devons nous assurer que votre environnement est prêt. Une bonne préparation évite bien des problèmes.

a) Version de PowerShell

Le module Teams requiert au minimum PowerShell 5.1, qui est inclus par défaut dans Windows 10 et 11. Pour vérifier votre version, ouvrez une fenêtre PowerShell et tapez la commande suivante :

$PSVersionTable.PSVersion

Vous devriez voir une version majeure (Major) de 5 ou 7.

b) Privilèges d'Administrateur

L'installation d'un module PowerShell modifie le système et requiert donc des droits élevés. Vous devrez toujours lancer PowerShell en tant qu'administrateur pour les opérations d'installation ou de mise à jour. Pour ce faire, cherchez "PowerShell" dans le menu Démarrer, faites un clic droit dessus et sélectionnez "Exécuter en tant qu'administrateur".

c) Politique d'Exécution (Execution Policy)

Par défaut, PowerShell est configuré pour ne pas exécuter de scripts afin de protéger le système. Pour pouvoir installer et utiliser des modules depuis des sources fiables comme la PowerShell Gallery, nous devons ajuster cette politique.

1. Pour voir votre politique actuelle, tapez : Get-ExecutionPolicy -List
2. Si la politique pour CurrentUser est à Undefined ou Restricted, nous allons la changer pour RemoteSigned. Cette politique autorise l'exécution de scripts locaux mais exige que les scripts téléchargés soient signés par un éditeur de confiance. C'est un bon compromis de sécurité.

Exécutez la commande suivante pour définir la politique pour votre compte utilisateur uniquement :

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Votre environnement est maintenant prêt pour l'installation.

2. Installation du Module Microsoft Teams

L'installation se fait via une seule commande qui va télécharger et installer le module depuis la PowerShell Gallery, le dépôt officiel de Microsoft pour les modules PowerShell.

Maintenant, passons à l'action. La vidéo ci-dessous vous montre concrètement le processus.

Dans votre session PowerShell administrative, tapez la commande suivante :

Install-Module -Name MicrosoftTeams -Force -AllowClobber

• -Force garantit que la dernière version est installée, même si une version plus ancienne est déjà présente.
• -AllowClobber autorise le module à écraser des commandes existantes qui pourraient avoir le même nom, évitant ainsi des conflits.

Important : Lors de la première installation depuis la PowerShell Gallery, il est possible que deux questions vous soient posées :

1. Pour installer le fournisseur "NuGet". Répondez Y (Yes) ou O (Oui).
2. Pour confirmer que vous faites confiance au dépôt "PSGallery". Répondez Y (Yes) ou O (Oui).

Une fois la commande terminée sans erreur, le module est installé.

3. Connexion Sécurisée au Service Teams

Le module est installé, mais pour pouvoir gérer votre tenant, vous devez vous y connecter. Cette étape utilise l'authentification moderne de Microsoft 365, qui est sécurisée et compatible avec l'authentification multifacteur (MFA).

La commande est très simple :

Connect-MicrosoftTeams

L'exécution de cette commande déclenchera l'ouverture d'une fenêtre d'authentification Microsoft.

Saisissez les identifiants d'un compte administrateur de votre tenant Teams (un compte avec au moins le rôle d'Administrateur Teams). Si la MFA est activée sur ce compte, vous devrez également valider la connexion via votre téléphone ou application d'authentification.

Une fois la connexion réussie, PowerShell affichera votre compte, l'ID de votre tenant et confirmera que la connexion est établie.

4. Vérification et Commandes de Maintenance

Pour vous assurer que tout fonctionne, le meilleur moyen est de lancer une première commande de lecture. La commande Get-Team est parfaite pour cela, car elle liste simplement toutes les équipes de votre tenant sans rien modifier.

Get-Team

Si tout est correct, vous verrez apparaître une liste de vos équipes avec leur nom, leur visibilité, etc.

Pour finir, voici quelques commandes utiles pour gérer le cycle de vie du module lui-même :

• Vérifier la version installée :

  Get-InstalledModule -Name MicrosoftTeams
  

• Mettre à jour le module : (N'oubliez pas de le faire dans une nouvelle session PowerShell administrateur)

  Update-Module -Name MicrosoftTeams
  

• Se déconnecter de la session : C'est une bonne pratique de sécurité à la fin de votre travail.

  Disconnect-MicrosoftTeams
  

Conclusion

Félicitations ! Vous avez franchi une étape fondamentale. Vous disposez maintenant d'un environnement PowerShell fonctionnel, prêt à communiquer avec votre tenant Microsoft Teams.

Points clés à retenir :

• Les prérequis sont essentiels : PowerShell 5.1+, des privilèges d'administrateur et une politique d'exécution (RemoteSigned) adéquate.
• L'installation se fait avec la commande Install-Module -Name MicrosoftTeams depuis une session administrateur.
• La connexion est sécurisée via la commande Connect-MicrosoftTeams, qui utilise l'authentification moderne de Microsoft 365.
• La commande Get-Team est un excellent moyen de tester rapidement la connexion.

Prochaine étape :
Maintenant que nous sommes connectés, il est temps de commencer à gérer Teams. Dans la prochaine leçon, nous mettrons immédiatement en pratique cette nouvelle connexion pour gérer les licences et les politiques d'un utilisateur individuel via des commandes PowerShell. Vous commencerez ainsi à voir la puissance et l'efficacité de l'automatisation.