SharePoint | Удалить историю версий с помощью PnP PowerShell

Я отвечаю на свой вопрос, потому что наконец нашел решение!

Проблема оказалась более сложной, чем ожидалось, потому что:

1. Get-PnPProperty не обрабатывает большие файлы (возможно, более 2 ГБ, но, возможно, даже всего 250 МБ). Но это также относится и к другим командам, таким как Get-PnPFileVersion.
2. Подход Get-PnPContext правильный, но его пришлось применить к целой библиотеке документов, а такие команды, как Get-PnPList или Get-PnPListItem, не извлекали все файлы (опять же, вероятно, потому, что они были слишком тяжелыми или было слишком много версий данного файла).

Итак, хитрость заключалась в том, чтобы использовать Get-PnPFileInFolder рекурсивно и, самое главное, не загружать свойства версии (или любые другие свойства) до тех пор, пока файл не будет обработан.

Таким образом мы получаем то, что хотим: удаляются все версии всех файлов в библиотеке SharePoint, даже для больших файлов или файлов с множеством версий. Запуск скрипта занимает немного времени, так как будут проверены все файлы (кроме тех, что находятся в системных папках), но он работает как шарм (проверено на нескольких библиотеках).

Небольшой бонус: в конце выполнения скрипт генерирует csv-файл, в котором суммируются все выполненные операции.

Измените параметры $siteUrl, $libraryName, $csvFilePath в соответствии с вашим окружением и вуаля!

Со своей стороны, мне удалось восстановить более 550 ГБ дискового пространства, доступного в SharePoint, не тратя денег на программное решение;)

Да, и последний момент: если вы не хотите делать это снова, не забудьте отключить контроль версий (если вы, конечно, им не пользуетесь). Скрипты Дневник SharePoint, особенно сценарий PnP PowerShell для отключения управления версиями в списке, работают отлично.

Скрипт (надеюсь, поможет):

# Define Parameters
$siteUrl = "https://mycompagny.sharepoint.com/sites/Marketing"
$libraryName = "Documents"
$csvFilePath = "C:\Users\USERNAME\VersionCleanupReport.csv"

# Initialize array to store operation details
$operationDetails = @()

# Connect to SharePoint Online site
Connect-PnPOnline -Url $siteUrl -Interactive

# Get all files in the document library
$files = Get-PnPFolder -ListRootFolder $libraryName | Get-PnPFileInFolder -Recurse -ExcludeSystemFolders

# Iterate through each file
foreach ($file in $files) {
    # Attempt to delete all versions of the file
    try {
        Write-Host -ForegroundColor Yellow "Scanning file: $($file.ServerRelativeUrl)"

        # Get the file object without loading version properties
        $context = Get-PnPContext
        $fileObject = $context.Web.GetFileByServerRelativeUrl($file.ServerRelativeUrl)
        $context.Load($fileObject)
        $context.ExecuteQuery()

        # Check if the file has versions
        $versions = $fileObject.Versions
        $context.Load($versions)
        $context.ExecuteQuery()

        $versionsCount = $versions.Count

        if ($versionsCount -gt 0) {
            # Delete all versions of the file
            $fileObject.Versions.DeleteAll()
            $context.ExecuteQuery()

            Write-Host -ForegroundColor Green "Deleted $versionsCount versions of file: $($file.ServerRelativeUrl)"

            # Add operation details to the array
            $operationDetails += [PSCustomObject]@{
                "File" = $file.ServerRelativeUrl
                "Operation" = "Deleted all versions"
                "Timestamp" = Get-Date
            }
        } else {
            Write-Host -ForegroundColor DarkGray "No versions to delete for file: $($file.ServerRelativeUrl)"
        }
    } catch {
        Write-Host -ForegroundColor Red "Error processing file: $($file.ServerRelativeUrl) - $_"

        # Add error details to the array
        $operationDetails += [PSCustomObject]@{
            "File" = $file.ServerRelativeUrl
            "Operation" = "Error"
            "ErrorMessage" = $_.Exception.Message
            "Timestamp" = Get-Date
        }
    }
}

# Export operation details to CSV file
$operationDetails | Export-Csv -Path $csvFilePath -NoTypeInformation -Encoding UTF8

# Disconnect from SharePoint Online site
Disconnect-PnPOnline