spo file move

Moves a file to another location

Usage

spo file move [options]

Options

Option Description
--help output usage information
-u, --webUrl <webUrl> The URL of the site where the file is located
-s, --sourceUrl <sourceUrl> Site-relative URL of the file to move
-t, --targetUrl <targetUrl> Server-relative URL where to move the file
--deleteIfAlreadyExists If a file already exists at the targetUrl, it will be moved to the recycle bin. If omitted, the move operation will be canceled if the file already exists at the targetUrl location
--allowSchemaMismatch Ignores any missing fields in the target document library and moves the file anyway
-o, --output [output] Output type. json|text. Default text
--verbose Runs command with verbose logging
--debug Runs command with debug logging

Remarks

When you move a file using the spo file move command, all of the versions are being moved.

Examples

Move file to a document library in another site collection

spo file move --webUrl https://contoso.sharepoint.com/sites/test1 --sourceUrl /Shared%20Documents/sp1.pdf --targetUrl /sites/test2/Shared%20Documents/

Move file to a document library in the same site collection

spo file move --webUrl https://contoso.sharepoint.com/sites/test1 --sourceUrl /Shared%20Documents/sp1.pdf --targetUrl /sites/test1/HRDocuments/

Move file to a document library in another site collection. If a file with the same name already exists in the target document library, move it to the recycle bin

spo file move --webUrl https://contoso.sharepoint.com/sites/test1 --sourceUrl /Shared%20Documents/sp1.pdf --targetUrl /sites/test2/Shared%20Documents/ --deleteIfAlreadyExists

Move file to a document library in another site collection. Allow for schema mismatch

sh spo file move --webUrl https://contoso.sharepoint.com/sites/test1 --sourceUrl /Shared%20Documents/sp1.pdf --targetUrl /sites/test2/Shared%20Documents/ --allowSchemaMismatch

More information