SharePoint Online：使用 PowerShell 在列表中创建日期和时间列

如何将日期和时间列添加到 SharePoint Online 列表？

SharePoint Online 中的日期和时间列捕获日期和（可选）时间值。要将日期和时间列添加到列表中，请按照下列步骤操作：

1. 浏览到您的 SharePoint Online 网站，然后导航到要在其中创建日期和时间列的目标列表。
2. 在“列表”选项卡下，单击功能区中的“创建列”按钮。
3. 为新列提供名称，并将类型指定为“日期和时间”。

4. 填写其他可选值，然后单击“确定”以在 SharePoint Online 列表中创建日期和时间列。

   

以下是用于为 SharePoint Online 列表或库创建日期和时间列的 PowerShell 脚本。

PowerShell 在 SharePoint Online 列表中添加日期和时间字段

以下是如何使用 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"

#Custom function to add column to list
Function Add-DateTimeColumnToList()
{ 
    param
    (
        [Parameter(Mandatory=$true)] [string] $SiteURL,
        [Parameter(Mandatory=$true)] [string] $ListName,
        [Parameter(Mandatory=$true)] [string] $Name,
        [Parameter(Mandatory=$true)] [string] $DisplayName,
        [Parameter(Mandatory=$true)] [string] $Description,
        [Parameter(Mandatory=$true)] [string] $Format,
        [Parameter(Mandatory=$true)] [string] $IsRequired,
        [Parameter(Mandatory=$true)] [string] $FriendlyDisplayFormat,
        [Parameter(Mandatory=$true)] [string] $EnforceUniqueValues
    )

    #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='DateTime' ID='{$FieldID}' Name='$Name' StaticName='$Name' DisplayName='$DisplayName' Format='$Format' Required='$IsRequired'  Description='$Description' EnforceUniqueValues='$EnforceUniqueValues' FriendlyDisplayFormat='$FriendlyDisplayFormat' />"
            $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="ProjectStartDate" #Column Name
$DisplayName="Project Start Date"
$Description="Enter the Project Start Date"
$Format="DateOnly" #DateTime
$IsRequired = "FALSE"
$EnforceUniqueValues="FALSE"
$FriendlyDisplayFormat="Disabled" #Relative

#Call the function to add column to list
Add-DateTimeColumnToList -SiteURL $SiteURL -ListName $ListName -Name $Name -DisplayName $DisplayName -IsRequired $IsRequired -Format $Format -EnforceUniqueValues $EnforceUniqueValues -FriendlyDisplayFormat $FriendlyDisplayFormat -Description $Description

PnP PowerShell 将日期和时间列添加到 SharePoint Online 列表

要添加日期和时间列，您可以使用 Add-PnPField cmdlet。这是一个 PowerShell 示例：

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

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

#Add Date Time Field to list
Add-PnPField -List $ListName -Type DateTime -DisplayName "Start Date" -InternalName "StartDate" -AddToDefaultView

同样，我们可以从 XML 模式创建日期时间列：

#Define XML Schema for Date Field
$FieldXML= "<Field Type='DateTime' Name='StartDate' ID='$([GUID]::NewGuid())' DisplayName='Start Date' Required ='FALSE' Format='DateOnly' FriendlyDisplayFormat='Disabled'></Field>"

#Add DateTime Field to list
Add-PnPFieldFromXml -FieldXml $FieldXML -List $ListName

通过执行本文中概述的步骤，您可以在 SharePoint Online 中轻松创建日期和时间列来跟踪日期和时间数据。您可以使用 Web 浏览器界面和 PowerShell 将日期和时间列添加到 SharePoint Online 列表。