使用 PowerShell 要求自訂模型的處理

^{適用于： ✓ 所有自訂模型 |✓ 所有預先建置的模型}

重要事項

Microsoft Syntex PowerShell Cmdlet 和所有其他 PnP 元件都是開放原始碼工具，由提供支援的作用中社群所支援。 來自官方的 Microsoft 支援頻道沒有針對開放原始碼工具支援的 SLA。

自訂模型會處理新上傳至文件庫的檔案。 您也可以在 UI 中手動要求處理。 不過，在某些情況下，透過 PowerShell 觸發處理會更有效率。

要求處理先前尚未分類的所有專案

您可以使用下列命令，要求處理程式庫中先前尚未分類的所有專案：

#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"

針對優先順序較低的處理，您也可以考慮使用 -OffPeak 參數，此參數會佇列租用戶上班時間外要處理的檔案。 如需詳細資訊，請 參閱 Request-PnPSyntexClassifyAndExtract。

要求處理文件庫中的所有項目

您可以要求處理文件庫中的所有檔案，即使它們已經被事先分類過。 如果您已更新模型或將另一個模型新增至程式庫，此步驟可能很有用。

#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

注意事項

將 -Force 選項與超過 5000 個項目一起處理，會自動啟用非尖峰處理。

要求按屬性處理所有項目

如果您想要將處理限制為文件庫中的特定項目子集，您可以使用腳本來選取特定的檔案群組。 在下列範例中，腳本允許選取欄位，以及篩選欄位值。 您可以使用 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

要求處理特定檔案

也可以要求對特定檔案進行處理。

#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"

檔案接檔案模型也支援批次處理：

#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