SharePoint Online：使用 PowerShell 创建列表

要求：使用 PowerShell 在 SharePoint Online 中创建列表。

如何在 SharePoint Online 中创建列表？

SharePoint Online 列表用于存储结构化数据，就像在 Excel 电子表格或数据库表中存储数据一样。例如，您可以创建列表来跟踪任务、联系人、项目和产品。添加新的 SharePoint Online 网站时，它会根据所选网站模板附带一组默认列表和文档库（例如“文档”库）。但是，您可能需要根据要求在站点上创建其他列表和库。那么，如何在SharePoint Online中创建新列表呢？要在 SharePoint Online 中创建新列表，请执行以下步骤：

1. 浏览到 SharePoint 网站 >> 单击“设置”齿轮图标 >> 选择“网站内容”。

2. 在网站内容页面，点击新建菜单，然后选择“列表”（您也可以使用新建>>应用程序>>点击“经典体验”>>选择列表模板，例如“自定义列表”，“公告” 、“任务”等）。

   

3. 选择相关的列表模板，例如从 Excel 文件、从现有列表，或从头开始使用“空白列表”。您还可以从“问题跟踪器”、“员工入职”等可用模板中进行选择。

   

4. 提供列表的名称。例如，“项目”。
5. 如果您希望此列表显示在站点的左侧导航菜单中，请选中“在站点导航框中显示”。
6. 单击页面底部的“创建”按钮以创建列表。

这将创建一个新的自定义列表“项目”，其中包含默认的标题列，您可以根据需要添加更多不同类型数据的列，例如单行文本、日期、数字、货币等。创建列表后，您可以从列表的设置页面设置列表配置选项：必填字段、快速启动、默认视图、现代列表或经典 SharePoint 列表、附件、版本控制设置等。例如，要在列表上启用版本控制，导航到列表 >> 单击设置齿轮图标 >> 列表设置 >> 版本控制设置 >> 设置“每次编辑此列表中的项目时都创建一个版本吗？”单选按钮选择是，然后单击“确定”。创建新视图来过滤列表中的数据也有帮助！

让我们看看如何使用 PowerShell 在 SharePoint Online 中创建列表。

如何使用 PowerShell 在 SharePoint Online 中创建列表？

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"
 
#Variables for Processing
$SiteURL = "https://crescent.sharepoint.com/Sites/Projects"
$ListName="Projects"

#Get Credentials to connect
$Cred = Get-Credential

#Setup the context
$Ctx = New-Object Microsoft.SharePoint.Client.ClientContext($SiteURL)
$Ctx.Credentials = New-Object Microsoft.SharePoint.Client.SharePointOnlineCredentials($Cred.UserName,$Cred.Password)
    
#Create a custom list in sharepoint online using powershell
$ListCreationInfo = New-Object Microsoft.SharePoint.Client.ListCreationInformation
$ListCreationInfo.Title = $ListName
$ListCreationInfo.TemplateType = 100
$List = $Ctx.Web.Lists.Add($ListCreationInfo)
$List.Description = "Projects List"
$List.Update()
$Ctx.ExecuteQuery()

就是这样！您的列表已创建，现在您可以向其中添加数据。要在 SharePoint Online 中创建列表或库，您至少需要对要在其中创建列表的网站具有“编辑”权限。一个 SharePoint 网站可以有多少个列表？每个网站集最多可以创建 2,000 个列表和库（包括根网站和底层子网站）。

SharePoint Online：如何使用 PowerShell 创建列表？

SharePoint 列表是组织数据和跟踪信息的好方法。让我们向上述脚本添加一些错误处理，并在 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"
 
#Variables for Processing
$SiteURL = "https://Crescent.sharepoint.com/Sites/Sales"
$ListName="Parent Project"

#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 All Lists 
    $Lists = $Ctx.Web.Lists
    $Ctx.Load($Lists)
    $Ctx.ExecuteQuery()

    #Check if List doesn't exists already
    if(!($Lists.Title -contains $ListName))
    { 
        #sharepoint online powershell create list
        $ListInfo = New-Object Microsoft.SharePoint.Client.ListCreationInformation
        $ListInfo.Title = $ListName
        $ListInfo.TemplateType = 100 #Custom List
        $List = $Ctx.Web.Lists.Add($ListInfo)
        $List.Description = "Repository to store project artifacts"
        $List.Update()
        $Ctx.ExecuteQuery()
 
        write-host  -f Green "New List has been created!" 
    }
    else
    {
        Write-Host -f Yellow "List '$ListName' already exists!" 
    }
}
Catch {
    write-host -f Red "Error Creating List!" $_.Exception.Message
}

如何在 SharePoint 中创建任务列表？要在 SharePoint Online 中使用客户端对象模型和 PowerShell 创建新列表，只需将 TemplateType 属性值更改为 100 并运行上述代码即可。例如，要创建任务列表，请使用 TemplateType 作为 107。

$ListInfo.TemplateType = "107" #Task List

经典体验中脚本的结果：

使用 PnP PowerShell 在 SharePoint Online 中创建列表

如果您需要在 SharePoint Online 中创建列表但又不想使用基于浏览器的界面，那么 PowerShell 是您的好帮手。以下是如何在 SharePoint Online 中使用 PnP PowerShell 创建列表：

#Config Variables
$SiteURL = "https://Crescent.sharepoint.com"
$ListName = "Team Projects"
$ListURL="Lists/TeamProjects"
$Template ="GenericList"

#Get Credentials to connect
$Cred = Get-Credential

Try {
    #Connect to PnP Online
    Connect-PnPOnline -Url $SiteURL -Credentials $Cred

    #sharepoint online create list pnp powershell
    New-PnPList -Title $ListName -Url $ListURL -Template $Template -ErrorAction Stop
    Write-host "List '$ListName' Created Successfully!" -f Green
}
catch {
    write-host "Error: $($_.Exception.Message)" -foregroundcolor Red
}

此外，New-PnPList cmdlet 支持以下参数：Hidden、EnableVersioning、OnQuickLaunch、EnableContentTypes 等。

New-PnPList -Title "Config" -Template GenericList -Hidden

如果要从模板 (.stp) 创建列表，请使用：SharePoint Online：PowerShell 从模板创建列表

经常问的问题：

如何在 PowerShell 中将项目添加到 SharePoint Online 列表？

使用 PnP PowerShell cmdlet Add-PnPListItem 或 CSOM 方法“List.AddItem”在 SharePoint Online 列表中创建新项目。
详细信息：使用 PowerShell 将项目添加到 SharePoint Online 列表

如何在 SharePoint Online 中创建列表模板？

转到 SharePoint Online 列表 >> 导航到列表设置 >> 单击“将列表另存为模板”将列表另存为模板。您还可以使用“List.SaveAsTemplate”方法通过 PowerShell 在 SharePoint Online 中创建列表模板。
详细信息：在 SharePoint Online 中创建列表模板

如何从 SharePoint Online 中的另一个列表创建列表？

登录到您的 SharePoint Online 站点，单击命令栏中的“新建”按钮，然后选择“列表”。单击“从现有列表”>> 选择任何现有列表>> 为新列表提供名称，然后单击“创建”。
更多信息：如何在 SharePoint Online 中复制列表？

SharePoint 中的列表和库有什么区别？

在 SharePoint 中，列表是可以轻松组织和管理的数据集合，而库是可以存储、共享和协作的文件集合。列表通常用于管理数据，例如任务或联系人，而库则用于管理 Word 或 Excel 等文档。