Partager via

Utiliser PowerShell pour demander le traitement par un modèle personnalisé

  • Article

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 personnalisés traitent les fichiers nouvellement chargés dans une bibliothèque. Il est également possible de demander manuellement le traitement dans l’interface utilisateur. Toutefois, il peut y avoir des scénarios où il est plus efficace de déclencher le traitement via PowerShell.

Traitement des demandes de tous les éléments qui n’ont pas été classés précédemment

Vous pouvez demander le traitement de tous les éléments de la bibliothèque qui n’ont pas été classés précédemment à l’aide de cette commande :

#Note: you're connecting here to the site that holds the document library you want to process
Connect-PnPOnline -Url "https://contoso.sharepoint.com/sites/finance"

Request-PnPSyntexClassifyAndExtract -List "Documents"

Pour le traitement de priorité inférieure, vous pouvez également envisager d’utiliser le paramètre -OffPeak, qui met en file d’attente les fichiers à traiter en dehors des heures d’ouverture où se trouve votre locataire. Pour plus d’informations, consultez Request-PnPSyntexClassifyAndExtract.

Demander le traitement de tous les éléments d’une bibliothèque

Vous pouvez demander le traitement de tous les fichiers de la bibliothèque, même s’ils ont été précédemment classifiés. Cette étape peut être utile si vous avez mis à jour un modèle ou ajouté un autre modèle à la bibliothèque.

#Note: you're connecting here to the site that holds the document library you want to process
Connect-PnPOnline -Url "https://contoso.sharepoint.com/sites/finance"

Request-PnPSyntexClassifyAndExtract -List "Documents" -Force

Remarque

L’utilisation de l’option -Force avec plus de 5 000 éléments active automatiquement le traitement en dehors des heures creuses.

Traitement des demandes de tous les éléments en fonction d’une propriété

Si vous souhaitez limiter le traitement à un sous-ensemble spécifique d’éléments dans une bibliothèque, vous pouvez utiliser un script pour sélectionner un groupe spécifique de fichiers. Dans l’exemple suivant, le script autorise la sélection d’un champ et la valeur d’un champ à filtrer. Des requêtes plus complexes peuvent être effectuées à l’aide de Get-PnPListItem.

#Note: you're connecting here to the site that holds the document library you want to process
Connect-PnPOnline -Url "https://contoso.sharepoint.com/sites/finance"
$list = Get-PnPList -Identity "Documents"
# Set the field name to filter items by
$fieldName = "Vendor"
# Set the field value to filter by
$fieldFilter = "Fabrikam"

$listItems = (Get-PnPListItem -List $list -fields $fieldName).fieldValues
$targetItems = $listItems | Where-Object -Property Provider -EQ -Value $fieldFilter

# Create a new batch
$batch = New-PnPBatch

# Add files to classify to the batch
foreach ($listItem in $targetItems) {
    Request-PnPSyntexClassifyAndExtract -FileUrl $listItem.FileRef -Batch $batch
}

# Execute batch
Invoke-PnPBatch -Batch $batch

Demander le traitement de fichiers spécifiques

Le traitement peut également être demandé pour des fichiers spécifiques.

#Note: you're connecting here to the site that holds the document library you want to process
Connect-PnPOnline -Url "https://contoso.sharepoint.com/sites/finance"

Request-PnPSyntexClassifyAndExtract -FileUrl "/sites/finance/documents/contoso contract.docx"

Le modèle fichier par fichier prend également en charge le traitement par lot :

#Note: you're connecting here to the site that holds the document library you want to process
Connect-PnPOnline -Url "https://contoso.sharepoint.com/sites/finance"

# Create a new batch
$batch = New-PnPBatch

# Add files to classify to the batch
Request-PnPSyntexClassifyAndExtract -FileUrl "/sites/finance/documents/contoso contract.docx" -Batch $batch
Request-PnPSyntexClassifyAndExtract -FileUrl "/sites/finance/documents/relecloud contract.docx" -Batch $batch

# Execute batch
Invoke-PnPBatch -Batch $batch