spo file add
Uploads file to the specified folder
Usage
m365 spo file add [options]
Options
-u, --webUrl <webUrl>
The URL of the site where the file should be uploaded to
--folder <folder>
The server- or site-relative decoded URL to the folder where the file should be uploaded
-p, --path <path>
Local path to the file to upload
-c, --contentType [contentType]
Content type name or ID to assign to the file
--checkOut [checkOut]
If versioning is enabled, this will check out the file first if it exists, upload the file, then check it in again
--checkInComment [checkInComment]
Comment to set when checking the file in
--approve [approve]
Will automatically approve the uploaded file
--approveComment [approveComment]
Comment to set when approving the file
--publish [publish]
Will automatically publish the uploaded file
--publishComment [publishComment]
Comment to set when publishing the file
-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 isoptions
.--query [query]
JMESPath query string. See http://jmespath.org/ for more information and examples.
-o, --output [output]
Output type.
json
,text
,csv
,md
,none
. Defaultjson
.--verbose
Runs command with verbose logging.
--debug
Runs command with debug logging.
Remarks
This command allows using unknown properties. Each property corresponds to the list item field that should be set when uploading the file.
Examples
Adds file MS365.jpg to site https://contoso.sharepoint.com/sites/project-x in folder Shared Documents
m365 spo file add --webUrl https://contoso.sharepoint.com/sites/project-x --folder 'Shared Documents' --path 'C:\MS365.jpg'
Adds file MS365.jpg to site https://contoso.sharepoint.com/sites/project-x in sub folder Shared Documents/Sub Folder 1
m365 spo file add --webUrl https://contoso.sharepoint.com/sites/project-x --folder 'Shared Documents/Sub Folder 1' --path 'C:\MS365.jpg'
Adds file MS365.jpg to site https://contoso.sharepoint.com/sites/project-x in folder Shared Documents specifying server-relative folder url
m365 spo file add --webUrl https://contoso.sharepoint.com/sites/project-x --folder '/sites/project-x/Shared Documents' --path 'C:\MS365.jpg'
Adds file MS365.jpg to site https://contoso.sharepoint.com/sites/project-x in folder Shared Documents with specified content type
m365 spo file add --webUrl https://contoso.sharepoint.com/sites/project-x --folder 'Shared Documents' --path 'C:\MS365.jpg' --contentType 'Picture'
Adds file MS365.jpg to site https://contoso.sharepoint.com/sites/project-x in folder Shared Documents, but checks out existing file before the upload
m365 spo file add --webUrl https://contoso.sharepoint.com/sites/project-x --folder 'Shared Documents' --path 'C:\MS365.jpg' --checkOut --checkInComment 'check in comment x'
Adds file MS365.jpg to site https://contoso.sharepoint.com/sites/project-x in folder Shared Documents and approves it (when list moderation is enabled)
m365 spo file add --webUrl https://contoso.sharepoint.com/sites/project-x --folder 'Shared Documents' --path 'C:\MS365.jpg' --approve --approveComment 'approve comment x'
Adds file MS365.jpg to site https://contoso.sharepoint.com/sites/project-x in folder Shared Documents and publishes it
m365 spo file add --webUrl https://contoso.sharepoint.com/sites/project-x --folder 'Shared Documents' --path 'C:\MS365.jpg' --publish --publishComment 'publish comment x'
Adds file MS365.jpg to site https://contoso.sharepoint.com/sites/project-x in folder Shared Documents and changes single text field value of the list item
m365 spo file add --webUrl https://contoso.sharepoint.com/sites/project-x --folder 'Shared Documents' --path 'C:\MS365.jpg' --Title "New Title"
Adds file MS365.jpg to site https://contoso.sharepoint.com/sites/project-x in folder Shared Documents and changes person/group field and DateTime field values
m365 spo file add --webUrl https://contoso.sharepoint.com/sites/project-x --folder 'Shared Documents' --path 'C:\MS365.jpg' --Editor "[{'Key':'i:0#.f|membership|john.smith@contoso.com'}]" --Modified '6/23/2018 10:15 PM'
Adds file MS365.jpg to site https://contoso.sharepoint.com/sites/project-x in folder Shared Documents and changes hyperlink or picture field
m365 spo file add --webUrl https://contoso.sharepoint.com/sites/project-x --folder 'Shared Documents' --path 'C:\MS365.jpg' --URL 'https://contoso.com, Contoso'
Adds file MS365.jpg to site https://contoso.sharepoint.com/sites/project-x in folder Shared Documents and changes taxonomy field
m365 spo file add --webUrl https://contoso.sharepoint.com/sites/project-x --folder 'Shared Documents' --path 'C:\MS365.jpg' --Topic "HR services|c17baaeb-67cd-4378-9389-9d97a945c701"
Adds file MS365.jpg to site https://contoso.sharepoint.com/sites/project-x in folder Shared Documents and changes taxonomy multi-value field
m365 spo file add --webUrl https://contoso.sharepoint.com/sites/project-x --folder 'Shared Documents' --path 'C:\MS365.jpg' --Topic "HR services|c17baaeb-67cd-4378-9389-9d97a945c701;Inclusion & Diversity|66a67671-ed89-44a7-9be4-e80c06b41f35"
Adds file MS365.jpg to site https://contoso.sharepoint.com/sites/project-x in folder Shared Documents and changes choice field and multi-choice field
m365 spo file add --webUrl https://contoso.sharepoint.com/sites/project-x --folder 'Shared Documents' --path 'C:\MS365.jpg' --ChoiceField1 'Option3' --MultiChoiceField1 'Option2;#Option3'
Adds file MS365.jpg to site https://contoso.sharepoint.com/sites/project-x in folder Shared Documents and changes person/group field that allows multi-user selection
m365 spo file add --webUrl https://contoso.sharepoint.com/sites/project-x --folder 'Shared Documents' --path 'C:\MS365.jpg' --AllowedUsers "[{'Key':'i:0#.f|membership|john.smith@contoso.com'},{'Key':'i:0#.f|membership|velin.georgiev@contoso.com'}]"
Adds file MS365.jpg to site https://contoso.sharepoint.com/sites/project-x in folder Shared Documents and changes yes/no field
m365 spo file add --webUrl https://contoso.sharepoint.com/sites/project-x --folder 'Shared Documents' --path 'C:\MS365.jpg' --HasCar true
Adds file MS365.jpg to site https://contoso.sharepoint.com/sites/project-x in folder Shared Documents and changes number field and currency field
m365 spo file add --webUrl https://contoso.sharepoint.com/sites/project-x --folder 'Shared Documents' --path 'C:\MS365.jpg' --NumberField 100 --CurrencyField 20
Adds file MS365.jpg to site https://contoso.sharepoint.com/sites/project-x in folder Shared Documents and changes lookup field and multi-lookup field
m365 spo file add --webUrl https://contoso.sharepoint.com/sites/project-x --folder 'Shared Documents' --path 'C:\MS365.jpg' --LookupField 1 --MultiLookupField "2;#;#3;#;#4;#"
More information
- Update file metadata with REST API using ValidateUpdateListItem method: https://robertschouten.com/2018/04/30/update-file-metadata-with-rest-api-using-validateupdatelistitem-method/
- List Items System Update options in SharePoint Online: https://www.linkedin.com/pulse/list-items-system-update-options-sharepoint-online-andrew-koltyakov/