다음을 통해 공유

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

참고

항목이 5,000개 이상인 -Force 옵션을 사용하면 최대 처리량이 자동으로 해제됩니다.

속성에 따라 모든 항목의 처리 요청

라이브러리의 특정 항목 하위 집합으로 처리를 제한하려는 경우 스크립트를 사용하여 특정 파일 그룹을 선택할 수 있습니다. 다음 예제에서 스크립트를 사용하면 필드를 선택하고 필드 값을 필터링할 수 있습니다. 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