Pubblicare modelli personalizzati con PowerShell

^{Si applica a: ✓ Tutti i modelli personalizzati | ✓ Tutti i modelli predefiniti}

Importante

I Microsoft Syntex cmdlet di PowerShell e tutti gli altri componenti PnP sono strumenti open source supportati da una community attiva che fornisce supporto. Non è disponibile alcun contratto di servizio per il supporto degli strumenti open source da canali di supporto Microsoft ufficiali.

I modelli Syntex vengono in genere distribuiti nelle raccolte documenti nel tenant. Questa operazione può essere eseguita usando il sito del centro contenuti, ma questa operazione può essere eseguita anche usando PowerShell PnP , come illustrato in questo articolo.

Presentazione dei modelli disponibili in un centro contenuti

Per ottenere una panoramica dei modelli aggiunti al sito del centro contenuti Syntex corrente, usare il cmdlet Get-PnPSyntexModel :

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

Applicare un modello a una libreria

Per applicare un modello a una libreria, usare il cmdlet 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"

Informazioni sulla posizione in cui viene usato un modello

Dopo aver distribuito un modello in molte librerie, è possibile esaminare l'elenco delle librerie usando il modello. Questa operazione può essere eseguita usando il cmdlet Get-PnPSyntexModelPublication :

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

Rimozione di un modello da una libreria

La rimozione di un modello da una libreria segue lo stesso modello dell'applicazione e può essere eseguita usando il cmdlet Unpublish-PnPSyntexModel in modo interattivo o come batch di più azioni.

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

Applicare modelli in blocco

Se si vogliono pubblicare più modelli in più librerie, creare un file CSV di input che elenca i modelli e i percorsi di destinazione:

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

Questo file CSV può quindi essere usato come input in uno script che pubblicherà i modelli elencati nelle librerie appropriate. Nell'esempio seguente viene usato l'invio in batch per aumentare l'efficienza delle richieste.

$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