M365Con 2027 – conférence en ligne gratuite · 11–22 Jan 2027 · 120 sessions→ m365con.net

Blog · Mirko Peters

Se connecter à SharePoint Online avec PnP PowerShell : options de connexion

Par · · Mis à jour

Se connecter à SharePoint Online avec PnP PowerShell : enregistrez votre propre application Entra, puis choisissez une connexion interactive, par code d’appareil, par certificat ou par identité managée pour chaque tâche.

Traduit automatiquement par IA à partir de l'article original. Lire l'original en anglais

Pour vous connecter à SharePoint Online avec PnP PowerShell aujourd’hui, vous enregistrez une fois votre propre application dans Microsoft Entra ID. Ensuite, vous appelez Connect-PnPOnline avec l’URL de votre site et l’ID client de cette application, ainsi qu’une méthode de connexion : interactive, connexion par code d’appareil, certificat, identité managée ou identifiants hérités. Ce guide s’adresse aux administrateurs SharePoint qui exécutent des scripts manuellement ou selon une planification. Il explique ce que fait chaque option, quand l’utiliser et quelles erreurs empêchent la connexion. Il montre aussi comment choisir une option par tâche, afin qu’un script ne dispose pas de plus d’accès que ce que sa tâche exige.

Points clés

  • Depuis le 9 septembre 2024, Connect-PnPOnline exige un -ClientId. Chaque administrateur doit donc d’abord enregistrer une application dans Microsoft Entra ID avec laquelle le module peut se connecter.
  • La connexion interactive convient à une personne devant son clavier, car elle prend en charge l’authentification multifacteur et ne nécessite aucun secret stocké.
  • Les tâches non supervisées doivent utiliser une connexion par certificat ou une identité managée, et non un mot de passe saisi ni un secret client stocké dans un script.
  • La méthode héritée par secret client ne fonctionne que pour les applets de commande SharePoint. Toute commande qui appelle Microsoft Graph échouera donc avec cette méthode.
  • Enregistrez l’application avec uniquement les autorisations déléguées dont vous avez besoin, car l’enregistrement par défaut demande des droits étendus, comme AllSites.FullControl.

Premiers pas : pourquoi chaque connexion nécessite votre propre application

PnP PowerShell est un module maintenu par la communauté. Il ne dispose d’aucun droit particulier. Chaque connexion passe par un enregistrement d’application dans Microsoft Entra, et c’est cette application qui détermine ce que le script peut faire.

La référence de Connect-PnPOnline indique que vous devez fournir le paramètre -ClientId à partir du 9 septembre 2024. Elle précise également que vous devez d’abord enregistrer votre propre application. Vous pouvez définir la variable d’environnement ENTRAID_APP_ID ou ENTRAID_CLIENT_ID au lieu de saisir l’identifiant à chaque fois.

Cela a un impact sur les anciens scripts. Si un script de 2023 appelle Connect-PnPOnline -Url ... -Interactive et rien d’autre, il échouera désormais ou demandera un ID client manquant. La correction ne se trouve pas dans la logique du script : il vous faut une application et un identifiant.

Deux autres valeurs apparaissent dans chaque exemple :

  • -Url est l’adresse du site sur lequel vous voulez travailler, par exemple https://contoso.sharepoint.com/sites/finance. Elle est obligatoire pour la plupart des méthodes.
  • -Tenant est le nom du locataire, par exemple contoso.onmicrosoft.com. La référence l’indique comme obligatoire pour les méthodes par certificat et par empreinte. Elle est facultative pour la connexion interactive et la connexion par code d’appareil.

Si une commande nécessite le Centre d’administration SharePoint, vous pouvez transmettre -TenantAdminUrl. Si vous l’omettez, les applets de commande supposent la forme https://[nomdulocataire]-admin.sharepoint.com lorsque cela s’applique.

Étape 1 : finaliser l’enregistrement de l’application dans Microsoft Entra

Cette étape de démarrage suppose que le module PnP.PowerShell est déjà installé sur votre poste. PnP fournit une commande d’aide pour la configuration initiale. La page de référence de Register-PnPEntraIDAppForInteractiveLogin présente la forme la plus courte :

Register-PnPEntraIDAppForInteractiveLogin -ApplicationName TestApp -Tenant yourtenant.onmicrosoft.com

Une fenêtre de navigateur s’ouvre pour vous permettre de vous connecter, et la commande crée l’application. Elle affiche également l’ID d’application que vous utiliserez comme -ClientId. Ajoutez -DeviceLogin si vous ne pouvez pas ouvrir de navigateur sur le poste. La page indique que cette option bascule vers un flux de connexion par code d’appareil, compatible avec l’authentification multifacteur.

Faites attention aux autorisations. Avec l’exemple de base, l’application demande les autorisations déléguées suivantes à consentir : AllSites.FullControl, Group.ReadWrite.All, User.ReadWrite.All et TermStore.ReadWrite.All. Le second exemple de la même page les restreint avec -GraphDelegatePermissions "Group.Read.All" et -SharePointDelegatePermissions "AllSites.FullControl".

C’est important pour le principe du moindre privilège. Un script de rapport qui ne fait que lire n’a pas besoin de droits d’écriture sur les utilisateurs et les groupes. Déterminez ce dont vos scripts ont besoin, et ne demandez que cela.

Tenez un registre de chaque inscription d’application : son nom, son ID client, son propriétaire et les autorisations qu’elle détient. Passez en revue l’inscription d’application une fois par an, et supprimez-la lorsqu’aucun script ne l’utilise plus.

Deux limites sont à connaître. La page de référence ne précise pas quel rôle Entra est nécessaire pour enregistrer une application ; renseignez-vous donc auprès de votre administrateur d’identité avant de commencer. Par ailleurs, le paramètre -SignInAudience détermine les types de comptes pris en charge par l’application ; vérifiez qu’il correspond à votre locataire.

Comment se connecter à SharePoint Online avec PnP PowerShell : les cinq options

Les cinq exemples s’appuient tous sur la référence Connect-PnPOnline. Remplacez les valeurs entre chevrons.

Connexion interactive

Connect-PnPOnline -Url "https://contoso.sharepoint.com" -Interactive -ClientId <appId>

C’est le choix par défaut pour une personne. La référence indique qu’elle est conçue pour prendre en charge l’authentification multifacteur. Ajoutez -ForceAuthentication pour effacer l’authentification enregistrée et vous connecter avec un autre compte. Utilisez-le lorsque vous passez d’un locataire de test à un locataire de production.

Connexion par code d’appareil

Connect-PnPOnline -Url "https://contoso.sharepoint.com" -DeviceLogin -ClientId <appId>

Un navigateur s’ouvre et le code est copié dans votre presse-papiers. Choisissez cette option lorsque le shell s’exécute dans une session distante où une fenêtre interactive ne fonctionne pas bien.

Connexion par certificat (application uniquement)

Connect-PnPOnline -Url "https://contoso.sharepoint.com" -ClientId <appId> -Tenant 'contoso.onmicrosoft.com' -Thumbprint <thumbprint>

Aucune personne ne se connecte. L’application agit de manière autonome, avec les autorisations d’application que vous lui avez accordées. Vous pouvez passer -CertificatePath avec -CertificatePassword, une valeur -CertificateBase64Encoded, ou un -Thumbprint. La méthode par empreinte exige que le certificat se trouve dans le magasin de certificats Windows. C’est le choix standard pour les scripts sans surveillance sur un serveur.

Identité managée

Connect-PnPOnline -Url "https://contoso.sharepoint.com" -ManagedIdentity

La référence indique que cette méthode ne fonctionne que dans les environnements qui prennent en charge les identités managées, comme Azure Functions, les runbooks Azure Automation et Cloud Shell. Aucun secret n’est stocké. Pour une identité affectée par l’utilisateur, ajoutez l’un des paramètres -UserAssignedManagedIdentityClientId, -UserAssignedManagedIdentityObjectId ou -UserAssignedManagedIdentityAzureResourceId. Le paramètre -Url est facultatif avec cette méthode.

Identifiants et secrets client

Deux méthodes plus anciennes subsistent, et toutes deux s’accompagnent d’avertissements.

  • -Credentials accepte un PSCredential, par exemple (Get-Credential), ou le nom d’un identifiant générique dans le Gestionnaire d’identifiants Windows. La référence mentionne la prise en charge de l’authentification multifacteur pour la connexion interactive et par code d’appareil, mais ne l’affirme pas ici. Considérez-la comme une option pour les comptes sans invite, et testez-la avant de vous y fier.
  • -ClientSecret avec -ClientId correspond à l’ancienne méthode ACS. La documentation indique qu’avec celle-ci, « seules les applets de commande qui se connectent à SharePoint Online fonctionneront ». Les applets de commande qui utilisent Microsoft Graph échoueront.

Évitez les deux pour tout nouveau projet. Un mot de passe dans un script est un risque, et un secret client expire sans prévenir.

Exemple : choisir une option d’authentification pour quatre tâches

Les chiffres et les noms ci-dessous sont fictifs et servent uniquement à l’illustration.

Une équipe d’administration d’une entreprise fictive exécute quatre tâches. Elle souhaite une application par niveau de risque, et non une seule application pour tout.

  1. Contrôles ponctuels par un administrateur sur son ordinateur portable. Utilisez -Interactive avec une application disposant d’autorisations déléguées restreintes. L’administrateur se connecte avec l’authentification multifacteur. Rien n’est stocké.
  2. Un nettoyage unique lancé depuis un serveur de rebond distant. Utilisez -DeviceLogin. L’administrateur termine la connexion sur un téléphone ou un ordinateur portable, puis l’exécution démarre.
  3. Un inventaire nocturne sur un serveur Windows. Utilisez un certificat avec -Thumbprint. L’application dispose d’autorisations d’application en lecture seule. Le certificat est valable 12 mois, et l’équipe inscrit la date de renouvellement dans un agenda partagé.
  4. Une tâche hebdomadaire dans un runbook Automation. Utilisez -ManagedIdentity. Il n’y a ni certificat ni secret à renouveler.

Le résultat : seules les tâches 1 et 2 dépendent d’une personne. Les tâches 3 et 4 s’exécutent sans présence humaine, et aucune ne stocke de mot de passe. Si le serveur de la tâche 3 est volé, l’équipe révoque un seul certificat. Elle n’a pas à réinitialiser le mot de passe d’un administrateur.

Quelle que soit l’option retenue, conservez l’URL du site dans une variable telle que $siteUrl, afin qu’un seul script PowerShell puisse parcourir chaque site d’une liste de sites, récupérer les données nécessaires sur chaque site SharePoint et importer un rapport. Testez l’exécution du script sur une seule collection de sites avant de le lancer sur l’ensemble de votre locataire Microsoft 365.

Erreurs courantes

  • Oublier -ClientId. La connexion échoue ou demande cet identifiant. Enregistrez l’ID dans la variable d’environnement ENTRAID_APP_ID sur les machines où vous exécutez souvent des scripts.
  • Utiliser une seule application toute-puissante pour tout. L’inscription par défaut demande AllSites.FullControl ainsi que l’accès en écriture aux utilisateurs et aux groupes. Enregistrez une seconde application en lecture seule pour les rapports.
  • Utiliser un secret client avec des applets de commande basées sur Graph. L’ancienne méthode ne fonctionne que pour les applets de commande SharePoint. Si une commande appelle Graph, elle échouera, et le message d’erreur peut prêter à confusion.
  • Placer un mot de passe ou un secret dans le fichier de script. Toute personne ayant un accès en lecture au fichier possède les identifiants. Utilisez un magasin de certificats ou une identité managée.
  • Ne pas tester la connexion dans l’environnement final. Un script qui fonctionne sur votre ordinateur portable avec -Interactive peut échouer sur un serveur sans navigateur. Testez avec la méthode que la tâche utilisera réellement.
  • Rester connecté au mauvais locataire. Utilisez -ForceAuthentication lorsque vous changez de compte, et affichez les détails de connexion au début de chaque script.

Comment les logiciels peuvent aider

Commencez par ce que vous avez déjà. Le module PnP et le SDK PowerShell Microsoft Graph couvrent la plupart des scripts d’administration. Azure Automation exécute des scripts selon un planning avec une identité managée, et le Centre d’administration SharePoint affiche les sites et les paramètres sans code. Pour les secrets, un magasin de certificats ou un coffre de clés est plus sûr qu’un fichier de script.

Ajoutez ensuite un suivi. Un script qui se connecte correctement n’est que la première étape. Les équipes ont aussi besoin d’un journal clair indiquant ce que chaque script a modifié et l’identité d’application utilisée, afin que l’administrateur suivant puisse comprendre les actions. Conservez ce journal à un endroit accessible à tous, comme une liste partagée ou un système de tickets.

Prochaine étape

Enregistrez dès aujourd’hui une application avec le plus petit ensemble d’autorisations déléguées dont vos scripts ont besoin. Vérifiez ensuite que vous pouvez vous connecter à SharePoint Online avec PnP PowerShell en utilisant -Interactive, et notez quelle option d’authentification chacune de vos tâches planifiées utilisera.

Suivre le podcastSpotify

Entités dans cet article

PnP PowerShell Microsoft Entra PowerShell SharePoint

Articles associés

RSS