How to upload files to SharePoint with MS Graph API and PowerShell

Uploading files to OneDrive or SharePoint through the Microsoft Graph API with PowerShell

In the tutorial below I explain how you can upload files to SharePoint sites including to child directories.

There is no way in the tutorial how to do this directly with the Microsoft Graph API URLs.
I have written a cmdlet in a module for you to use.

Do you want to know how you can do this without a module?
Then you can go to the last paragraph and consult the links of the official Microsoft Graph API docs.

Install-Module Optimized.Mga.SharePoint -Scope CurrentUser

$null = Connect-Mga -ClientSecret 'XXXX' -ApplicationID 'b5954443-ad10-4d1c-8cbc-dc05268a1858' -Tenant 'bwit.onmicrosoft.com'

This time there is only one cmdlet we need: Upload-MgaSharePointFiles, to upload files..

With Upload-MgaSharePointFiles you can upload files to SharePoint sites and OneDrives. The cmdlet is embedded in the module.
It accepts the following parameter:

• TenantName
• Site
• Item / ItemPath
• ChildFolders

TenantName & Site speak for themselves. The TenantName is the ‘*.onmicrosoft.com’ address.
The Site parameter is the site name parameter where you want to upload a file.

The Item or ItemPath parameter is a bit different.
ItemPath will accept a path string to the item you want to upload to SharePoint.

When you Shift + Right click a file you can select ‘Copy as path’ as in the screenshot below. The copy as path will look like this: “C:\temp\blatemp.txt”.

Upload-MgaSharePointFiles -ItemPath "C:\temp\blatemp.txt" -TenantName 'm365x794103.onmicrosoft.com' -Site 'XXXX'

The parameter Item will accept an item of object [System.IO.FileSystemInfo]. Which means that you first use Get-Item -Path C:\temp\blatemp.txt before you start Upload-MgaSharePointFiles.

Upload-MgaSharePointFiles -Item (Get-Item "C:\temp\blatemp.txt") -TenantName 'm365x794103.onmicrosoft.com' -Site 'XXXX'

createdBy            : @{application=; user=}
createdDateTime      : 2021-12-15T17:03:27Z
eTag                 : "{1971E81D-639D-48AE-984D-36BDE03AAACF},7"
id                   : 01MIYRG5I55BYRTHLDVZEJQTJWXXQDVKWP
lastModifiedBy       : @{application=; user=}
lastModifiedDateTime : 2021-12-15T18:27:32Z
name                 : blatemp.txt

It really depends on how you want to use Upload-MgaSharePointFiles.
Do you want to bulk upload items?
I’d suggest using Get-Item / Get-ChildItem first and then use a foreach loop.

$Items = Get-ChildItem -Path 'C:\temp\'foreach ($item in $Items) {    Upload-MgaSharePointFiles -Item $item -TenantName 'XXXX' -Site 'XXXX' }

There is a ChildFolders parameter that is not mandatory.
If you do not provide ChildFolders, the root is automatically used.

The ChildFolder parameter accepts an array of subfolders.
So if you want to upload a file in a sub folder you can use the following command:

Upload-MgaSharePointFiles -Item (Get-Item "C:\temp\blatemp.txt") -TenantName 'XXXX' -Site 'XXXX' -ChildFolders 'XXXX','Personnel files','bas.wijdenes','Personal'

createdBy            : @{application=; user=}
createdDateTime      : 2021-12-15T17:03:27Z
eTag                 : "{1971E81D-639D-48AE-984D-36BDE03AAACF},7"
id                   : 01MIYRG5I55BYRTHLDVZEJQTJWXXQDVKWP
lastModifiedBy       : @{application=; user=}
lastModifiedDateTime : 2021-12-15T18:27:32Z
name                 : blatemp.txt

ChildFolders are directories in the root as in the screenshot below.

The official Microsoft Graph API docs

The following Microsoft Graph API docs are used in this tutorial:

Get a SharePoint site:
Get a SharePoint Site – Microsoft Graph beta | Microsoft Docs

Resumable file upload:
Resumable file upload – Microsoft Graph v1.0 | Microsoft Docs