SharePoint Online: PowerShell to Create a Document Library
Requirement: Create a Document Library in SharePoint Online using PowerShell.
Create Document Library using PowerShell in SharePoint Online:
The document library is the most commonly used type of library in SharePoint Online used to store and collaborate Office documents such as Word, Excel, PowerPoint, etc. SharePoint Online document libraries come with default metadata properties: “Type”, “Name”, “Modified”, and “Modified By” and can be extended based on our requirements. Make sure you have the “Edit” permission level to the site where you would like to create a document library before proceeding to the following steps! Let’s see how to create a new document library in SharePoint Online.
How to Create a document library in SharePoint Online?
Document libraries are a vital part of SharePoint Online, providing an easy way to collect and share files with colleagues. To create a new document library in the SharePoint Online site, follow these steps:
- Navigate to the SharePoint Online site in the web browser >> Click on Settings gear >> Choose “Site Contents”.
- In the Site Contents page, click on the “New” menu and then choose “Document library” option. (Or from the home page of your modern site, Click on “New” button and then choose “Document Library”)
- Provide a name and description for the library. Set “Show in site navigation” Checkbox as per your requirement and then click on the “Create” button to create the new document library.
This will create a new document library, and your browser should take you there! Let’s see how to create libraries in SharePoint Online with PowerShell.
SharePoint Online: PowerShell to Create New Document Library
Alright, How to create a document library in SharePoint Online using 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"
#Variables for Processing
$SiteURL = "https://Crescent.sharepoint.com/Sites/Sales"
$LoginName ="[email protected]"
$LoginPassword ="Password"
#Get the Client Context
$Context = New-Object Microsoft.SharePoint.Client.ClientContext($SiteURL)
#supply Login Credentials
$SecurePWD = ConvertTo-SecureString $LoginPassword -asplaintext -force
$Credential = New-Object Microsoft.SharePoint.Client.SharePointOnlineCredentials($LoginName,$SecurePWD)
$Context.Credentials = $Credential
#powershell create document library sharepoint online
$ListInfo = New-Object Microsoft.SharePoint.Client.ListCreationInformation
$ListInfo.Title = "Project Docs"
$ListInfo.TemplateType = 101 #Document Library
$List = $Context.Web.Lists.Add($ListInfo)
$List.Description = "Repository to store project artifacts"
$List.Update()
$Context.ExecuteQuery()
write-host "New Document Library has been created!"
Let’s add some error handling to the above script and create a document library SharePoint Online with PowerShell.
How to Create a Document Library in SharePoint Online using PowerShell?
Document Library is a container to store any type of file in the SharePoint Online site. Here is the PowerShell for SharePoint Online to create a document library with some error handling added.
#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"
Function Create-DocumentLibrary()
{
param
(
[Parameter(Mandatory=$true)] [string] $SiteURL,
[Parameter(Mandatory=$true)] [string] $DocLibraryName
)
Try {
#Setup Credentials to connect
$Cred = Get-Credential
$Cred = New-Object Microsoft.SharePoint.Client.SharePointOnlineCredentials($Cred.UserName,$Cred.Password)
#Get All Lists from the web
$Lists = $Ctx.Web.Lists
$Ctx.Load($Lists)
$Ctx.ExecuteQuery()
#Check if Library name doesn't exists already and create document library
if(!($Lists.Title -contains $DocLibraryName))
{
#create document library in sharepoint online powershell
$ListInfo = New-Object Microsoft.SharePoint.Client.ListCreationInformation
$ListInfo.Title = $DocLibraryName
$ListInfo.TemplateType = 101 #Document Library
$List = $Ctx.Web.Lists.Add($ListInfo)
$List.Update()
$Ctx.ExecuteQuery()
write-host -f Green "New Document Library has been created!"
}
else
{
Write-Host -f Yellow "List or Library '$DocLibraryName' already exist!"
}
}
Catch {
write-host -f Red "Error Creating Document Library!" $_.Exception.Message
}
}
#Set Parameters
$SiteURL= "https://crescent.sharepoint.com"
$DocLibraryName="Project Docs"
#Call the function to create document library
Create-DocumentLibrary -siteURL $SiteURL -DocLibraryName $DocLibraryName
Use this PowerShell to create a list in SharePoint Online: How to Create a List in SharePoint Online using PowerShell?
SharePoint Online: Add a Document Library using PnP PowerShell
Use New-PnPList cmdlet to create a new document library. Here is how to create a document library in SharePoint Online using PnP PowerShell:
#Set Parameters
$SiteURL = "https://crescent.sharepoint.com/sites/marketing"
$LibraryName = "Project Documents"
#Connect to PnP Online
Connect-PnPOnline -Url $SiteURL -Credentials (Get-Credential)
#sharepoint online create document library powershell
New-PnPList -Title $LibraryName -Template DocumentLibrary -OnQuickLaunch
How about checking if a particular document library exists already, if not, create a new one? Well, We can wrap the above script into a re-usable function as:
#Function to Ensure a SharePoint Online document library
Function EnsurePnP-DocumentLibrary()
{
param
(
[Parameter(Mandatory=$true)] [string] $LibraryName
)
Try {
Write-host -f Yellow "`nEnsuring Library '$LibraryName'"
#Check if the Library exist already
$List = Get-PnPList | Where {$_.Title -eq $LibraryName}
If($List -eq $Null)
{
#Create Document Library
$List = New-PnPList -Title $LibraryName -Template DocumentLibrary -OnQuickLaunch
write-host -f Green "`tNew Document Library '$LibraryName' has been created!"
}
Else
{
Write-Host -f Magenta "`tA Document Library '$LibraryName' Already exist!"
}
}
Catch {
write-host -f Red "`tError Creating Document Library!" $_.Exception.Message
}
}
#Connect to SharePoint Online
Connect-PnPOnline "https://crescent.sharepoint.com/Sites/Marketing" -Interactive
#Call the function to Ensure Document Library
EnsurePnP-DocumentLibrary -LibraryName "Branding"
If you want to create multiple document libraries in SharePoint Online from a CSV file, use: Create Multiple Document Libraries in SharePoint Online using PowerShell
Pls Provide script to create multiple document library in SPO using powershell
You can create multiple document libraries from a CSV file! Use the link provided in the article.