Add webpart to page Using CSOM With PowerShell on SharePoint

In this article, you will learn how to add web part to a publishing page using CSOM with PowerShell on SharePoint 2013 / SharePoint 2016 / SharePoint online.

Steps Involved:

The following section explains the flow for adding web part to a publishing page.

  • Add the references using the Add-Type command with necessary reference paths. The necessary references are Microsoft.SharePoint.Client.dll, Microsoft.SharePoint.Client.Runtime.dll and Microsoft.SharePoint.Client.Publishing.dll.

Add-Type -Path "C:\Program Files\Common Files\microsoft shared\Web Server Extensions\15\ISAPI\Microsoft.SharePoint.Client.dll"

Add-Type -Path "C:\Program Files\Common Files\microsoft shared\Web Server Extensions\15\ISAPI\Microsoft.SharePoint.Client.Runtime.dll"

Add-Type -Path "C:\Program Files\Common Files\microsoft shared\Web Server Extensions\15\ISAPI\Microsoft.SharePoint.Client.Publishing.dll"

  • Initialize client context object with the site URL.

$siteURL = ""

$ctx = New-Object Microsoft.SharePoint.Client.ClientContext($siteURL)  

  • If you are trying to access SharePoint Online site, then you need to setup the site credentials with credentials parameter and get it set to the client context. 

# Not required for on premise site - Start

$userId = ""

$pwd = Read-Host -Prompt "Enter password" -AsSecureString  

$creds = New-Object Microsoft.SharePoint.Client.SharePointOnlineCredentials($userId, $pwd)  

$ctx.credentials = $creds   

# Not required for on premise site - End

  • If you are trying to access the SharePoint on premise site, then the credentials parameter is not required to be set to the context. But you need to run the code on the respective SharePoint server.

  • Get the page from the respective library using server relative url. Load the file and execute the query to access the page components.

# page where web part to be changed

$pageName = "TestPage1.aspx"

# Get the page to add $file = $ctx.Web.GetFileByServerRelativeUrl("/Pages/TestPage1.aspx")  

$ctx.Load($file)  

$ctx.ExecuteQuery()  

  • Check if web part already exists.

  1. From the page, we will get the web parts present.From the file object, using web part manager and personalization scope we can access the page web parts. 

  2. Load and execute the query to access the web parts. 

  3. Load the individual web parts by loading the web part property

  4. Then compare and check all the web part titles with new web part using for each loop.

# Get all the webparts Write-Host "Retrieving webparts" $wpManager = $file.GetLimitedWebPartManager([Microsoft.SharePoint.Client.WebParts.PersonalizationScope]::Shared)  

$webparts = $wpManager.Webparts