SharePoint Online：使用 PowerShell 将“是/否”复选框列添加到列表

要求：使用 PowerShell 将“是/否（复选框）”列添加到 SharePoint Online 列表。

如何在 SharePoint Online 列表中创建是/否复选框列？

SharePoint 中的“是/否”列表示布尔数据类型，它根据字段的选中或未选中状态存储“是”或“否”值。在本文中，我们将了解如何使用 PowerShell 将“是/否”复选框列添加到列表中。

要将“是/否”字段添加到 SharePoint Online 列表，请按照下列步骤操作：

1. 浏览到您的 SharePoint Online 网站并导航到要在其中添加“是/否”列的目标列表。
2. 在“列表”选项卡下，单击功能区中的“创建列”按钮。

3. 提供新列的名称，并将类型指定为“是/否复选框”。

   

4. 填写其他可选值，例如字段描述、默认值，然后单击“确定”在 SharePoint Online 列表中创建是/否复选框字段。

PowerShell 在 SharePoint Online 列表中创建“是/否”复选框列：

以下是用于将“是/否”字段添加到 Sharepoint Online 列表的 PowerShell 脚本，具体步骤如下：

• 步骤 1：连接到 SharePoint Online
• 第 2 步：获取列表
• 步骤 3：检查列表中是否已有该列
• 第 4 步：添加列

#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"

#Custom function to add column to list
Function Add-YesNoColumnToList()
{ 
    param
    (
        [Parameter(Mandatory=$true)] [string] $SiteURL,
        [Parameter(Mandatory=$true)] [string] $ListName,
        [Parameter(Mandatory=$true)] [string] $Name,
        [Parameter(Mandatory=$true)] [string] $DisplayName,
        [Parameter(Mandatory=$false)] [string] $Description=[string]::Empty,
        [Parameter(Mandatory=$false)] [string] $DefaultValue = "0"
    )

    #Generate new GUID for Field ID
    $FieldID = New-Guid

    Try {
        $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 List
        $List = $Ctx.Web.Lists.GetByTitle($ListName)
        $Ctx.Load($List)
        $Ctx.ExecuteQuery()

        #Check if the column exists in list already
        $Fields = $List.Fields
        $Ctx.Load($Fields)
        $Ctx.executeQuery()
        $NewField = $Fields | where { ($_.Internalname -eq $Name) -or ($_.Title -eq $DisplayName) }
        if($NewField -ne $NULL)  
        {
            Write-host "Column $Name already exists in the List!" -f Yellow
        }
        else
        {
            #Define XML for Field Schema
            $FieldSchema = "<Field Type='Boolean' ID='{$FieldID}' DisplayName='$DisplayName' Name='$Name' Description='$Description'><Default>$DefaultValue</Default></Field>"
            $NewField = $List.Fields.AddFieldAsXml($FieldSchema,$True,[Microsoft.SharePoint.Client.AddFieldOptions]::AddFieldInternalNameHint)
            $Ctx.ExecuteQuery()    

            Write-host "New Column Added to the List Successfully!" -ForegroundColor Green  
        }
    }
    Catch {
        write-host -f Red "Error Adding Column to List!" $_.Exception.Message
    }
} 

#Set parameter values
$SiteURL="https://crescent.sharepoint.com"
$ListName="Projects"
$Name="IsActive"
$DisplayName="Is Active"
$Description="Specify if the Project is Active"
$DefaultValue="1" #0 for No / 1 for Yes

#Call the function to add column to list
Add-YesNoColumnToList -SiteURL $SiteURL -ListName $ListName -Name $Name -DisplayName $DisplayName -Description $Description -DefaultValue $DefaultValue

PnP PowerShell 将“是/否”列添加到 SharePoint Online 列表

使用 PnP PowerShell 中的 Add-PnPField cmdlet 将“是/否”字段添加到列表中：

#Config Variables
$SiteURL = "https://Crescent.sharepoint.com/sites/marketing"
$ListName= "Projects"

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

#Add Yes/No Field to list
Add-PnPField -Type Boolean -List $ListName -DisplayName "Is Active" -InternalName "IsActive" -AddToDefaultView

同样，您可以从 XML 架构中添加“是/否”列。

#Define XML Schema for currency Field
$FieldXML= "<Field Type='Boolean' Name='IsActive' ID='$([GUID]::NewGuid())' DisplayName='Is Active' Required ='FALSE'></Field>"

#Add Currency Field to list from XML
Add-PnPFieldFromXml -FieldXml $FieldXML -List $ListName 

总之，“是/否”复选框列对于在列表中存储简单的布尔值非常有用。您可以按照本文概述的步骤轻松地将列添加到列表中。