SharePoint Online：使用 PowerShell 从文档库下载所有文件

要求：PowerShell 从 SharePoint Online 文档库下载所有文件。

如何在 SharePoint Online 中下载文档库？

文档库是 SharePoint Online 的核心组件，为用户提供存储、组织和访问文件的中心位置。但是，有时用户可能需要下载文档库的全部内容以进行备份、迁移或其他目的。如果您需要在 SharePoint Online 中下载文档库，可以采用几种不同的方法。在这篇博文中，我将向您展示如何使用 Web 浏览器、文件资源管理器和 PowerShell 从 SharePoint Online 库下载所有文件。如果您需要收集库中的所有文件用于存档或其他目的，这会很有帮助。让我们开始吧！

从 SharePoint Online 一次下载多个文件就像使用文件资源管理器复制文件一样简单（在文件资源管理器中打开库，将文档库文件夹复制粘贴到本地磁盘）。要使用 Web 浏览器从 SharePoint Online 文档库下载所有文件，请执行以下步骤：

1. 导航到您的 SharePoint 文档库 >> 选择所有文件和文件夹。

2. 单击工具栏中的“下载”按钮。这将为您提供一个 Zip 文件，其中包含文档库中的所有文件和文件夹。同样，您也可以下载文件夹。

   

请注意，此功能仅适用于现代 SharePoint Online UI，并且这些方法不会下载任何文档元数据。您至少需要“仅查看”权限级别才能从 SharePoint 下载文档。另外，值得一提的是，如果某些文件类型（例如 PDF 文件）受信息权限管理 (IRM) 保护，您可能无法下载文档。

好吧。让我们使用 PowerShell 从 SharePoint Online 文档库下载文档。

SharePoint Online：使用 PowerShell CSOM 从库下载所有文件

我们可以使用PowerShell在SharePoint Online中下载文档库。但为什么选择 PowerShell？也许是因为资源管理器视图不起作用，或者您想要自动化该过程！下面是下载文档库的SharePoint Online PowerShell：

#Load SharePoint CSOM Assemblies
Add-Type -Path "C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\ISAPI\Microsoft.SharePoint.Client.dll"
Add-Type -Path "C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\ISAPI\Microsoft.SharePoint.Client.Runtime.dll"

Function Download-FilesFromLibrary()
{ 
    param
    (
        [Parameter(Mandatory=$true)] [string] $SiteURL,
        [Parameter(Mandatory=$true)] [string] $LibraryName,
        [Parameter(Mandatory=$true)] [string] $TargetFolder
    )

    Try {
        #Setup Credentials to connect
        $Cred= Get-Credential
        $Credentials = New-Object Microsoft.SharePoint.Client.SharePointOnlineCredentials($Cred.Username, $Cred.Password)

        #Setup the context
        $Ctx = New-Object Microsoft.SharePoint.Client.ClientContext($SiteURL)
        $Ctx.Credentials = $Credentials
     
        #Get all files from the Library
        $List = $Ctx.Web.Lists.GetByTitle($LibraryName)
        $Ctx.Load($List)
        $Ctx.ExecuteQuery()
        
        #Get Files from the Folder
        $Folder = $List.RootFolder
        $FilesColl = $Folder.Files
        $Ctx.Load($FilesColl)
        $Ctx.ExecuteQuery()

        Foreach($File in $FilesColl)
        {
            $TargetFile = $TargetFolder+$File.Name
            #Download the file
            $FileInfo = [Microsoft.SharePoint.Client.File]::OpenBinaryDirect($Ctx,$File.ServerRelativeURL)
            $WriteStream = [System.IO.File]::Open($TargetFile,[System.IO.FileMode]::Create)
            $FileInfo.Stream.CopyTo($WriteStream)
            $WriteStream.Close()
        }
        Write-host -f Green "All Files from Library '$LibraryName' Downloaded to Folder '$TargetFolder' Successfully!" $_.Exception.Message
  }
    Catch {
        write-host -f Red "Error Downloading Files from Library!" $_.Exception.Message
    }
}

#Set parameter values
$SiteURL="https://crescent.sharepoint.com/sites/sales/"
$LibraryName="Documents"
$TargetFolder="C:\Documents\"

#Call the function to download file 
Download-FilesFromLibrary -SiteURL $SiteURL -LibraryName $LibraryName -TargetFolder $TargetFolder

此 PowerShell 脚本从库下载所有文件。如果您的图书馆有子文件夹怎么办？好吧，让我们更改 PowerShell 以从 SharePoint Online 下载库。

使用 PowerShell 从库下载所有文件（包括子文件夹）：

让我们使用 PowerShell 从 SharePoint Online 文档库下载文件，包括所有子文件夹中的所有文件。

#Load SharePoint CSOM Assemblies
Add-Type -Path "C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\ISAPI\Microsoft.SharePoint.Client.dll"
Add-Type -Path "C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\ISAPI\Microsoft.SharePoint.Client.Runtime.dll"

Function Download-AllFilesFromLibrary()
{ 
    param
    (
        [Parameter(Mandatory=$true)] [string] $SiteURL,
        [Parameter(Mandatory=$true)] [Microsoft.SharePoint.Client.Folder] $SourceFolder,
        [Parameter(Mandatory=$true)] [string] $TargetFolder
    )
    Try {
        
        #Create Local Folder, if it doesn't exist
        $FolderName = ($SourceFolder.ServerRelativeURL) -replace "/","\"
        $LocalFolder = $TargetFolder + $FolderName
        If (!(Test-Path -Path $LocalFolder)) {
                New-Item -ItemType Directory -Path $LocalFolder | Out-Null
        }
        
        #Get all Files from the folder
        $FilesColl = $SourceFolder.Files
        $Ctx.Load($FilesColl)
        $Ctx.ExecuteQuery()

        #Iterate through each file and download
        Foreach($File in $FilesColl)
        {
            $TargetFile = $LocalFolder+"\"+$File.Name
            #Download the file
            $FileInfo = [Microsoft.SharePoint.Client.File]::OpenBinaryDirect($Ctx,$File.ServerRelativeURL)
            $WriteStream = [System.IO.File]::Open($TargetFile,[System.IO.FileMode]::Create)
            $FileInfo.Stream.CopyTo($WriteStream)
            $WriteStream.Close()
            write-host -f Green "Downloaded File:"$TargetFile 
        }
        
        #Process Sub Folders
        $SubFolders = $SourceFolder.Folders
        $Ctx.Load($SubFolders)
        $Ctx.ExecuteQuery()
        Foreach($Folder in $SubFolders)
        {
            If($Folder.Name -ne "Forms")
            {
                #Call the function recursively
                Download-AllFilesFromLibrary -SiteURL $SiteURL -SourceFolder $Folder -TargetFolder $TargetFolder
            }
        }
  }
    Catch {
        write-host -f Red "Error Downloading Files from Library!" $_.Exception.Message
    }
}

#Set parameter values
$SiteURL="https://crescent.sharepoint.com/sites/sales/"
$LibraryName="Documents"
$TargetFolder="C:\Docs"

#Setup Credentials to connect
$Cred= Get-Credential
$Credentials = New-Object Microsoft.SharePoint.Client.SharePointOnlineCredentials($Cred.Username, $Cred.Password)

#Setup the context
$Ctx = New-Object Microsoft.SharePoint.Client.ClientContext($SiteURL)
$Ctx.Credentials = $Credentials
     
#Get the Library
$List = $Ctx.Web.Lists.GetByTitle($LibraryName)
$Ctx.Load($List)
$Ctx.Load($List.RootFolder)
$Ctx.ExecuteQuery()

#Call the function: sharepoint online download multiple files powershell
Download-AllFilesFromLibrary -SiteURL $SiteURL -SourceFolder $List.RootFolder -TargetFolder $TargetFolder

PnP PowerShell 从 SharePoint Online 下载文档库

此 PowerShell 脚本将所有文件和文件夹从文档库下载到本地目录。

#Function to Download All Files from a SharePoint Online Folder - Recursively  
Function Download-SPOFolder([Microsoft.SharePoint.Client.Folder]$Folder, $DestinationFolder)
{  
    #Get the Folder's Site Relative URL
    $FolderURL = $Folder.ServerRelativeUrl.Substring($Folder.Context.Web.ServerRelativeUrl.Length)
    $LocalFolder = $DestinationFolder + ($FolderURL -replace "/","\")
    #Create Local Folder, if it doesn't exist
    If (!(Test-Path -Path $LocalFolder)) {
            New-Item -ItemType Directory -Path $LocalFolder | Out-Null
            Write-host -f Yellow "Created a New Folder '$LocalFolder'"
    }
          
    #Get all Files from the folder
    $FilesColl = Get-PnPFolderItem -FolderSiteRelativeUrl $FolderURL -ItemType File 
    #Iterate through each file and download
    Foreach($File in $FilesColl)
    {
        Get-PnPFile -ServerRelativeUrl $File.ServerRelativeUrl -Path $LocalFolder -FileName $File.Name -AsFile -force
        Write-host -f Green "`tDownloaded File from '$($File.ServerRelativeUrl)'"
    }
    #Get Subfolders of the Folder and call the function recursively
    $SubFolders = Get-PnPFolderItem -FolderSiteRelativeUrl $FolderURL -ItemType Folder
    Foreach ($Folder in $SubFolders | Where {$_.Name -ne "Forms"})
    {
        Download-SPOFolder $Folder $DestinationFolder
    }
}  

#Set Parameters
$SiteURL = "https://crescent.sharepoint.com"
$LibraryURL = "/Shared Documents" #Site Relative URL
$DownloadPath ="C:\Temp\Docs\"

#Connect to PnP Online
Connect-PnPOnline -Url $SiteURL -Credentials (Get-Credential)  

#Get The Root folder of the Library
$Folder = Get-PnPFolder -Url $LibraryURL

#Call the function to download the document library
Download-SPOFolder $Folder $DownloadPath

PnP PowerShell 下载更大的文档库

截至目前，Get-PnPFolderItem cmdlet 无法处理包含超过 5000 个项目的库，并最终显示“禁止尝试操作，因为它超出了列表视图阈值”。错误 - 这是从更大的文档库下载所有文件和文件夹的替代方法。

#Parameters
$SiteURL = "https://crescent.sharepoint.com/sites/marketing"
$ListName = "Branding"
$DownloadPath ="C:\Temp\NewDocs"

#Connect to SharePoint Online
Connect-PnPOnline $SiteURL -Interactive
$Web = Get-PnPWeb

#Get the list
$List = Get-PnPList -Identity $ListName

#Get all Items from the Library - with progress bar
$global:counter = 0
$ListItems = Get-PnPListItem -List $ListName -PageSize 500 -Fields ID -ScriptBlock { Param($items) $global:counter += $items.Count; Write-Progress -PercentComplete `
            ($global:Counter / ($List.ItemCount) * 100) -Activity "Getting Items from List:" -Status "Processing Items $global:Counter to $($List.ItemCount)";} 
Write-Progress -Activity "Completed Retrieving Folders from List $ListName" -Completed

#Get all Subfolders of the library
$SubFolders = $ListItems | Where {$_.FileSystemObjectType -eq "Folder" -and $_.FieldValues.FileLeafRef -ne "Forms"}
$SubFolders | ForEach-Object {
    #Ensure All Folders in the Local Path
    $LocalFolder = $DownloadPath + ($_.FieldValues.FileRef.Substring($Web.ServerRelativeUrl.Length)) -replace "/","\"
    #Create Local Folder, if it doesn't exist
    If (!(Test-Path -Path $LocalFolder)) {
            New-Item -ItemType Directory -Path $LocalFolder | Out-Null
    }
    Write-host -f Yellow "Ensured Folder '$LocalFolder'"
}

#Get all Files from the folder
$FilesColl =  $ListItems | Where {$_.FileSystemObjectType -eq "File"}

#Iterate through each file and download
$FilesColl | ForEach-Object {
    $FileDownloadPath = ($DownloadPath + ($_.FieldValues.FileRef.Substring($Web.ServerRelativeUrl.Length)) -replace "/","\").Replace($_.FieldValues.FileLeafRef,'')
    Get-PnPFile -ServerRelativeUrl $_.FieldValues.FileRef -Path $FileDownloadPath -FileName $_.FieldValues.FileLeafRef -AsFile -force
    Write-host -f Green "Downloaded File from '$($_.FieldValues.FileRef)'"
}

从 SharePoint Online 下载文档库的替代方法

要将文件从 SharePoint Online 复制到本地文件夹，请使用以下 PowerShell 脚本：

#Set Parameters
$TenantSiteURL = "https://crescent.sharepoint.com"
$SiteRelativeURL = "/sites/marketing"
$LibraryName = "Project Documents"
$DownloadPath ="C:\Temp\Docs"

#Connect to PnP Online as Virtual Drive "SPO:\"
Connect-PnPOnline -Url $TenantSiteURL -CreateDrive -Credentials (Get-Credential)

#Change the Path and navigate to the source site
Set-Location -Path SPO:$SiteRelativeURL

#Download Document Library to Local Drive
Copy-PnpItemProxy -Recurse -Force $LibraryName $DownloadPath

结论

总之，从 SharePoint Online 下载文档库是一个简单的过程，可以使用多种方法来完成。无论您是经验丰富的 SharePoint 专业人士还是新手用户，您都可以选择本机 SharePoint Web 浏览器界面、资源管理器视图或 PowerShell 脚本。通过遵循本指南中概述的步骤，您可以轻松地从 SharePoint Online 下载文档库。这将确保您的重要文件得到备份并在您需要时可以访问。

我可以下载网站上所有库中的所有文件吗？当然，您可以迭代所有文档库并调用该函数，也可以使用此方法：如何使用 PowerShell 从 SharePoint Online 站点下载所有文件？

经常问的问题：

如何从 SharePoint Online 列表下载所有附件？

使用“映射网络驱动器”或“文件资源管理器”功能从 SharePoint 列表下载附件。您还可以使用 PowerShell 从 SharePoint Online 列表下载所有附件。
更多信息：从 SharePoint Online 列表下载附件

如何阻止SharePoint文档库中的下载？

授予用户“受限查看”权限以阻止 SharePoint Online 文档库的下载选项。
详细信息：SharePoint Online 中的文档阻止下载选项

如何将库从一个 SharePoint 网站复制到另一个网站？

您可以使用 SharePoint Online 中的“复制到”功能将所有文件从一个文档库复制到另一个文档库。 PowerShell 还可用于在 SharePoint Online 站点之间复制库。
详细信息：SharePoint Online 将文档库复制到另一个站点

如何在 SharePoint Online 中复制文档库？

您可以将源文档库另存为模板，然后从保存的模板创建新文档库以制作文档库的副本。然后根据需要将所有文件和文件夹从源复制到目标库。 PowerShell 脚本可以帮助您自动执行这些任务。
更多信息：SharePoint Online 复制文档库

如何从 SharePoint Online 下载文件夹？

要从 SharePoint Online 下载文件夹，请导航到要下载的文件夹，然后单击工具栏中的“下载”按钮。这会将整个文件夹及其内容下载为压缩 ZIP 文件。然后，您可以从本地计算机上的 ZIP 文件中提取文件。还可以使用 PowerShell 从 SharePoint Online 下载文件夹！如何从 SharePoint Online 下载文件夹？