Découvrez le provisionnement de site moderne SharePoint Online à l’aide du moteur de provisionnement PnP et de PnP PowerShell

L’infrastructure d’approvisionnement PnP est une plate-forme centrée sur le code et basée sur des modèles pour l’approvisionnement de vos collections de sites. Le nouveau moteur de provisionnement vous permet de conserver et de réutiliser les modèles de provisionnement dans Office 365, SharePoint Online et les collections de sites sur site.

Ce blog montre comment provisionner un site d’équipe à l’aide de PnP PowerShell. Dans ce processus, nous utiliserons un site SharePoint existant pour créer un modèle réutilisable. En utilisant ce modèle, nous pouvons créer plusieurs fois des sites exactement similaires pour plusieurs clients.

Connaître vos prérequis

Pour exécuter certaines commandes, vous devez avoir le framework PnP PowerShell déjà installé sur votre ordinateur. S’il n’est pas installé, vous pouvez simplement l’installer en exécutant la commande suivante dans l’invite de commande :

Install-Module -Name PnP.PowerShell

Ou vous pouvez vous référer à ceci lien pour plus d’instructions sur l’installation de PnP PowerShell.

Une fois que vous avez terminé, lancez Windows PowerShell en mode « administrateur » et exécutez la commande suivante pour installer le module PnP PowerShell pour SharePoint Online :

Module d’installation SharePointPnPPowerShellOnline

Si vous exécutez des commandes PnP PowerShell pour la première fois dans votre système, vous devrez peut-être accorder l’accès à PowerShell à votre site en ligne SharePoint. Pour fournir l’accès, exécutez la commande suivante dans Windows PowerShell :

S’inscrire-PnPManagementShellAccess

Vous êtes maintenant prêt à exécuter les commandes PnP PowerShell dans votre système.

Comprendre l’aperçu du processus

L’image suivante montre le processus de base que nous suivrons pour approvisionner un site Web à l’aide du cadre d’approvisionnement PnP :

1. Modèle d’extraction
2. Personnalisation des artefacts et autres configurations dans le modèle
3. Appliquer un modèle au nouveau site cible

Comment extraire le modèle de site

Comme déjà mentionné, nous utiliserons un site existant pour configurer notre modèle PnP. Le moyen le plus simple d’obtenir un modèle d’approvisionnement personnalisé consiste à créer manuellement une nouvelle collection de sites dans SharePoint Online, à configurer vos artefacts (colonnes de site, types de contenu, listes et pages) et à enregistrer le résultat en tant que modèle d’approvisionnement.

Une fois le site configuré, nous extrairons le modèle de ce site à l’aide de PnP PowerShell.

Veuillez suivre les étapes suivantes :

• Ouvrez Windows PowerShell en mode « Administrateur »
• Connectez-vous au site nouvellement créé en exécutant la commande suivante :

Connect-PnPOnline -Url

Cette commande établira la connexion à votre collection de sites à partir de PowerShell. Vous pouvez accéder à tous les artefacts tels que les listes, les bibliothèques, les actifs du site, les autorisations, les détails du site, etc. pour le site actuellement connecté à l’aide des commandes PnP PowerShell.

• Vous serez invité à entrer des informations d’identification, alors entrez les informations d’identification de connexion pour votre site.
• Si vous ne recevez pas d’invite pour entrer vos informations d’identification, créez un objet d’identification et transmettez-le à la commande « Connect » :

$user = « « 

$secpasswd = ConvertTo-SecureString «  » -AsPlainText -Force

$mycreds = Nouvel objet System.Management.Automation.PSCredential ($user, $secpasswd)

Connect-PnPOnline -url $siteAdminURL -Credentials $mycreds

• Exécutez la commande suivante pour exporter le modèle de site au format XML :

Get-PnPSiteTemplate -Out « D:\PnP-TemplateForSite.xml »

Dans cette commande, vous pouvez spécifier le chemin d’accès où vous devez télécharger le modèle et comment nommer le fichier de modèle. Dans ce cas, le modèle sera créé dans le lecteur « D:\ » avec le nom « PnP-TemplateForSite.xml ».

Le modèle est créé à son chemin spécifique une fois la commande exécutée. Ce sera un fichier .xml puisque nous avons fourni l’extension « .xml » dans un nom de fichier. Le modèle ressemblera à ceci :

Voici à quoi ressemblera notre modèle PnP. Ce modèle contient tous les détails sur la version du schéma d’approvisionnement PnP, le nom, etc. Il a différentes balises pour configurer ou personnaliser un site Web. Nous pouvons configurer le logo du site Web, les listes, les membres du site Web, les champs du site Web, les navigations sur le site Web, les autorisations et la sécurité à partir de ce modèle.

Paramètres pour l’extraction de la configuration personnalisée

Nous pouvons décider des configurations que nous devons extraire dans le modèle PnP du site existant en ajoutant des paramètres supplémentaires dans la commande « Get-PnPSiteTemplate ». Nous pouvons utiliser différents paramètres dans la commande. Pour plus d’informations sur les différents paramètres, vous pouvez vous référer à ce lien.

Créer un nouveau site ou un site cible à l’aide de PnP PowerShell

Une fois le modèle extrait, nous pouvons appliquer ce modèle à tout site Web nouvellement créé. Avant de créer le modèle, nous allons créer un nouveau site moderne à l’aide de la commande PnP PowerShell ci-dessous :

Nouveau-PnPSite -Type TeamSite -Titre « Nouveau site cible »

Le code vous demandera de définir un nom d’alias après avoir exécuté la commande. Vous fournirez un nom d’alias et appuyez sur « Entrée ». Il commencera alors à créer le site Web sur le locataire connecté. Attention, la création du site peut prendre un certain temps. Une fois le site créé, la nouvelle URL du site s’affichera dans Windows PowerShell, comme illustré dans l’image suivante :

Application du modèle PnP au nouveau site cible

Avant d’appliquer le modèle d’approvisionnement extrait au site Web cible nouvellement créé, vous devez vous assurer que le nouveau site cible est opérationnel et fonctionne correctement. Pour ce faire, nous devrons d’abord nous connecter au nouveau site cible à partir de PnP PowerShell, puis nous lui appliquerons le modèle. Pour cela, exécutez les commandes suivantes dans Windows PowerShell :

Connect-PnPOnline -Url

Invoke-PnPSiteTemplate -Path « D:\PnP-TemplateForSite.xml »

La « -Chemin » L’argument fait référence au fichier de modèle source que nous avons créé dans les étapes précédentes « PnP-TemplateForSite.xml ». Lors de la spécification du nom de fichier, assurez-vous qu’il n’y aura pas d’espaces dans le nom de fichier.

Une fois la commande exécutée, vous verrez la progression de l’approvisionnement du modèle sur le site comme suit.

L’application du modèle peut prendre 20 à 30 minutes si le modèle contient trop de personnalisations. Cette durée peut varier en fonction de la complexité du modèle PnP que nous appliquons au site. Lorsque l’exécution de la commande est terminée, vous pouvez voir que le site cible dispose de toute la personnalisation et de l’ensemble d’artefacts que nous avons configurés dans le modèle PnP qui lui est appliqué.

Nous pouvons appliquer le même modèle à autant de sites que nous le souhaitons. Ce processus nous permet d’automatiser la création de plusieurs sites identiques avec le même ensemble de listes, bibliothèques, types de contenu, champs de site, autorisations et autres sans prendre aucun effort supplémentaire pour configurer toutes ces choses manuellement pour chaque site.

De conclure…

Dans ce blog, nous avons appris à utiliser PnP PowerShell et PnP Provisioning Template pour appliquer un modèle personnalisé à un site nouvellement créé afin d’automatiser le processus de création et d’appliquer des artefacts et des configurations personnalisés. Pour plus d’informations, contactez nos experts en commerce dès aujourd’hui.