Cree, lea, actualice y elimine un elemento de una lista de SharePoint Online usando PnP PowerShell

En este tutorial, le mostraré cómo crear, leer, actualizar y eliminar un elemento de una lista de SharePoint Online usando PnP PowerShell.

Esta es una operación CRUD (Crear, Leer, Actualizar, Eliminar) completa en elementos de la lista de SharePoint utilizando PnP PowerShell.

Para todos los ejemplos, usaré la siguiente lista de SharePoint denominada “ProjectTasks” con las siguientes columnas:

Título (una sola línea de texto)
Descripción (varias líneas de texto)
DueDate (Fecha y hora)
Asignado a (persona o grupo)

Puede crear esta lista de SharePoint en su sitio de SharePoint Online antes de utilizar los ejemplos siguientes. También puede crear la lista de SharePoint usando PnP PowerShell.

He creado la lista anterior y, con datos de muestra, puede ver que la lista de SharePoint Online se ve a continuación:

Cree un elemento en una lista de SharePoint usando PnP PowerShell

Primero, permítame mostrarle cómo crear un elemento en una lista de SharePoint Online usando PnP PowerShell.

Para insertar un elemento en una lista de SharePoint Online, puede utilizar el cmdlet Add-PnPListItem . A continuación se muestra la sintaxis.

Add-PnPListItem [-List] <ListPipeBind> [-ContentType <ContentTypePipeBind>] [-Values <Hashtable>]
 [-Folder <String>] [-Label <String>] [-Connection <PnPConnection>]

Aquí está el script de PowerShell completo para agregar un elemento a una lista de SharePoint Online. He utilizado la lista de SharePoint anterior.

# Connect to SharePoint Online
Connect-PnPOnline -Url "https://szg52.sharepoint.com/sites/MarketingTeam" -Interactive

# Add a new item to the ProjectTasks list
Add-PnPListItem -List "ProjectTasks" -Values @{
    Title = "Design Phase";
    Description = "Complete the design phase of the project";
    DueDate = "2025-08-01";
    AssignedTo = "henriettam@szg52.onmicrosoft.com"
}

Una vez que ejecute el script anterior y abra la lista de SharePoint Online, verá que el elemento anterior se ha agregado a la lista. Mire la captura de pantalla a continuación:

Leer Eliminar todos los elementos de una lista de SharePoint usando PnP PowerShell

Obtenga todos los elementos de la lista de SharePoint usando PnP PowerShell

Ahora, déjame mostrarte cómo leer todos los elementos de la lista de SharePoint usando PnP PowerShell.

Para obtener elementos de la lista de SharePoint mediante PnP PowerShell, puede utilizar el cmdlet Get-PnPListItem .

Aquí está el script de PowerShell completo para leer elementos de la lista "ProjectTasks" usando el cmdlet Get-PnPListItem .

# Connect to SharePoint Online
Connect-PnPOnline -Url "https://szg52.sharepoint.com/sites/MarketingTeam" -Interactive

# Retrieve all items from the ProjectTasks list
$items = Get-PnPListItem -List "ProjectTasks"
foreach ($item in $items) {
    Write-Host "Title: $($item['Title']), Description: $($item['Description']), DueDate: $($item['DueDate']), AssignedTo: $($item['AssignedTo'])"
}

Una vez que ejecute el script de PowerShell anterior, podrá ver el resultado en la captura de pantalla a continuación; obtiene todos los elementos de la lista de SharePoint.

Actualizar un elemento de la lista de SharePoint usando PnP PowerShell

Ahora, déjame mostrarte cómo actualizar un elemento de la lista de SharePoint usando PnP PowerShell.

Para actualizar un elemento en la lista "ProjectTasks", necesita el ID del elemento que desea actualizar. Luego podrá utilizar el cmdlet Set-PnPListItem .

A continuación se muestra un ejemplo en el que proporciono el ID de elemento 2 para actualizar el elemento de la lista de SharePoint.

# Connect to SharePoint Online
Connect-PnPOnline -Url "https://szg52.sharepoint.com/sites/MarketingTeam" -Interactive

# Update an item in the ProjectTasks list
Set-PnPListItem -List "ProjectTasks" -Identity 2 -Values @{
    Title = "Design Phase Updated";
    Description = "Update the design phase of the project";
    DueDate = "2025-08-15";
    AssignedTo = "johannal@szg52.onmicrosoft.com"
}

Después de ejecutar el script de PowerShell anterior usando el código VS, el elemento se actualizó, como se muestra en la captura de pantalla a continuación.

A continuación se explica cómo actualizar un elemento de la lista de SharePoint usando PnP PowerShell.

Leer ¿Agregar más de 5000 elementos a una lista de SharePoint Online usando PnP PowerShell?

Eliminar elemento de la lista de SharePoint usando PnP PowerShell

Ahora. déjame mostrarte cómo eliminar un elemento de la lista de SharePoint usando PnP PowerShell.

En PnP PowerShell, puede utilizar el cmdlet Remove-PnPListItem para eliminar un elemento de la lista de SharePoint.

Aquí está el script de PowerShell completo para eliminar un elemento de la lista "ProjectTasks" usando el cmdlet Remove-PnPListItem .

En el siguiente ejemplo, puede ver que pasé el ID del elemento como 2 y el script eliminará el elemento cuyo ID es igual a 2.

# Connect to SharePoint Online
Connect-PnPOnline -Url "https://szg52.sharepoint.com/sites/MarketingTeam" -Interactive

# Delete an item from the ProjectTasks list
Remove-PnPListItem -List "ProjectTasks" -Identity 2 -Force

Una vez que ejecute el script de PowerShell anterior, el elemento cuyo ID=2 se eliminará de la lista de SharePoint Online.

A continuación se explica cómo eliminar un elemento de una lista de SharePoint usando PnP PowerShell.

Conclusión

En este tutorial, expliqué una operación CRUD en elementos de la lista de SharePoint usando PnP PowerShell. Con varios ejemplos, he explicado las siguientes cosas: