Búsqueda de sitios web

SharePoint Online: agregue la columna de casilla de verificación "Sí/No" a la lista usando PowerShell

Requisito: Agregue la columna "Sí/No (casilla de verificación)" a la lista de SharePoint Online mediante PowerShell.

¿Cómo crear una columna de casilla de verificación Sí/No en la lista de SharePoint Online?

La columna Sí/No en SharePoint representa el tipo de datos booleanos y almacena un valor Sí o No según el estado marcado o no marcado del campo. En este artículo, veremos cómo agregar una columna de casilla de verificación "Sí/No" a una lista usando PowerShell.

Para agregar el campo Sí/No a la lista de SharePoint Online, siga estos pasos:

  1. Vaya a su sitio de SharePoint Online y navegue hasta la lista de destino en la que desea agregar la columna Sí/No.
  2. En la pestaña Lista, haga clic en el botón "Crear columna" en la cinta.

  3. Proporcione el nombre de su nueva columna y especifique el tipo como "Casilla de verificación Sí/No".

  4. Complete otros valores opcionales, como la descripción del campo, el valor predeterminado y haga clic en "Aceptar" para crear un campo de casilla de verificación Sí/No en la lista de SharePoint Online.

PowerShell para crear la columna de casilla de verificación “Sí/No” en la lista de SharePoint Online:

Aquí está el script de PowerShell para agregar el campo Sí/No a una lista de Sharepoint Online, con los siguientes pasos:

  • Paso 1: conéctese a SharePoint Online
  • Paso 2: obtenga la lista
  • Paso 3: compruebe si la lista ya tiene la columna
  • Paso 4: agregue la columna

#Load SharePoint CSOM Assemblies
Add-Type -Path "C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\16\ISAPI\Microsoft.SharePoint.Client.dll"
Add-Type -Path "C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\16\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 para agregar la columna Sí/No a la lista de SharePoint Online

Utilice el cmdlet Add-PnPField en PnP PowerShell para agregar un campo Sí/No a una lista:


#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

De manera similar, puede agregar la columna Sí/No desde el esquema 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

En conclusión, la columna de la casilla de verificación “Sí/No” es útil para almacenar valores booleanos simples en una lista. Puede agregar fácilmente la columna a la lista siguiendo los pasos descritos en este artículo.

Artículos relacionados