spo file copy¶
Copies a file to another location
Usage¶
m365 spo file copy [options]
Options¶
-u, --webUrl <webUrl>
- The URL of the site where the file is located
-s, --sourceUrl <sourceUrl>
- Site-relative URL of the file to copy
-t, --targetUrl <targetUrl>
- Server-relative URL where to copy the file
--deleteIfAlreadyExists
- If a file already exists at the targetUrl, it will be moved to the recycle bin. If omitted, the copy operation will be canceled if the file already exists at the targetUrl location
--allowSchemaMismatch
- Ignores any missing fields in the target document library and copies the file anyway
-h, --help
- output usage information
--query [query]
- JMESPath query string. See http://jmespath.org/ for more information and examples
-o, --output [output]
- Output type.
json,text
. Defaulttext
--verbose
- Runs command with verbose logging
--debug
- Runs command with debug logging
Remarks¶
When you copy a file using the spo file copy
command, only the latest version of the file is copied.
Examples¶
Copy file to a document library in another site collection
m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/test1 --sourceUrl /Shared%20Documents/sp1.pdf --targetUrl /sites/test2/Shared%20Documents/
Copy file to a document library in the same site collection
m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/test1 --sourceUrl /Shared%20Documents/sp1.pdf --targetUrl /sites/test1/HRDocuments/
Copy 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 copy --webUrl https://contoso.sharepoint.com/sites/test1 --sourceUrl /Shared%20Documents/sp1.pdf --targetUrl /sites/test2/Shared%20Documents/ --deleteIfAlreadyExists
Copy file to a document library in another site collection. Will ignore any missing fields in the target destination and copy anyway
m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/test1 --sourceUrl /Shared%20Documents/sp1.pdf --targetUrl /sites/test2/Shared%20Documents/ --allowSchemaMismatch
More information¶
- Copy items from a SharePoint document library: https://support.office.com/en-us/article/move-or-copy-items-from-a-sharepoint-document-library-00e2f483-4df3-46be-a861-1f5f0c1a87bc