Używanie programu PowerShell do żądania przetwarzania za pomocą modelu niestandardowego

^{Dotyczy: √ Wszystkie modele niestandardowe | √ Wszystkie wstępnie utworzone modele}

Ważna

Polecenia cmdlet programu PowerShell Microsoft Syntex i wszystkie inne składniki PnP są narzędziami typu open source wspieranymi przez aktywną społeczność zapewniającą im obsługę. Nie ma umowy SLA dla obsługi narzędzi typu open source z oficjalnych kanałów pomocy technicznej firmy Microsoft.

Modele niestandardowe będą przetwarzać nowo przekazane pliki do biblioteki. Istnieje również możliwość ręcznego żądania przetwarzania w interfejsie użytkownika. Jednak mogą istnieć scenariusze, w których bardziej wydajne jest wyzwalanie przetwarzania za pośrednictwem programu PowerShell.

Żądanie przetwarzania wszystkich elementów, które nie zostały wcześniej sklasyfikowane

Możesz zażądać przetwarzania dla wszystkich elementów w bibliotece, które nie zostały wcześniej sklasyfikowane za pomocą tego polecenia:

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

W przypadku przetwarzania o niższym priorytecie można również rozważyć użycie parametru -OffPeak, który będzie umieszczać pliki w kolejce do przetwarzania poza godzinami pracy, w których znajduje się dzierżawa. Aby uzyskać więcej informacji, zobacz Request-PnPSyntexClassifyAndExtract.

Żądanie przetwarzania wszystkich elementów w bibliotece

Możesz zażądać przetworzenia wszystkich plików w bibliotece, nawet jeśli zostały one wcześniej sklasyfikowane. Ten krok może być przydatny, jeśli zaktualizowano model lub dodano inny model do biblioteki.

#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

Uwaga

Użycie opcji -Force z ponad 5000 elementami spowoduje automatyczne włączenie poza szczytowym przetwarzaniem.

Żądanie przetwarzania wszystkich elementów na podstawie właściwości

Jeśli chcesz ograniczyć przetwarzanie do określonego podzestawu elementów w bibliotece, możesz użyć skryptu, aby wybrać określoną grupę plików. W poniższym przykładzie skrypt umożliwia wybranie pola, a wartość pola do filtrowania. Bardziej złożone zapytania można wykonać przy użyciu polecenia 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

Żądanie przetwarzania określonych plików

Przetwarzanie można również zażądać dla określonych plików.

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

Plik według modelu plików obsługuje również dzielenie na partie:

#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