Publier des modèles personnalisés avec PowerShell

Article
07/16/2023

^{S’applique à : ✓ Tous les modèles personnalisés | ✓ Tous les modèles prédéfinis}

Importante

Les applets de commande PowerShell Microsoft Syntex et tous les autres composants PnP sont des outils open source soutenus par une communauté active qui les prend en charge. Il n’existe aucun contrat de niveau de service pour la prise en charge des outils open source des canaux de support Microsoft officiels.

Les modèles Syntex sont généralement déployés dans des bibliothèques de documents dans votre locataire. Pour ce faire, utilisez le site du centre de contenu, mais vous pouvez également utiliser PnP PowerShell , comme expliqué dans cet article.

Liste des modèles disponibles dans un centre de contenu

Pour obtenir une vue d’ensemble des modèles ajoutés au site de centre de contenu Syntex actuel, utilisez l’applet de commande Get-PnPSyntexModel :

Connect-PnPOnline -Url "https://contoso.sharepoint.com/sites/yourContentCenter"
Get-PnPSyntexModel

Appliquer un modèle à une bibliothèque

Pour appliquer un modèle à une bibliothèque, utilisez l’applet de commande Publish-PnPSyntexModel :

Connect-PnPOnline -Url "https://contoso.sharepoint.com/sites/yourContentCenter"
Publish-PnPSyntexModel -Model "Contract Notice" -ListWebUrl "https://contoso.sharepoint.com/sites/finance" -List "Documents"

Comprendre où un modèle est utilisé

Une fois que vous avez déployé un modèle dans de nombreuses bibliothèques, vous pouvez consulter la liste des bibliothèques qui utilisent votre modèle. Pour ce faire, utilisez l’applet de commande Get-PnPSyntexModelPublication :

Connect-PnPOnline -Url "https://contoso.sharepoint.com/sites/yourContentCenter"
Get-PnPSyntexModelPublication -Identity "Contract Notice"

Suppression d’un modèle d’une bibliothèque

La suppression d’un modèle d’une bibliothèque suit le même modèle que l’application et peut être effectuée à l’aide de l’applet de commande Unpublish-PnPSyntexModel de manière interactive ou en tant que lot de plusieurs actions.

Connect-PnPOnline -Url "https://contoso.sharepoint.com/sites/yourSite"
Unpublish-PnPSyntexModel -Model "Invoice model" -ListWebUrl "https://contoso.sharepoint.com/sites/finance" -List "Documents"

Appliquer des modèles en bloc

Si vous souhaitez publier plusieurs modèles dans plusieurs bibliothèques, créez un fichier CSV d’entrée répertoriant les modèles et les emplacements cibles :

ModelName,TargetSiteUrl,TargetWebServerRelativeUrl,TargetLibraryServerRelativeUrl
Contract Notice,https://contoso.sharepoint.com/sites/Site1,/sites/Site1,/sites/site1/shared%20documents
Contract Notice,https://contoso.sharepoint.com/sites/Site1,/sites/Site1,/sites/site1/other
Trade Confirmation,https://contoso.sharepoint.com/sites/Site2,/sites/Site2,/sites/site2/shared%20documents

Ce fichier CSV peut ensuite être utilisé comme entrée dans un script qui publiera les modèles répertoriés dans les bibliothèques appropriées. Dans l’exemple suivant, le traitement par lot est utilisé pour augmenter l’efficacité des requêtes.

$contentCenterURL = "https://contoso.sharepoint.com/sites/yourSite"
$targetsCSV = "./Publish-SyntexModelBulk.csv"

Connect-PnPOnline -url $contentCenterURL

$targetLibraries = Import-Csv -Path $targetsCSV

$batch = New-PnPBatch

foreach ($target in $targetLibraries) {
    Publish-PnPSyntexModel -Model $target.ModelName -TargetSiteUrl $target.TargetSiteUrl -TargetWebServerRelativeUrl $target.TargetWebServerRelativeUrl -TargetLibraryServerRelativeUrl $target.TargetLibraryServerRelativeUrl -Batch $batch
}

Invoke-PnPBatch -Batch $batch

Partager via