@pnp/cli-microsoft365 10.0.0-beta.a4e89de → 10.0.0-beta.b184dfb

package/docs/docs/cmd/entra/user/user-recyclebinitem-list.mdx

@@ -12,12 +12,6 @@ Lists users from the recycle bin in the current tenant
 m365 entra user recyclebinitem list [options]
 ```
 
-## Alias
-
-```sh
-m365 aad user recyclebinitem list [options]
-```
-
 ## Options
 
 <Global />

package/docs/docs/cmd/entra/user/user-recyclebinitem-remove.mdx

@@ -10,12 +10,6 @@ Removes a user from the recycle bin in the current tenant
 m365 entra user recyclebinitem remove [options]
 ```
 
-## Alias
-
-```sh
-m365 aad user recyclebinitem remove [options]
-```
-
 ## Options
 
 ```md definition-list
@@ -44,13 +38,13 @@ After running this command, it may take a minute before the deleted user is effe
 
 ## Examples
 
-Removes a specific user from the recycle bin
+Removes a specific user from the recycle bin.
 
 ```sh
 m365 entra user recyclebinitem remove --id 59f80e08-24b1-41f8-8586-16765fd830d3
 ```
 
-Removes a specific user from the recycle bin without confirmation prompt
+Removes a specific user from the recycle bin without confirmation prompt.
 
 ```sh
 m365 entra user recyclebinitem remove --id 59f80e08-24b1-41f8-8586-16765fd830d3 --force

package/docs/docs/cmd/entra/user/user-recyclebinitem-restore.mdx

@@ -12,12 +12,6 @@ Restores a user from the recycle bin in the current tenant
 m365 entra user recyclebinitem restore [options]
 ```
 
-## Alias
-
-```sh
-m365 aad user recyclebinitem restore [options]
-```
-
 ## Options
 
 ```md definition-list

package/docs/docs/cmd/entra/user/user-registrationdetails-list.mdx

@@ -12,12 +12,6 @@ Retrieves a list of the authentication methods registered for users
 m365 entra user registrationdetails list [options]
 ```
 
-## Alias
-
-```sh
-m365 aad user registrationdetails list [options]
-```
-
 ## Options
 
 ```md definition-list
@@ -85,43 +79,43 @@ When multiple values are specified for `--registeredMethods` option, the command
 
 ## Examples
 
-Retrieve registration details for all users
+Retrieve registration details for all users.
 
 ```sh
 m365 entra user registrationdetails list
 ```
 
-Retrieve user registration details and returns only specific properties
+Retrieve user registration details and returns only specific properties.
 
 ```sh
 m365 entra user registrationdetails list --properties 'id,isAdmin'
 ```
 
-Retrieve registration details for admins
+Retrieve registration details for admins.
 
 ```sh
 m365 entra user registrationdetails list --isAdmin true
 ```
 
-Retrieve registration details for guest users
+Retrieve registration details for guest users.
 
 ```sh
 m365 entra user registrationdetails list --userType guest
 ```
 
-Retrieve registration details for users who selected either sms or push authentication method as the default second-factor for performing multifactor authentication
+Retrieve registration details for users who selected either sms or push authentication method as the default second-factor for performing multifactor authentication.
 
 ```sh
 m365 entra user registrationdetails list --userPreferredMethodForSecondaryAuthentication 'sms,push'
 ```
 
-Retrieve registration details for users with push authentication method as the most secure authentication method among the registered methods for second factor authentication determined by the system
+Retrieve registration details for users with push authentication method as the most secure authentication method among the registered methods for second factor authentication determined by the system.
 
 ```sh
 m365 entra user registrationdetails list --systemPreferredAuthenticationMethods push
 ```
 
-Retrieve registration details for users who have used either Microsoft Authenticator app or mobile phone during registration
+Retrieve registration details for users who have used either Microsoft Authenticator app or mobile phone during registration.
 
 ```sh
 m365 entra user registrationdetails list --methodsRegistered 'microsoftAuthenticatorPush,mobilePhone'

package/docs/docs/cmd/entra/user/user-remove.mdx

@@ -10,12 +10,6 @@ Removes a specific user
 m365 entra user remove [options]
 ```
 
-## Alias
-
-```sh
-m365 aad user remove [options]
-```
-
 ## Options
 
 ```md definition-list
@@ -53,13 +47,13 @@ After running this command, it may take a minute before the user is effectively
 
 ## Examples
 
-Removes a specific user by id
+Removes a specific user by id.
 
 ```sh
 m365 entra user remove --id a33bd401-9117-4e0e-bb7b-3f61c1539e10
 ```
 
-Removes a specific user by its UPN
+Removes a specific user by its UPN.
 
 ```sh
 m365 entra user remove --userName john.doe@contoso.com

package/docs/docs/cmd/entra/user/user-set.mdx

@@ -10,12 +10,6 @@ Updates information of the specified user
 m365 entra user set [options]
 ```
 
-## Alias
-
-```sh
-m365 aad user set [options]
-```
-
 ## Options
 
 ```md definition-list

package/docs/docs/cmd/entra/user/user-signin-list.mdx

@@ -12,12 +12,6 @@ Retrieves the Entra ID user sign-ins for the tenant
 m365 entra user signin list [options]
 ```
 
-## Alias
-
-```sh
-m365 aad user signin list [options]
-```
-
 ## Options
 
 ```md definition-list
@@ -38,55 +32,55 @@ m365 aad user signin list [options]
 
 ## Examples
 
-Get all user's sign-ins in your tenant
+Get all user's sign-ins in your tenant.
 
 ```sh
 m365 entra user signin list
 ```
 
-Get all user's sign-ins filter by given user's UPN in the tenant
+Get all user's sign-ins filter by given user's UPN in the tenant.
 
 ```sh
 m365 entra user signin list --userName 'johndoe@example.com'
 ```
 
-Get all user's sign-ins filter by given user's Id in the tenant
+Get all user's sign-ins filter by given user's Id in the tenant.
 
 ```sh
 m365 entra user signin list --userId '11111111-1111-1111-1111-111111111111'
 ```
 
-Get all user's sign-ins filter by given application display name in the tenant
+Get all user's sign-ins filter by given application display name in the tenant.
 
 ```sh
 m365 entra user signin list --appDisplayName 'Graph explorer'
 ```
 
-Get all user's sign-ins filter by given application identifier in the tenant
+Get all user's sign-ins filter by given application identifier in the tenant.
 
 ```sh
 m365 entra user signin list --appId '00000000-0000-0000-0000-000000000000'
 ```
 
-Get all user's sign-ins filter by given user's UPN and application display name in the tenant
+Get all user's sign-ins filter by given user's UPN and application display name in the tenant.
 
 ```sh
 m365 entra user signin list --userName 'johndoe@example.com' --appDisplayName 'Graph explorer'
 ```
 
-Get all user's sign-ins filter by given user's Id and application display name in the tenant
+Get all user's sign-ins filter by given user's Id and application display name in the tenant.
 
 ```sh
 m365 entra user signin list --userId '11111111-1111-1111-1111-111111111111' --appDisplayName 'Graph explorer'
 ```
 
-Get all user's sign-ins filter by given user's UPN and application identifier in the tenant
+Get all user's sign-ins filter by given user's UPN and application identifier in the tenant.
 
 ```sh
 m365 entra user signin list --userName 'johndoe@example.com' --appId '00000000-0000-0000-0000-000000000000'
 ```
 
-Get all user's sign-ins filter by given user's Id and application identifier in the tenant
+Get all user's sign-ins filter by given user's Id and application identifier in the tenant.
 
 ```sh
 m365 entra user signin list --userId '11111111-1111-1111-1111-111111111111' --appId '00000000-0000-0000-0000-000000000000'

package/docs/docs/cmd/external/item/item-add.mdx

@@ -63,13 +63,13 @@ For more information about using these options, see the Microsoft Graph API docu
 Creates an external item with simple properties that everyone is allowed to access
 
 ```sh
-m365 external item add --id "pnp-ensure-siteassets-library" --connectionId "samplesolutiongallery" --content "Ensure that the Site Assets library is created." --title "Ensure the Site Assets Library is created" --description "Ensure that the Site Assets library is created." --authors "Phil Harding" --acls "grant,everyone,everyone"
+m365 external item add --id "pnp-ensure-siteassets-library" --externalConnectionId "samplesolutiongallery" --content "Ensure that the Site Assets library is created." --title "Ensure the Site Assets Library is created" --description "Ensure that the Site Assets library is created." --authors "Phil Harding" --acls "grant,everyone,everyone"
 ```
 
 Creates an external item with multi-value properties accessible only to users from the specified Entra group
 
 ```sh
-m365 external item add --id "pnp-ensure-siteassets-library" --connectionId "samplesolutiongallery" --content "Ensure that the Site Assets library is created." --title "Ensure the Site Assets Library is created" --description "Ensure that the Site Assets library is created." --authors@odata.type "Collection(String)" --authors "Phil Harding;#Steve Smith" --acls "grant,group,Super users"
+m365 external item add --id "pnp-ensure-siteassets-library" --externalConnectionId "samplesolutiongallery" --content "Ensure that the Site Assets library is created." --title "Ensure the Site Assets Library is created" --description "Ensure that the Site Assets library is created." --authors@odata.type "Collection(String)" --authors "Phil Harding;#Steve Smith" --acls "grant,group,Super users"
 ```
 
 ## Response
@@ -123,7 +123,7 @@ m365 external item add --id "pnp-ensure-siteassets-library" --connectionId "samp
   <TabItem value="Markdown">
 
   ```md
-  # m365 external item add --id "pnp-ensure-siteassets-library" --connectionId "samplesolutiongallery" --content "Ensure that the Site Assets library is created." --title "Ensure the Site Assets Library is created" --description "Ensure that the Site Assets library is created." --authors "Phil Harding" --acls "grant,everyone,everyone"
+  # m365 external item add --id "pnp-ensure-siteassets-library" --externalConnectionId "samplesolutiongallery" --content "Ensure that the Site Assets library is created." --title "Ensure the Site Assets Library is created" --description "Ensure that the Site Assets library is created." --authors "Phil Harding" --acls "grant,everyone,everyone"
 
   Date: 2023-10-28
 

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

@@ -0,0 +1,79 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# file move
+
+Moves a file to another location using the Microsoft Graph
+
+## Usage
+
+```sh
+m365 file move [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: The URL of the site where the file is located.
+
+`-s, --sourceUrl <sourceUrl>`
+: Server-relative or absolute URL of the file.
+
+`-t, --targetUrl <targetUrl>`
+: Server-relative or absolute URL of the location.
+
+`--newName [newName]`
+: New name of the destination file.
+
+`--nameConflictBehavior [nameConflictBehavior]`
+: Behavior when a document with the same name is already present at the destination. Possible values: `fail`, `replace`, `rename`. Default is `fail`.
+```
+
+<Global />
+
+## Remarks
+
+- If the source and target locations are within the same document library or drive, the command will utilize the Move DriveItem API, preserving the version history of the file.
+- If the source and target locations are in different document libraries or drives, the command will use a copy-and-delete combination to move the file. Please note that in this case, version history will not be retained.
+
+## Examples
+
+Move a file by server-relative URL to a folder in the same document library
+
+```sh
+m365 file move --webUrl "https://contoso.sharepoint.com/sites/project" --sourceUrl "/sites/project/Shared Documents/Document.pdf" --targetUrl "/sites/project/Shared Documents/NewFolder"
+```
+
+Move a file by server-relative URL to a document library in another site collection with server relative URL
+
+```sh
+m365 file move --webUrl "https://contoso.sharepoint.com/sites/project" --sourceUrl "/sites/project/Shared Documents/Document.pdf" --targetUrl "/sites/IT/Shared Documents"
+```
+
+Move a file by absolute URL to a document library in another site collection with absolute URL
+
+```sh
+m365 file move --webUrl "https://contoso.sharepoint.com" --sourceUrl "https://contoso.sharepoint.com/Shared Documents/Document.pdf" --targetUrl "https://contoso.sharepoint.com/sites/IT/Shared Documents"
+```
+
+Move a file to a document library in another site collection and rename the file
+
+```sh
+m365 file move --webUrl "https://contoso.sharepoint.com" --sourceUrl "/Shared Documents/Document.pdf" --targetUrl "/sites/IT/Shared Documents" --newName "newName"
+```
+
+Move a file to a document library in another site collection and rename the file if a file with the same name already exists.
+
+```sh
+m365 file move --webUrl "https://contoso.sharepoint.com" --sourceUrl "/Shared Documents/Document.pdf" --targetUrl "/sites/IT/Shared Documents" --nameConflictBehavior rename
+```
+
+Move a file to Onedrive for business 
+
+```sh
+m365 file move --webUrl "https://contoso.sharepoint.com" --sourceUrl "/Shared Documents/Document.pdf" --targetUrl "https://contoso-my.sharepoint.com/personal/john_contoso_onmicrosoft_com/documents"
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/login.mdx

@@ -47,6 +47,9 @@ m365 login [options]
 
 `--connectionName [connectionName]`
 : Specify an optional name to make switching between connections easier.
+
+`--ensure`
+: Ensures that the user is signed in. if the user isn't signed in, it initiates the login flow
 ```
 
 <Global />
@@ -190,6 +193,12 @@ Log in to Microsoft 365 using a client secret.
 m365 login --authType secret --secret topSeCr3t@007
 ```
 
+Ensures that the user is signed in, initiates the login flow if the user isn't signed in
+
+```sh
+m365 login --ensure
+```
+
 ## Response
 
 <Tabs>

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.19.0).
+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.20.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/cdn/cdn-get.mdx

@@ -27,7 +27,7 @@ Using the `-t, --type` option you can choose whether you want to manage the sett
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
 

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

@@ -28,7 +28,7 @@ Using the `-t, --type` option you can choose whether you want to manage the sett
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
     

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

@@ -27,7 +27,7 @@ Using the `-t, --type` option you can choose whether you want to manage the sett
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
 

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

@@ -31,7 +31,7 @@ Using the `-t, --type` option you can choose whether you want to manage the sett
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
     

package/docs/docs/cmd/spo/cdn/cdn-policy-list.mdx

@@ -27,7 +27,7 @@ Using the `-t, --cdnType` option you can choose whether you want to manage the s
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
 

package/docs/docs/cmd/spo/cdn/cdn-policy-set.mdx

@@ -31,7 +31,7 @@ Using the `-t, --cdnType` option you can choose whether you want to manage the s
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
     

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

@@ -37,7 +37,7 @@ m365 spo externaluser list [options]
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
 

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

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo file move
 
@@ -31,21 +33,21 @@ m365 spo file move [options]
 `--nameConflictBehavior [nameConflictBehavior]`
 : Behavior when a file or folder with the same name is already present at the destination. Allowed values: `fail`, `replace`, `rename`. Defaults to `fail`.
 
-`--retainEditorAndModified`
-: Use this option to retain the editor and modified date. When not specified, these values are reset when moving to another library.
+`--includeItemPermissions`
+: Ensure that item-level permissions are preserved during the move.
 
 `--bypassSharedLock`
 : This indicates whether a file with a share lock can still be moved. Use this option to move a file that is locked.
+
+`--skipWait`
+: Don't wait for the move operation to complete.
 ```
 
 <Global />
 
 ## Remarks
 
-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.
@@ -70,16 +72,119 @@ Move a file to another document library and replace a file with the same name.
 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 a file referenced by its ID to another document library and retain editor and modified date.
+Move a file referenced by its ID to another document library and retain item-level permissions.
 
 ```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
+m365 spo file move --webUrl https://contoso.sharepoint.com/sites/project-x --sourceId b8cc341b-9c11-4f2d-aa2b-0ce9c18bcba2 --targetUrl "/sites/project-x/My Documents" --includeItemPermissions
 ```
 
 ## Response
 
-The command won't return a response on success.
-
-## More information
+### Standard Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "CheckInComment": "",
+    "CheckOutType": 2,
+    "ContentTag": "{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1,1",
+    "CustomizedPageStatus": 0,
+    "ETag": "\"{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1\"",
+    "Exists": true,
+    "IrmEnabled": false,
+    "Length": "5987",
+    "Level": 1,
+    "LinkingUri": null,
+    "LinkingUrl": "",
+    "MajorVersion": 1,
+    "MinorVersion": 0,
+    "Name": "Test1.docx",
+    "ServerRelativeUrl": "/sites/project-x/documents/Test1.docx",
+    "TimeCreated": "2022-10-30T10:16:18Z",
+    "TimeLastModified": "2022-10-30T10:16:18Z",
+    "Title": null,
+    "UIVersion": 512,
+    "UIVersionLabel": "1.0",
+    "UniqueId": "b2307a39-e878-458b-bc90-03bc578531d6"
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  CheckInComment      :
+  CheckOutType        : 2
+  ContentTag          : {03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1,1
+  CustomizedPageStatus: 0
+  ETag                : "{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1"
+  Exists              : true
+  IrmEnabled          : false
+  Length              : 5987
+  Level               : 1
+  LinkingUri          : null
+  LinkingUrl          :
+  MajorVersion        : 1
+  MinorVersion        : 0
+  Name                : Test1.docx
+  ServerRelativeUrl   : /sites/project-x/documents/Test1.docx
+  TimeCreated         : 2022-10-30T10:16:18Z
+  TimeLastModified    : 2022-10-30T10:16:18Z
+  Title               : null
+  UIVersion           : 512
+  UIVersionLabel      : 1.0
+  UniqueId            : b2307a39-e878-458b-bc90-03bc578531d6
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  CheckInComment,CheckOutType,ContentTag,CustomizedPageStatus,ETag,Exists,IrmEnabled,Length,Level,LinkingUri,LinkingUrl,MajorVersion,MinorVersion,Name,ServerRelativeUrl,TimeCreated,TimeLastModified,Title,UIVersion,UIVersionLabel,UniqueId
+  ,2,"{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1,1",0,"""{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1""",1,,5987,1,,,1,0,Test1.docx,/sites/project-x/documents/Test1.docx,2022-10-30T10:16:18Z,2022-10-30T10:16:18Z,,512,1.0,b2307a39-e878-458b-bc90-03bc578531d6
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spo file move --webUrl "https://contoso.sharepoint.com/sites/IT" --sourceUrl "/Shared Documents/Document.docx" --targetUrl "/sites/project-x/Shared Documents"
+
+  Date: 10/3/2023
+
+  ## b2307a39-e878-458b-bc90-03bc578531d6
+
+  Property | Value
+  ---------|-------
+  CheckInComment |
+  CheckOutType | 2
+  ContentTag | {03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1,1
+  CustomizedPageStatus | 0
+  ETag | "{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1"
+  Exists | true
+  ExistsAllowThrowForPolicyFailures | true
+  IrmEnabled | false
+  Length | 5987
+  Level | 1
+  LinkingUri | https://contoso.sharepoint.com/sites/project-x/shared%20documents/Document.docx?d=w59d4e6fcf6f94ce78bea0273cedb1a19
+  LinkingUrl | https://contoso.sharepoint.com/sites/project-x/shared documents/Document.docx?d=w59d4e6fcf6f94ce78bea0273cedb1a19
+  MajorVersion | 1
+  MinorVersion | 0
+  Name | Document.docx
+  ServerRelativeUrl | /sites/project-x/shared documents/Document.docx
+  TimeCreated | 2023-05-23T09:51:34Z
+  TimeLastModified | 2023-05-23T10:13:01Z
+  Title |
+  UIVersion | 1536
+  UIVersionLabel | 1.0
+  UniqueId | b2307a39-e878-458b-bc90-03bc578531d6
+  ```
+
+  </TabItem>
+</Tabs>
+
+### `skipWait` response
 
-- Move 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)
+The command won't return a response on success.

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

@@ -31,6 +31,9 @@ m365 spo page template remove
 `--recycle`
 : Recycle the file instead of actually deleting it.
 
+`--bypassSharedLock`
+: Remove the file even if it is locked for shared use.
+
 `-f, --force`
 : Don't prompt for confirming removing the file.
 ```
@@ -39,22 +42,28 @@ m365 spo page template remove
 
 ## Examples
 
-Remove file by ID.
+Remove a file by ID.
 
 ```sh
 m365 spo file remove --webUrl https://contoso.sharepoint.com/sites/project-x --id 0cd891ef-afce-4e55-b836-fce03286cccf
 ```
 
-Remove the file by site-relative URL.
+Remove a file by site-relative URL.
 
 ```sh
 m365 spo file remove --webUrl https://contoso.sharepoint.com/sites/project-x --url "/Shared Documents/Test.docx"
 ```
 
-Move the file by server-relative URL to the recycle bin.
+Remove a file by server-relative URL to the recycle bin.
+
+```sh
+m365 spo file remove --webUrl https://contoso.sharepoint.com/sites/project-x --url "/sites/project-x/Shared Documents/Test.docx" --recycle
+```
+
+Remove a file that is locked
 
 ```sh
-m365 spo file remove --webUrl https://contoso.sharepoint.com/sites/project-x --url "/sites/project-x/SharedDocuments/Test.docx" --recycle
+m365 spo file remove --webUrl https://contoso.sharepoint.com/sites/project-x --url "/Shared Documents/Test.docx" --bypassSharedLock
 ```
 
 Remove a page template by site-relative URL.