Búsqueda de sitios web

SharePoint Online: Agregar columna de persona o grupo (selector de personas) a la lista usando PowerShell

Requisito: Crear una columna de persona o grupo en la lista de SharePoint Online.

¿Cómo agregar una columna de persona o grupo a la lista en SharePoint Online?

La columna "Persona o grupo" en SharePoint Online se utiliza para obtener el valor del usuario o grupo. Este campo se puede configurar para aceptar cualquier valor del proveedor de autenticación, como el directorio activo, o se puede restringir para buscar personas de un grupo de SharePoint en particular. Los usuarios pueden ser localizados por su nombre o dirección de correo electrónico. También completa automáticamente los nombres coincidentes apropiados a partir de los valores disponibles a medida que escribe. Siga estos pasos para agregar la columna del selector de personas a la lista.

  1. Vaya a su sitio de SharePoint Online y navegue hasta la lista de destino donde desea agregar la columna Persona o Grupo.
  2. En la pestaña Lista, haga clic en el botón "Crear columna" en la cinta.

  3. Proporcione el Nombre a su nueva columna, especifique el tipo como "Persona o Grupo"

  4. Desplácese hacia abajo, complete otros valores opcionales, como la columna requerida, Único, Permitir valores múltiples, etc., y haga clic en "Aceptar" para crear un campo de Persona o Grupo en la lista de SharePoint Online.

PowerShell para crear una columna de persona o grupo para enumerar en SharePoint Online:

A continuación se explica cómo agregar un campo de persona o grupo en la lista de SharePoint mediante programación usando PowerShell:


#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"
Add-Type -Path "C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\16\ISAPI\Microsoft.SharePoint.Client.Taxonomy.dll"

#Custom function to add column to list
Function Add-PersonOrGroupColumnToList()
{ 
    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] $IsRequired = "FALSE",
        [Parameter(Mandatory=$false)] [string] $EnforceUniqueValues = "FALSE",
        [Parameter(Mandatory=$false)] [string] $SelectionMode="PeopleOnly"
    )

    #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
        {
            #Create Column in the list
            $FieldSchema = "<Field Type='User' ID='{$FieldID}' DisplayName='$DisplayName' Name='$Name' Description='$Description' Required='$IsRequired' EnforceUniqueValues='$EnforceUniqueValues' ShowField='ImnName' List='UserInfo' UserSelectionMode='$SelectionMode' />"
            $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="ProjectMembers"
$DisplayName="Project Members"
$Description="Enter the Project Team Members"
$SelectionMode="PeopleOnly" #Or PeopleAndGroups

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

¿Cómo agregar de forma masiva varias columnas a una lista desde un archivo CSV?


#Parameters
$SiteURL = "https://crescent.sharepoint.com/sites/london" 
$ListName = "Desk Allocation"
$CSVFilePath = "C:\Temp\columns.csv"

Try {
    #Connect to PnP Online
    Connect-PnPOnline -Url $SiteUrl -Interactive

    #Get Data from CSV
    $ListColumns = Import-Csv $CSVFilePath

    ForEach($Column in $ListColumns)
    {
        Add-PnPField -List $ListName -Type User -InternalName $Column.Name -DisplayName $Column.Name -AddToDefaultView
        Write-Host "Added Column '$($Column.Name)' to the List!"
    }
} 
Catch {
    Write-Host "Error:"$_.Exception.Message
 }

¿Cómo agregar un campo de selección de personas de valor múltiple?
Para agregar campos del Selector de personas con "Permitir selecciones múltiples", utilice este esquema de campo:


$FieldSchema = "<Field Type='UserMulti' ID='{$FieldID}' DisplayName='$DisplayName' Name='$Name' Description='$Description' Required='$IsRequired' EnforceUniqueValues='$EnforceUniqueValues' ShowField='ImnName' List='UserInfo' UserSelectionMode='$SelectionMode' Mult='TRUE' />"

PnP PowerShell para agregar una columna de persona o grupo a la lista de SharePoint Online 


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

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

#Define XML Schema for User Field
$FieldXML= "<Field Type='User' Name='ProjectManager' ID='$([GUID]::NewGuid())' DisplayName='Project Manager' Required ='FALSE' UserSelectionMode='PeopleOnly'></Field>"

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

De manera similar, también puede agregar una columna de grupo o de varias personas desde el esquema XML.


$FieldXML= "<Field Type='UserMulti' Name='TeamMembers' ID='$([GUID]::NewGuid())' DisplayName='Team Members' Required ='FALSE' UserSelectionMode='PeopleAndGroups' Mult='TRUE' ></Field>"

Artículos relacionados