Uso de PowerShell para solicitar el procesamiento por parte de un modelo personalizado

^{Se aplica a: ✓ Todos los modelos personalizados | ✓ Todos los modelos precompilados}

Importante

Los cmdlets Microsoft Syntex de PowerShell y todos los demás componentes de PnP son herramientas de código abierto respaldadas por una comunidad activa que proporciona soporte técnico para ellos. Los canales oficiales de soporte técnico de Microsoft no ofrecen ningún contrato de nivel de servicio para herramientas de código abierto.

Los modelos personalizados procesarán los archivos recién cargados en una biblioteca. También es posible solicitar manualmente el procesamiento en la interfaz de usuario. Sin embargo, puede haber escenarios en los que sea más eficaz desencadenar el procesamiento a través de PowerShell.

Procesamiento de solicitudes de todos los elementos que no se han clasificado previamente

Puede solicitar el procesamiento de todos los elementos de la biblioteca que no se hayan clasificado previamente mediante este comando:

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

Para el procesamiento de prioridad inferior, también puede considerar el uso del parámetro -OffPeak, que pondrá en cola los archivos para su procesamiento fuera del horario comercial donde se encuentra el inquilino. Para obtener más información, vea Request-PnPSyntexClassifyAndExtract.

Solicitud de procesamiento de todos los elementos de una biblioteca

Puede solicitar el procesamiento de todos los archivos de la biblioteca, incluso si se han clasificado anteriormente. Este paso puede ser útil si ha actualizado un modelo o ha agregado otro modelo a la biblioteca.

#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

Nota:

El uso de la opción -Force con más de 5000 elementos habilitará automáticamente el procesamiento máximo.

Procesamiento de solicitudes de todos los elementos basados en una propiedad

Si desea limitar el procesamiento a un subconjunto específico de elementos de una biblioteca, puede usar un script para seleccionar un grupo específico de archivos. En el ejemplo siguiente, el script permite seleccionar un campo y un valor de campo por el que filtrar. Las consultas más complejas se pueden completar mediante 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

Procesamiento de solicitudes de archivos específicos

El procesamiento también se puede solicitar para archivos específicos.

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

El modelo de archivos por archivo también admite el procesamiento por lotes:

#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