@pnp/cli-microsoft365 7.0.0-beta.a9cf617 → 7.0.0-beta.b2eab57

package/docs/docs/cmd/pp/solution/solution-publisher-remove.mdx

@@ -13,7 +13,7 @@ m365 pp solution publisher remove [options]
 ## Options
 
 ```md definition-list
-`-e, --environment <environment>`
+`-e, --environmentName <environmentName>`
 : The name of the environment.
 
 `-i, --id [id]`
@@ -25,7 +25,7 @@ m365 pp solution publisher remove [options]
 `--asAdmin`
 : Run the command as admin for environments you do not have explicitly assigned permissions to.
 
-`--confirm`
+`-f, --force`
 : Don't prompt for confirmation
 ```
 
@@ -36,25 +36,25 @@ m365 pp solution publisher remove [options]
 Removes the specified publisher based on the name parameter
 
 ```sh
-m365 pp solution publisher remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name "Publisher Name"
+m365 pp solution publisher remove --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name "Publisher Name"
 ```
 
 Removes the specified publisher based on the name parameter without confirmation
 
 ```sh
-m365 pp solution publisher remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name "Publisher Name" --confirm
+m365 pp solution publisher remove --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name "Publisher Name" --force
 ```
 
 Removes the specified publisher based on the name parameter as admin
 
 ```sh
-m365 pp solution publisher remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name "Publisher Name" --asAdmin
+m365 pp solution publisher remove --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name "Publisher Name" --asAdmin
 ```
 
 Removes the specified publisher owned by the currently signed-in user based on the id parameter
 
 ```sh
-m365 pp solution publisher remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 00000001-0000-0000-0001-00000000009b
+m365 pp solution publisher remove --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 00000001-0000-0000-0001-00000000009b
 ```
 
 ## Response

package/docs/docs/cmd/pp/solution/solution-remove.mdx

@@ -13,7 +13,7 @@ m365 pp solution remove [options]
 ## Options
 
 ```md definition-list
-`-e, --environment <environment>`
+`-e, --environmentName <environmentName>`
 : The name of the environment.
 
 `-i, --id [id]`
@@ -25,7 +25,7 @@ m365 pp solution remove [options]
 `--asAdmin`
 : Run the command as admin for environments you do not have explicitly assigned permissions to.
 
-`--confirm`
+`-f, --force`
 : Don't prompt for confirmation
 ```
 
@@ -36,49 +36,49 @@ m365 pp solution remove [options]
 Removes the specified solution with a specific name, owned by the currently signed-in user
 
 ```sh
-m365 pp solution remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name "Solution Name"
+m365 pp solution remove --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name "Solution Name"
 ```
 
 Removes the specified solution owned by the currently signed-in user based on the name parameter without confirmation
 
 ```sh
-m365 pp solution remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name "Solution Name" --confirm
+m365 pp solution remove --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name "Solution Name" --force
 ```
 
 Removes the specified solution owned by another user based on the name parameter
 
 ```sh
-m365 pp solution remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name "Solution Name" --asAdmin
+m365 pp solution remove --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name "Solution Name" --asAdmin
 ```
 
 Removes the specified solution owned by another user based on the name parameter without confirmation
 
 ```sh
-m365 pp solution remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name "solution Name" --asAdmin --confirm
+m365 pp solution remove --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name "solution Name" --asAdmin --force
 ```
 
 Removes the specified solution owned by the currently signed-in user based on the id parameter
 
 ```sh
-m365 pp solution remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 00000001-0000-0000-0001-00000000009b
+m365 pp solution remove --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 00000001-0000-0000-0001-00000000009b
 ```
 
 Removes the specified solution owned by the currently signed-in user based on the id parameter without confirmation
 
 ```sh
-m365 pp solution remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 00000001-0000-0000-0001-00000000009b --confirm
+m365 pp solution remove --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 00000001-0000-0000-0001-00000000009b --force
 ```
 
 Removes the specified solution owned by another user based on the id parameter
 
 ```sh
-m365 pp solution remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 00000001-0000-0000-0001-00000000009b --asAdmin
+m365 pp solution remove --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 00000001-0000-0000-0001-00000000009b --asAdmin
 ```
 
 Removes the specified solution owned by another user based on the id parameter without confirmation
 
 ```sh
-m365 pp solution remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 00000001-0000-0000-0001-00000000009b --asAdmin --confirm
+m365 pp solution remove --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 00000001-0000-0000-0001-00000000009b --asAdmin --force
 ```
 
 ## Response

package/docs/docs/cmd/purview/retentionevent/retentionevent-remove.mdx

@@ -16,7 +16,7 @@ m365 purview retentionevent remove [options]
 `-i, --id <id>`
 : The Id of the retention event.
 
-`--confirm`
+`-f, --force`
 : Don't prompt for confirmation to remove the retention event.
 ```
 

package/docs/docs/cmd/purview/retentioneventtype/retentioneventtype-remove.mdx

@@ -16,7 +16,7 @@ m365 purview retentioneventtype remove [options]
 `-i, --id <id>`
 : The Id of the retention event type.
 
-`--confirm`
+`-f, --force`
 : Don't prompt for confirmation to remove the retention event type.
 ```
 

package/docs/docs/cmd/purview/retentionlabel/retentionlabel-remove.mdx

@@ -16,7 +16,7 @@ m365 purview retentionlabel remove [options]
 `-i, --id <id>`
 : The Id of the retention label.
 
-`--confirm`
+`-f, --force`
 : Don't prompt for confirming to remove the label.
 ```
 

package/docs/docs/cmd/search/externalconnection/externalconnection-remove.mdx

@@ -19,7 +19,7 @@ m365 search externalconnection remove [options]
 `-n, --name [name]`
 : Name of the External Connection to remove. Specify either `id` or `name`
 
-`--confirm`
+`-f, --force`
 : Don't prompt for confirming removing the connection
 ```
 
@@ -40,7 +40,7 @@ m365 search externalconnection remove --id "MyApp"
 Removes external connection with name _Test_. Will NOT prompt for confirmation before removing.
 
 ```sh
-m365 search externalconnection remove --name "Test" --confirm
+m365 search externalconnection remove --name "Test" --force
 ```
 
 ## Response

package/docs/docs/cmd/skype/report/report-activitycounts.mdx

@@ -17,7 +17,7 @@ m365 skype report activitycounts [options]
 ```md definition-list
 `-p, --period <period>`
 : The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
-`-f, --outputFile [outputFile]`
+`--outputFile [outputFile]`
 : Path to the file where the report should be stored in
 ```
 

package/docs/docs/cmd/skype/report/report-activityusercounts.mdx

@@ -18,7 +18,7 @@ m365 skype report activityusercounts [options]
 `-p, --period <period>`
 : The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
 
-`-f, --outputFile [outputFile]`
+`--outputFile [outputFile]`
 : Path to the file where the report should be stored in
 ```
 

package/docs/docs/cmd/skype/report/report-activityuserdetail.mdx

@@ -21,7 +21,7 @@ m365 skype report activityuserdetail [options]
 `-d, --date [date]`
 : The date for which you would like to view the users who performed any activity. Supported date format is YYYY-MM-DD. Specify the date or period, but not both
 
-`-f, --outputFile [outputFile]`
+`--outputFile [outputFile]`
 : Path to the file where the report should be stored in
 ```
 

package/docs/docs/cmd/spfx/project/project-externalize.mdx

@@ -14,7 +14,7 @@ m365 spfx project externalize [options]
 ## Options
 
 ```md definition-list
-`-f, --outputFile [outputFile]`
+`--outputFile [outputFile]`
 : Path to the file where the report should be stored in
 
 `-h, --help`

package/docs/docs/cmd/spfx/project/project-upgrade.mdx

@@ -27,7 +27,7 @@ m365 spfx project upgrade [options]
 `--preview`
 : Upgrade project to the latest SPFx preview version
 
-`-f, --outputFile [outputFile]`
+`--outputFile [outputFile]`
 : Path to the file where the upgrade report should be stored in. Ignored when `output` is `tour`
 ```
 

package/docs/docs/cmd/spo/app/app-remove.mdx

@@ -22,7 +22,7 @@ m365 spo app remove [options]
 `-s, --appCatalogScope [appCatalogScope]`
 : Scope of the app catalog: `tenant,sitecollection`. Default `tenant`
 
-`--confirm`
+`-f, --force`
 : Don't prompt for confirming removing the app
 ```
 
@@ -53,7 +53,7 @@ m365 spo app remove --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --appCatalogUrl ht
 Remove the specified app from the tenant app catalog located at _https://contoso.sharepoint.com/sites/apps_. Don't prompt for confirmation.
 
 ```sh
-m365 spo app remove --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --appCatalogUrl https://contoso.sharepoint.com/sites/apps --confirm
+m365 spo app remove --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --appCatalogUrl https://contoso.sharepoint.com/sites/apps --force
 ```
 
 Remove the specified app from a site collection app catalog of site _https://contoso.sharepoint.com/sites/site1_.

package/docs/docs/cmd/spo/app/app-retract.mdx

@@ -22,7 +22,7 @@ m365 spo app retract [options]
 `-s, --appCatalogScope [appCatalogScope]`
 : Scope of the app catalog: `tenant,sitecollection`. Default `tenant`
 
-`--confirm`
+`-f, --force`
 : Don't prompt for confirming retracting the app
 ```
 
@@ -53,7 +53,7 @@ m365 spo app retract --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --appCatalogUrl h
 Retract the specified app from the tenant app catalog. Try to resolve the URL of the tenant app catalog automatically. Will not prompt for confirmation before retracting the app.
 
 ```sh
-m365 spo app retract --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --confirm
+m365 spo app retract --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --force
 ```
 
 Retract the specified app from a site collection app catalog of site _https://contoso.sharepoint.com/sites/site1_.

package/docs/docs/cmd/spo/app/app-uninstall.mdx

@@ -22,7 +22,7 @@ m365 spo app uninstall [options]
 `--appCatalogScope [appCatalogScope]`
 : Scope of the app catalog: `tenant,sitecollection`. Default `tenant`
 
-`--confirm`
+`-f, --force`
 : Don't prompt for confirming uninstalling the app
 ```
 

package/docs/docs/cmd/spo/applicationcustomizer/applicationcustomizer-remove.mdx

@@ -28,7 +28,7 @@ m365 spo applicationcustomizer remove [options]
 `-s, --scope [scope]`
 : Scope of the application customizer. Allowed values: `Site`, `Web`, and `All`. Defaults to `All`.
 
-`--confirm`
+`-f, --force`
 : Don't prompt for confirming removal of the application customizer.
 ```
 
@@ -61,19 +61,19 @@ m365 spo applicationcustomizer remove --clientSideComponentId 7096cded-b83d-4eab
 Remove an application customizer by its id without prompting for confirmation
 
 ```sh
-m365 spo applicationcustomizer remove --id 14125658-a9bc-4ddf-9c75-1b5767c9a337 --webUrl https://contoso.sharepoint.com/sites/sales --confirm
+m365 spo applicationcustomizer remove --id 14125658-a9bc-4ddf-9c75-1b5767c9a337 --webUrl https://contoso.sharepoint.com/sites/sales --force
 ```
 
 Remove an application customizer from a site collection by its id without prompting for confirmation
 
 ```sh
-m365 spo applicationcustomizer remove --id 14125658-a9bc-4ddf-9c75-1b5767c9a337 --webUrl https://contoso.sharepoint.com/sites/sales --confirm --scope Site
+m365 spo applicationcustomizer remove --id 14125658-a9bc-4ddf-9c75-1b5767c9a337 --webUrl https://contoso.sharepoint.com/sites/sales --force --scope Site
 ```
 
 Remove an application customizer from a site by its id without prompting for confirmation
 
 ```sh
-m365 spo applicationcustomizer remove --id 14125658-a9bc-4ddf-9c75-1b5767c9a337 --webUrl https://contoso.sharepoint.com/sites/sales --confirm --scope Web
+m365 spo applicationcustomizer remove --id 14125658-a9bc-4ddf-9c75-1b5767c9a337 --webUrl https://contoso.sharepoint.com/sites/sales --force --scope Web
 ```
 
 ## Response

package/docs/docs/cmd/spo/cdn/cdn-origin-remove.mdx

@@ -19,7 +19,7 @@ m365 spo cdn origin remove [options]
 `-r, --origin <origin>`
 : Origin to remove from the current CDN configuration
 
-`--confirm`
+`-f, --force`
 : Don't prompt for confirming removal of a tenant property
 ```
 

package/docs/docs/cmd/spo/commandset/commandset-remove.mdx

@@ -28,7 +28,7 @@ m365 spo commandset remove [options]
 `-s, --scope [scope]`
 : Scope of the ListView Command Set. Allowed values: `Site`, `Web`, `All`. Defaults to `All`.
 
-`--confirm`
+`-f, --force`
 : Don't prompt for confirming removal of the ListView Command Set
 ```
 

package/docs/docs/cmd/spo/contenttype/contenttype-field-remove.mdx

@@ -28,13 +28,13 @@ m365 spo contenttype field remove [options]
 `-i, --contentTypeId <contentTypeId>`
 : The ID of the content type to remove the column from
 
-`-f, --fieldLinkId <fieldLinkId>`
+`--fieldLinkId <fieldLinkId>`
 : The ID of the column to remove
 
 `-c, --updateChildContentTypes`
 : Update child content types
 
-`--confirm`
+`-f, --force`
 : Don't prompt for confirming removal of a column from content type
 ```
 
@@ -45,7 +45,7 @@ m365 spo contenttype field remove [options]
 Remove column with a specific ID from a content type with a specific ID from a specific site.
 
 ```sh
-m365 spo contenttype field remove  --contentTypeId "0x0100CA0FA0F5DAEF784494B9C6020C3020A6" --fieldLinkId "880d2f46-fccb-43ca-9def-f88e722cef80" --webUrl https://contoso.sharepoint.com --confirm
+m365 spo contenttype field remove  --contentTypeId "0x0100CA0FA0F5DAEF784494B9C6020C3020A6" --fieldLinkId "880d2f46-fccb-43ca-9def-f88e722cef80" --webUrl https://contoso.sharepoint.com --force
 ```
 
 Remove column with a specific ID from a content type with a specific ID from a specific site and updating the child content types

package/docs/docs/cmd/spo/contenttype/contenttype-field-set.mdx

@@ -19,7 +19,7 @@ m365 spo contenttype field set [options]
 `-c, --contentTypeId <contentTypeId>`
 : ID of the content type on which the field reference should be set
 
-`-f, --id <id>`
+`--id <id>`
 : ID of the field to which the reference should be set
 
 `-r, --required [required]`

package/docs/docs/cmd/spo/contenttype/contenttype-remove.mdx

@@ -22,7 +22,7 @@ m365 spo contenttype remove [options]
 `-n, --name [name]`
 : The name of the content type to remove
 
-`--confirm`
+`-f, --force`
 : Don't prompt for confirming removal of the content type
 ```
 
@@ -45,11 +45,11 @@ m365 spo contenttype remove --id "0x01007926A45D687BA842B947286090B8F67D" --webU
 Remove a site content type by Name
 
 ```sh
-m365 spo contenttype remove --name "My Content Type" --webUrl https://contoso.sharepoint.com --confirm
+m365 spo contenttype remove --name "My Content Type" --webUrl https://contoso.sharepoint.com --force
 ```
 
 Remove a site content type without prompting for confirmation
 
 ```sh
-m365 spo contenttype remove --name "My Content Type" --webUrl https://contoso.sharepoint.com --confirm
+m365 spo contenttype remove --name "My Content Type" --webUrl https://contoso.sharepoint.com --force
 ```

package/docs/docs/cmd/spo/customaction/customaction-clear.mdx

@@ -19,7 +19,7 @@ m365 spo customaction clear [options]
 `-s, --scope [scope]`
 : Scope of the custom action. Allowed values `Site`, `Web`, `All`. Default `All`
 
-`--confirm`
+`-f, --force`
 : Don't prompt for confirming removing all custom actions
 ```
 
@@ -31,7 +31,7 @@ Clears all user custom actions for both site and site collection _https://contos
 Skips the confirmation prompt message.
 
 ```sh
-m365 spo customaction clear --webUrl https://contoso.sharepoint.com/sites/test --confirm
+m365 spo customaction clear --webUrl https://contoso.sharepoint.com/sites/test --force
 ```
 
 Clears all user custom actions for site _https://contoso.sharepoint.com/sites/test_. 

package/docs/docs/cmd/spo/customaction/customaction-remove.mdx

@@ -25,7 +25,7 @@ m365 spo customaction remove [options]
 `-s, --scope [scope]`
 : Scope of the custom action. Allowed values `Site`, `Web`, `All`. Default `All`
 
-`--confirm`
+`-f, --force`
 : Don't prompt for confirming removal of a user custom action
 ```
 
@@ -52,13 +52,13 @@ m365 spo customaction remove --title "YourAppCustomizer" --webUrl https://contos
 Removes user custom action with ID _058140e3-0e37-44fc-a1d3-79c487d371a3_ located in site or site collection _https://contoso.sharepoint.com/sites/test_. Skips the confirmation prompt message.
 
 ```sh
-m365 spo customaction remove --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --webUrl https://contoso.sharepoint.com/sites/test --confirm
+m365 spo customaction remove --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --webUrl https://contoso.sharepoint.com/sites/test --force
 ```
 
 Removes user custom action with Title _YourAppCustomizer_ located in site or site collection _https://contoso.sharepoint.com/sites/test_. Skips the confirmation prompt message.
 
 ```sh
-m365 spo customaction remove --title "YourAppCustomizer" --webUrl https://contoso.sharepoint.com/sites/test --confirm
+m365 spo customaction remove --title "YourAppCustomizer" --webUrl https://contoso.sharepoint.com/sites/test --force
 ```
 
 Removes user custom action with ID _058140e3-0e37-44fc-a1d3-79c487d371a3_ located in site collection _https://contoso.sharepoint.com/sites/test_

package/docs/docs/cmd/spo/eventreceiver/eventreceiver-remove.mdx

@@ -34,7 +34,7 @@ m365 spo eventreceiver remove [options]
 `-s, --scope [scope]`
 : The scope. Can be either "site" or "web". Defaults to "web". Only applicable when not specifying any of the list properties.
 
-`--confirm`
+`-f, --force`
 : Don't prompt for confirmation.
 ```
 

package/docs/docs/cmd/spo/externaluser/externaluser-list.mdx

@@ -13,7 +13,7 @@ m365 spo externaluser list [options]
 ## Options
 
 ```md definition-list
-`-f, --filter [filter]`
+`--filter [filter]`
 : Limits the results to only those users whose first name, last name or email address begins with the text in the string, using a case-insensitive comparison
 
 `-p, --pageSize [pageSize]`

package/docs/docs/cmd/spo/field/field-remove.mdx

@@ -34,7 +34,7 @@ m365 spo field remove [options]
 `-g, --group [group]`
 : Delete all fields from this group (case-sensitive). Specify id, title, or group
 
-`--confirm`
+`-f, --force`
 : Don't prompt for confirming removing the field
 ```
 

package/docs/docs/cmd/spo/file/file-add.mdx

@@ -16,8 +16,8 @@ m365 spo file add [options]
 `-u, --webUrl <webUrl>`
 : The URL of the site where the file should be uploaded to
 
-`-f, --folder <folder>`
-: The server- or site-relative URL to the folder where the file should be uploaded
+`--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

package/docs/docs/cmd/spo/file/file-checkin.mdx

@@ -16,8 +16,8 @@ m365 spo file checkin [options]
 `-u, --webUrl <webUrl>`
 : The URL of the site where the file is located
 
-`-f, --url [url]`
-: The server- or site-relative URL of the file to retrieve. Specify either `url` or `id` but not both
+`--url [url]`
+: The server- or site-relative decoded URL of the file to retrieve. Specify either `url` or `id` but not both
 
 `-i, --id [id]`
 : The UniqueId (GUID) of the file to retrieve. Specify either `url` or `id` but not both

package/docs/docs/cmd/spo/file/file-checkout-undo.mdx

@@ -16,26 +16,18 @@ m365 spo file checkout undo [options]
 `-u, --webUrl <webUrl>`
 : The URL of the site where the file is located.
 
-`-f, --fileUrl [fileUrl]`
-: The server- or site-relative URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both.
+`--fileUrl [fileUrl]`
+: The server- or site-relative decoded URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both.
 
 `-i, --fileId [fileId]`
 : The UniqueId (GUID) of the file to retrieve. Specify either `fileUrl` or `fileId` but not both.
 
-`--confirm`
+`-f, --force`
 : Don't prompt for confirmation.
 ```
 
 <Global />
 
-## Remarks
-
-:::info
-
-When specifying option `fileUrl`, make sure that the URL is decoded. If not, you will get a `File Not Found` error.
-
-:::
-
 ## Examples
 
 Discards a checked-out file with a specific ID.
@@ -47,7 +39,7 @@ m365 spo file checkout undo --webUrl https://contoso.sharepoint.com/sites/projec
 Discards a checked-out file with a specific URL without prompting for confirmation.
 
 ```sh
-m365 spo file checkout undo --webUrl https://contoso.sharepoint.com/sites/project-x --fileUrl '/sites/project-x/documents/Test1.docx' --confirm
+m365 spo file checkout undo --webUrl https://contoso.sharepoint.com/sites/project-x --fileUrl '/sites/project-x/documents/Test1.docx' --force
 ```
 
 ## Response

package/docs/docs/cmd/spo/file/file-checkout.mdx

@@ -16,8 +16,8 @@ m365 spo file checkout [options]
 `-u, --webUrl <webUrl>`
 : The URL of the site where the file is located
 
-`-f, --url [url]`
-: The server- or site-relative URL of the file to retrieve. Specify either `url` or `id` but not both
+`--url [url]`
+: The server- or site-relative decoded URL of the file to retrieve. Specify either `url` or `id` but not both
 
 `-i, --id [id]`
 : The UniqueId (GUID) of the file to retrieve. Specify either `url` or `id` but not both

package/docs/docs/cmd/spo/file/file-copy.mdx

@@ -16,11 +16,14 @@ m365 spo file copy [options]
 `-u, --webUrl <webUrl>`
 : The URL of the site where the file is located.
 
-`-s, --sourceUrl <sourceUrl>`
-: Site-relative, server-relative or absolute URL of the file.
+`-s, --sourceUrl [sourceUrl]`
+: Site-relative, server-relative or absolute decoded URL of the file. Specify either `sourceUrl` or `sourceId` but not both.
+
+`-i, --sourceId [sourceId]`
+: The Unique ID (GUID) of the file. Specify either `sourceUrl` or `sourceId` but not both.
 
 `-t, --targetUrl <targetUrl>`
-: Server-relative or absolute URL of the location.
+: Server-relative or absolute decoded URL of the location.
 
 `--newName [newName]`
 : New name of the destination file.
@@ -28,6 +31,9 @@ m365 spo file copy [options]
 `--nameConflictBehavior [nameConflictBehavior]`
 : Behavior when a document with the same name is already present at the destination. Possible values: `fail`, `replace`, `rename`. Default is `fail`.
 
+`--resetAuthorAndCreated`
+: Use this option to clear the author and created date. When not specified, the values from the source file are used.
+
 `--bypassSharedLock`
 : This indicates whether a file with a share lock can still be copied. Use this option to copy a file that is locked.
 ```
@@ -36,12 +42,6 @@ m365 spo file copy [options]
 
 ## Remarks
 
-:::info
-
-The required URLs `webUrl`, `sourceUrl` and `targetUrl` cannot be encoded. When you do so, you will get a `File Not Found` error.
-
-:::
-
 When you specify a value for `nameConflictBehavior`, consider the following:
 
 - `fail` will throw an error when the destination file already exists.
@@ -50,30 +50,34 @@ When you specify a value for `nameConflictBehavior`, consider the following:
 
 ## Examples
 
-Copy a file to a document library in another site collection with server relative URLs
+Copy a file by server-relative URL to a document library in another site collection with server relative URL
 
 ```sh
 m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourceUrl "/sites/project/Shared Documents/Document.pdf" --targetUrl "/sites/IT/Shared Documents"
 ```
 
-Copy a file to a document library in another site collection with absolute URLs
+Copy a file by site-relative URL to a document library in another site collection and clear the author and created date
 
 ```sh
-m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourceUrl "https://contoso.sharepoint.com/sites/project/Shared Documents/Document.pdf" --targetUrl "https://contoso.sharepoint.com/sites/IT/Shared Documents"
+m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourceUrl "/Shared Documents/Document.pdf" --targetUrl "/sites/IT/Shared Documents" --resetAuthorAndCreated
 ```
 
-Copy file to a document library in another site collection with a new name
+Copy file by sourceId (UniqueId) to a document library in another site collection and rename the file
 
 ```sh
-m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourceUrl "/sites/project/Shared Documents/Document.pdf" --targetUrl "/sites/IT/Shared Documents" --newName "Report.pdf"
+m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourceId "b2307a39-e878-458b-bc90-03bc578531d6" --targetUrl "/sites/IT/Shared Documents" --newName "Report.pdf"
 ```
 
-Copy file to a document library in another site collection with a new name, rename the file if it already exists
+Copy file by sourceId (UniqueId) to a document library in another site collection with a new name, rename the file if it already exists
 
 ```sh
-m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourceUrl "/sites/project/Shared Documents/Document.pdf" --targetUrl "/sites/IT/Shared Documents" --newName "Report.pdf" --nameConflictBehavior rename
+m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourceId "b2307a39-e878-458b-bc90-03bc578531d6" --targetUrl "/sites/IT/Shared Documents" --newName "Report.pdf" --nameConflictBehavior rename
 ```
 
+## Response
+
+The command won't return a response on success.
+
 ## 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](https://support.office.com/en-us/article/move-or-copy-items-from-a-sharepoint-document-library-00e2f483-4df3-46be-a861-1f5f0c1a87bc)

package/docs/docs/cmd/spo/file/file-get.mdx

@@ -19,7 +19,7 @@ m365 spo file get [options]
 : The URL of the site where the file is located
 
 `-u, --url [url]`
-: The server- or site-relative URL of the file to retrieve. Specify either `url` or `id` but not both
+: The server- or site-relative decoded URL of the file to retrieve. Specify either `url` or `id` but not both
 
 `-i, --id [id]`
 : The UniqueId (GUID) of the file to retrieve. Specify either `url` or `id` but not both