@pnp/cli-microsoft365 7.0.0-beta.68fea7b → 7.0.0-beta.6fa2bd1

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

@@ -13,7 +13,7 @@ m365 pp solution publisher add [options]
 ## Options
 
 ```md definition-list
-`-e, --environment <environment>`
+`-e, --environmentName <environmentName>`
 : The name of the environment.
 
 `-n, --name <name>`
@@ -39,13 +39,13 @@ m365 pp solution publisher add [options]
 Add a specific publisher in a specific environment
 
 ```sh
-m365 pp solution publisher add --environment "Default-d87a7535-dd31-4437-bfe1-95340acd55c5" --name "Contoso" --displayName "Contoso" --prefix "new" --choiceValuePrefix 10000
+m365 pp solution publisher add --environmentName "Default-d87a7535-dd31-4437-bfe1-95340acd55c5" --name "Contoso" --displayName "Contoso" --prefix "new" --choiceValuePrefix 10000
 ```
 
 Adds a specific publisher in a specific environment as Admin
 
 ```sh
-m365 pp solution publisher add --environment "Default-d87a7535-dd31-4437-bfe1-95340acd55c5" --name "Contoso" --displayName "Contoso" --prefix "new" --choiceValuePrefix 10000 --asAdmin
+m365 pp solution publisher add --environmentName "Default-d87a7535-dd31-4437-bfe1-95340acd55c5" --name "Contoso" --displayName "Contoso" --prefix "new" --choiceValuePrefix 10000 --asAdmin
 ```
 
 ## Response

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

@@ -15,14 +15,14 @@ m365 pp solution publisher get [options]
 ## Options
 
 ```md definition-list
-`-e, --environment <environment>`
+`-e, --environmentName <environmentName>`
 : The name of the environment.
 
 `-i --id [id]`
-: The ID of the solution. Specify either `id` or `name` but not both.
+: The ID of the publisher. Specify either `id` or `name` but not both.
 
 `-n, --name [name]`
-: The unique name (not the display name) of the solution. Specify either `id` or `name` but not both.
+: The unique name of the publisher. Specify either `id` or `name` but not both.
 
 `--asAdmin`
 : Run the command as admin for environments you do not have explicitly assigned permissions to.
@@ -35,25 +35,25 @@ m365 pp solution publisher get [options]
 Gets a specific publisher in a specific environment based on name
 
 ```sh
-m365 pp solution publisher get --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --name "MicrosoftCorporation"
+m365 pp solution publisher get --environmentName "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --name "MicrosoftCorporation"
 ```
 
 Gets a specific publisher in a specific environment based on name as Admin
 
 ```sh
-m365 pp solution publisher get --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --name "MicrosoftCorporation" --asAdmin
+m365 pp solution publisher get --environmentName "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --name "MicrosoftCorporation" --asAdmin
 ```
 
 Gets a specific publisher in a specific environment based on id
 
 ```sh
-m365 pp solution publisher get --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --id "ee62fd63-e49e-4c09-80de-8fae1b9a427e"
+m365 pp solution publisher get --environmentName "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --id "ee62fd63-e49e-4c09-80de-8fae1b9a427e"
 ```
 
 Gets a specific publisher in a specific environment based on id as Admin
 
 ```sh
-m365 pp solution publisher get --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --id "ee62fd63-e49e-4c09-80de-8fae1b9a427e" --asAdmin
+m365 pp solution publisher get --environmentName "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --id "ee62fd63-e49e-4c09-80de-8fae1b9a427e" --asAdmin
 ```
 
 ## Response
@@ -95,7 +95,7 @@ m365 pp solution publisher get --environment "Default-2ca3eaa5-140f-4175-8261-32
   <TabItem value="Markdown">
 
   ```md
-  # pp solution publisher get --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --id "d21aab70-79e7-11dd-8874-00188b01e34f"
+  # pp solution publisher get --environmentName "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --id "d21aab70-79e7-11dd-8874-00188b01e34f"
   
   Date: 9/1/2023
 

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

@@ -15,7 +15,7 @@ m365 pp solution publisher list [options]
 ## Options
 
 ```md definition-list
-`-e, --environment <environment>`
+`-e, --environmentName <environmentName>`
 : The name of the environment
 
 `--includeMicrosoftPublishers`
@@ -32,13 +32,13 @@ m365 pp solution publisher list [options]
 List all publishers in a specific environment
 
 ```sh
-m365 pp solution publisher list --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339"
+m365 pp solution publisher list --environmentName "Default-2ca3eaa5-140f-4175-8261-3272edf9f339"
 ```
 
 List all publishers in a specific environment as Admin
 
 ```sh
-m365 pp solution publisher list --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --asAdmin
+m365 pp solution publisher list --environmentName "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --asAdmin
 ```
 
 ## Response
@@ -82,7 +82,7 @@ m365 pp solution publisher list --environment "Default-2ca3eaa5-140f-4175-8261-3
   <TabItem value="Markdown">
 
   ```md
-  # pp solution publisher list --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339"
+  # pp solution publisher list --environmentName "Default-2ca3eaa5-140f-4175-8261-3272edf9f339"
   
   Date: 9/1/2023
 

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

@@ -13,14 +13,14 @@ m365 pp solution publisher remove [options]
 ## Options
 
 ```md definition-list
-`-e, --environment <environment>`
+`-e, --environmentName <environmentName>`
 : The name of the environment.
 
 `-i, --id [id]`
-: The id of the solution. Specify either `id` or `name` but not both.
+: The id of the publisher. Specify either `id` or `name` but not both.
 
 `-n, --name [name]`
-: The name of the solution. Specify either `id` or `name` but not both.
+: The unique name of the publisher. Specify either `id` or `name` but not both.
 
 `--asAdmin`
 : Run the command as admin for environments you do not have explicitly assigned permissions to.
@@ -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" --force
+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]`
@@ -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" --force
+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 --force
+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 --force
+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 --force
+m365 pp solution remove --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 00000001-0000-0000-0001-00000000009b --asAdmin --force
 ```
 
 ## Response

package/docs/docs/cmd/spfx/project/project-github-workflow-add.mdx

@@ -0,0 +1,94 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spfx project github workflow add
+
+Adds a GitHub workflow for a SharePoint Framework project
+
+## Usage
+
+```sh
+m365 spfx project github workflow add [options]
+```
+
+## Options
+
+```md definition-list
+`-n, --name [name]`
+: Name of the workflow that will be created. If none is specified a default name will be used 'Deploy Solution ${name of sppkg file}'
+
+`-b, --branchName [branchName]`
+: Specify the branch name which should trigger the workflow on push. If none is specified a default will be used which is 'main'
+
+`-m, --manuallyTrigger`
+: When specified a manual trigger option will be added to the workflow: `workflow_dispatch`
+
+`-l, --loginMethod [loginMethod]`
+: Specify the login method used for the login action. Possible options are: `user`, `application`. Default `application`'
+
+`-s, --scope [scope]`
+: Scope of the app catalog: `tenant`, `sitecollection`. Default is `tenant`
+
+`-u, --siteUrl [siteUrl]`
+: The URL of the site collection where the solution package will be added. Required if scope is set to `sitecollection`
+
+`--skipFeatureDeployment`
+: When specified and the app supports tenant-wide deployment, deploy it to the whole tenant
+
+`--overwrite`
+: When specified the workflow will overwrite the existing .sppkg if it is already deployed in the app catalog.
+```
+
+<Global />
+
+## Remarks
+
+The `spfx project github workflow add` will create a workflow .yml file in the `.github/workflows` directory in your project. If such directory does not exist the command will automatically create it.
+
+For the `application` login method the command does not register AAD application nor create the required certificate. In order for you to proceed you will need to first obtain (create) a self-signed certificate and register a new AAD application with certificate authentication. After that in GitHub repo settings, you will need to create the following secrets:
+
+- `APP_ID` - client id of the registered AAD application
+- `CERTIFICATE_ENCODED` - application's encoded certificate
+- `CERTIFICATE_PASSWORD` - certificate password. This applies only if the certificate is encoded which is the recommended approach
+
+This use case is perfect in a production context as it does not create any dependencies on an account
+
+For the `user` login method you will need to create the following secrets in GitHub repo settings:
+
+- `ADMIN_USERNAME` - username
+- `ADMIN_PASSWORD` - password
+
+This method is perfect to test your workflow, in a dev context, for personal usage. It will not work for accounts with MFA.
+
+:::info
+
+Run this command in the SPFx solution folder.
+
+:::
+    
+## Examples
+
+Adds a GitHub workflow for a SharePoint Framework project with `application` login method triggered on push to main
+
+```sh
+m365 spfx project github workflow add 
+```
+
+Adds a GitHub workflow for a SharePoint Framework project with `user` login method triggered on push to main and when manually triggered. 
+
+```sh
+m365 spfx project github workflow add --manuallyTrigger --loginMethod "user"
+```
+
+Adds a GitHub workflow for a SharePoint Framework project with deployment to a site collection app catalog
+
+```sh
+m365 spfx project github workflow add --scope "sitecollection" --siteUrl "https://some.sharepoint.com/sites/someSite"
+```
+
+## Response
+
+The command won't return a response on success.
+
+## More information
+
+- Automate your CI/CD workflow using CLI for Microsoft 365 GitHub Actions: [https://pnp.github.io/cli-microsoft365/user-guide/github-actions](https://pnp.github.io/cli-microsoft365/user-guide/github-actions)

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

@@ -35,7 +35,7 @@ m365 spfx project upgrade [options]
 
 ## Remarks
 
-The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.17.4).
+The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.18.0).
 
 This command doesn't change your project files. Instead, it gives you a report with all steps necessary to upgrade your project to the specified version of the SharePoint Framework. Changing project files is error-prone, especially when it comes to updating your solution's code. This is why at this moment, this command produces a report that you can use yourself to perform the necessary updates and verify that everything is working as expected.
 

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

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

@@ -17,7 +17,7 @@ m365 spo file checkin [options]
 : The URL of the site where the file is located
 
 `--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

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

@@ -17,7 +17,7 @@ m365 spo file checkout undo [options]
 : The URL of the site where the file is located.
 
 `--fileUrl [fileUrl]`
-: The server- or site-relative URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both.
+: 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.
@@ -28,14 +28,6 @@ m365 spo file checkout undo [options]
 
 <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.

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

@@ -17,7 +17,7 @@ m365 spo file checkout [options]
 : The URL of the site where the file is located
 
 `--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

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

@@ -15,11 +15,11 @@ m365 spo file get [options]
 ## Options
 
 ```md definition-list
-`-w, --webUrl <webUrl>`
+`-u, --webUrl <webUrl>`
 : 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
+`--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-list.mdx

@@ -16,22 +16,19 @@ m365 spo file list [options]
 
 ```md definition-list
 `-u, --webUrl <webUrl>`
-: The URL of the site where the folder from which to retrieve files is located
+: The URL of the site where the folder from which to retrieve files is located.
 
 `--folderUrl <folderUrl>`
-: The server- or site-relative URL of the parent folder from which to retrieve files
-
-`--folder <folder>`
-: (deprecated. Use `folderUrl` instead) The server- or site-relative URL of the folder from which to retrieve files
+: The server- or site-relative decoded URL of the parent folder from which to retrieve files.
 
 `--fields [fields]`
 : Comma-separated list of fields to retrieve. Will retrieve all fields if not specified.
 
 `--filter [filter]`
-: OData filter to use to query the list of items with
+: OData filter to use to query the list of items with.
 
 `-r, --recursive`
-: Set to retrieve files from subfolders
+: Set to retrieve files from subfolders.
 ```
 
 <Global />
@@ -134,5 +131,4 @@ m365 spo file list --webUrl https://contoso.sharepoint.com/sites/project-x --fol
   ```
 
   </TabItem>
-</Tabs>
-
+</Tabs>

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

@@ -14,53 +14,71 @@ m365 spo file move [options]
 
 ```md definition-list
 `-u, --webUrl <webUrl>`
-: The URL of the site where the file is located
+: The URL of the site where the file is located.
 
-`-s, --sourceUrl <sourceUrl>`
-: The server- or site-relative URL of the file to move
+`-s, --sourceUrl [sourceUrl]`
+: The server-, site-relative or absolute decoded URL of the file to move. Specify either `sourceUrl` or `sourceId` but not both.
+
+`-i, --sourceId [sourceId]`
+: The ID of the file to move. Specify either `sourceUrl` or `sourceId` but not both.
 
 `-t, --targetUrl <targetUrl>`
-: Server-relative URL where to move the file
+: Server-relative or absolute decoded URL where to move the file.
+
+`--newName [newName]`
+: The new name of the destination 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
+`--nameConflictBehavior [nameConflictBehavior]`
+: Behavior when a file or folder with the same name is already present at the destination. Possible values: `fail`, `replace`, `rename`. The default is `fail`.
 
-`--allowSchemaMismatch`
-: Ignores any missing fields in the target document library and moves the file anyway
+`--retainEditorAndModified`
+: Use this option to retain the editor and modified date. When not specified, these values are reset when moving to another library.
+
+`--bypassSharedLock`
+: This indicates whether a file with a share lock can still be moved. Use this option to move a file that is locked.
 ```
 
 <Global />
 
 ## Remarks
 
-When you move a file using the `spo file move` command, all of the versions are being moved.
+All file versions are retained while moving a file.
+
+When you specify a value for `nameConflictBehavior`, consider the following:
+
+- `fail` will throw an error when the destination file already exists.
+- `replace` will replace the destination file if it already exists.
+- `rename` will add a suffix (e.g. Document1.pdf) when the destination file already exists.
 
 ## Examples
 
-Move file to a document library in another site collection
+Move a file to a document library in another site collection by server relative URL
 
 ```sh
-m365 spo file move --webUrl https://contoso.sharepoint.com/sites/test1 --sourceUrl /sites/test1/Shared%20Documents/sp1.pdf --targetUrl /sites/test2/Shared%20Documents/
+m365 spo file move --webUrl https://contoso.sharepoint.com/sites/project-x --sourceUrl "/sites/project-x/Shared Documents/sp1.pdf" --targetUrl "/sites/project-y/Archived documents"
 ```
 
-Move file to a document library in the same site collection
+Move a file specified by a server-relative URL to a document library and rename it
 
 ```sh
-m365 spo file move --webUrl https://contoso.sharepoint.com/sites/test1 --sourceUrl /Shared%20Documents/sp1.pdf --targetUrl /sites/test1/HRDocuments/
+m365 spo file move --webUrl https://contoso.sharepoint.com/sites/project-x --sourceUrl "/Shared Documents/sp1.pdf" --targetUrl "/sites/project-x/My Documents" --newName Report.pdf
 ```
 
-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
+Move a file to another document library and replace a file with the same name
 
 ```sh
-m365 spo file move --webUrl https://contoso.sharepoint.com/sites/test1 --sourceUrl /Shared%20Documents/sp1.pdf --targetUrl /sites/test2/Shared%20Documents/ --deleteIfAlreadyExists
+m365 spo file move --webUrl https://contoso.sharepoint.com/sites/project-x --sourceUrl "/Shared Documents/Report project-x.pdf" --targetUrl "/sites/project-x/My Documents" --newName Report.pdf --nameConflictBehavior replace
 ```
 
-Move file to a document library in another site collection. Allow for schema mismatch
+Move a file referenced by its ID to another document library and retain editor and modified date
 
- ```sh
-m365 spo file move --webUrl https://contoso.sharepoint.com/sites/test1 --sourceUrl /sites/test1/Shared%20Documents/sp1.pdf --targetUrl /sites/test2/Shared%20Documents/ --allowSchemaMismatch
+```sh
+m365 spo file move --webUrl https://contoso.sharepoint.com/sites/project-x --sourceId b8cc341b-9c11-4f2d-aa2b-0ce9c18bcba2 --targetUrl "/sites/project-x/My Documents" --retainEditorAndModified
 ```
 
+## Response
+
+The command won't return a response on success.
 
 ## More information