Skip to main content

spo file move

Moves a file to another location

Usage​

m365 spo file move [options]

Options​

-u, --webUrl <webUrl>

The URL of the site where the file is located

-s, --sourceUrl <sourceUrl>

The server- or 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

-h, --help [help]

Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, response, full. Default is full.

--query [query]

JMESPath query string. See http://jmespath.org/ for more information and examples.

-o, --output [output]

Output type. json, text, csv, md. Default json.

--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

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

Move file to a document library in the same site collection

m365 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

m365 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

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

More information​