SharePoint Online：使用 PowerShell 更改列表或库 URL

要求：使用 PowerShell 更改 SharePoint Online 中列表或文档库的 URL。

如何更改 SharePoint Online 中的列表 URL？

在 SharePoint Online 中，当您创建列表时，会自动生成该列表的 URL。此 URL 可用于链接或与其他人共享该列表。但是，您可能因不同原因需要更改 URL，例如重命名列表或使用不同的名称。本文将向您展示如何使用 PowerShell 更改 SharePoint Online 列表 URL。

如何更改 SharePoint Online 列表的 URL？因为重命名列表标题不会更改其 URL！但是，要更改 SharePoint Online 中的列表或库 URL，我们可以使用文件资源管理器视图、SharePoint Designer 或 PowerShell！要使用“浏览”视图更改文档库 URL：

1. 在“文件浏览视图”（或 Windows 资源管理器视图！）中打开文档库。
2. 在资源管理器中向上导航一级 >> 选择要重命名的文档库。

3. 按“F2”（或右键单击并选择“重命名”）>> 输入文档库的新名称>> 按“Enter”。

   

我的另一篇有关 SharePoint 本地部署的文章中解释了如何使用浏览视图和 SharePoint Designer 更改 SharePoint 列表的 URL。它也适用于 SharePoint Online：如何更改 SharePoint 中列表或文档库的 URL？因此，在这里，我们使用 PowerShell 更改 SharePoint Online 中的列表 URL。

SharePoint Online：使用 PowerShell 更改列表 URL

如何更改 SharePoint Online 中文档库的 URL？好吧，让我们使用 PowerShell 将 SharePoint Online 文档库的 URL 从“Project%20Documentation”更改为“ProjectDocs”。 要更改列表的 URL，我们必须调用“Rootfolder.MoveTo( )” 函数与新 URL。

#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"
   
#Config Parameters
$SiteURL= "https://crescent.sharepoint.com"
$ListName="Project Documentation"
$NewListURL="ProjectDocs"

#Setup Credentials to connect
$Cred = Get-Credential
$Cred = New-Object Microsoft.SharePoint.Client.SharePointOnlineCredentials($Cred.UserName,$Cred.Password)
  
Try {
    #Setup the context
    $Ctx = New-Object Microsoft.SharePoint.Client.ClientContext($SiteURL)
    $Ctx.Credentials = $Cred
    
    #Get the List
    $List=$Ctx.web.Lists.GetByTitle($ListName)
    $Ctx.Load($List)
 
    #sharepoint online change library url powershell   
    $List.Rootfolder.MoveTo($NewListURL)
    $Ctx.ExecuteQuery()

    #Keep the List name as is
    $List.Title=$ListName 
    $List.Update()
    $Ctx.ExecuteQuery()
 
    Write-host -f Green "List URL has been changed!"
}
Catch {
    write-host -f Red "Error changing List URL!" $_.Exception.Message
}

这会更改给定列表或文档库的 URL！我们还使用 PnP PowerShell 通过几行脚本更改了 SharePoint Online 中的列表 URL。

使用 PnP PowerShell 重命名文档库 URL

让我们使用 PnP PowerShell 更改 SharePoint Online 中的文档库 URL：

#Set Parameters
$SiteURL = "https://crescent.sharepoint.com/sites/p/"
$ListName = "Shared Documents"
$NewListURL = "documents"
 
#Connect to PnP Online
Connect-PnPOnline -Url $SiteURL -Interactive

#Get the List
$List= Get-PnPList -Identity $ListName -Includes RootFolder

#sharepoint online powershell change list url
$List.Rootfolder.MoveTo($NewListURL)
Invoke-PnPQuery

这会将给定列表或文档库的根文件夹移动到新的 URL。通过遵循本文中提供的脚本，您可以轻松更改 SharePoint Online 中列表或库的 URL。请记住，现有列表的 URL 更改可能会破坏共享的链接、工作流程可能会失败、网站自定义和自定义解决方案可能无法按预期工作。如果您只想更改列表标题而不是列表 URL，请参阅：SharePoint Online：如何使用 PowerShell 重命名列表？

经常问的问题：

如何更改 SharePoint Online 中的网站 URL？

要更改 SharePoint 网站 URL，请登录到新式 SharePoint 管理中心 >> 点击“活动网站”>> 选择要重命名的网站集并打开其属性窗格。单击网站 URL 旁边的“编辑”链接，提供新 URL，然后单击“保存”按钮以更改网站集 URL。
详细信息：更改 SharePoint Online 网站 URL

如何将文档库设为 SharePoint Online 中的主页？

创建一个新的网站页面，向其中添加文档库 Web 部件，然后通过转到网站内容 >> 网站页面 >> 选择页面并单击工具栏中的“制作主页”将该页面设置为主页。您还可以使用 PowerShell 将文档库设置为主页。
更多信息：将文档库设置为 SharePoint 在线网站的主页