Publicar modelos personalizados com o PowerShell

Artigo
07/06/2023

^{Aplica-se a: ✓ Todos os modelos personalizados | ✓ Todos os modelos pré-criados}

Importante

Os Microsoft Syntex cmdlets do PowerShell e todos os outros componentes PnP são ferramentas open source suportadas por uma comunidade ativa que lhes fornece suporte. Não existe nenhum SLA para suporte de ferramentas open source dos canais de suporte oficiais da Microsoft.

Normalmente, os modelos Syntex são implementados em bibliotecas de documentos em todo o seu inquilino. Isto pode ser feito através do site do centro de conteúdos, mas também pode fazê-lo com o PnP PowerShell , conforme explicado neste artigo.

Listar os modelos disponíveis num centro de conteúdos

Para obter uma descrição geral dos modelos adicionados ao site do centro de conteúdos do Syntex atual, utilize o cmdlet Get-PnPSyntexModel :

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

Aplicar um modelo a uma biblioteca

Para aplicar um modelo a uma biblioteca, utilize o 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"

Compreender onde um modelo é utilizado

Depois de implementar um modelo em muitas bibliotecas, poderá querer rever a lista de bibliotecas com o seu modelo. Isto pode ser feito com o cmdlet Get-PnPSyntexModelPublication :

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

Remover um modelo de uma biblioteca

Remover um modelo de uma biblioteca segue o mesmo padrão que a aplicação e pode ser feito com o cmdlet Unpublish-PnPSyntexModel interativamente ou como lote de múltiplas ações.

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

Aplicar modelos em massa

Se quiser publicar vários modelos em múltiplas bibliotecas, crie um ficheiro CSV de entrada que liste os modelos e as localizações de destino:

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

Em seguida, este ficheiro CSV pode ser utilizado como uma entrada num script que irá publicar os modelos listados nas bibliotecas adequadas. No exemplo seguinte, a criação de batches é utilizada para aumentar a eficiência dos pedidos.

$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

Partilhar via