@pnp/cli-microsoft365 8.1.0-beta.bf59841 → 9.0.0-beta.2b15817

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

@@ -43,7 +43,7 @@ m365 spo app uninstall --id b2307a39-e878-458b-bc90-03bc578531d6 --siteUrl https
 Uninstall the app with the specified ID from the specified site without prompting for confirmation.
 
 ```sh
-m365 spo app uninstall --id b2307a39-e878-458b-bc90-03bc578531d6 --siteUrl https://contoso.sharepoint.com
+m365 spo app uninstall --id b2307a39-e878-458b-bc90-03bc578531d6 --siteUrl https://contoso.sharepoint.com --force
 ```
 
 Uninstall the app with the specified ID from the specified site where the app is deployed to the site collection app catalog.

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

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo file copy
 
@@ -31,11 +33,14 @@ m365 spo file copy [options]
 `--nameConflictBehavior [nameConflictBehavior]`
 : Behavior when a document with the same name is already present at the destination. Allowed values: `fail`, `replace`, `rename`. Defaults to `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.
+
+`--ignoreVersionHistory`
+: Only copy the most recent version of the file and ignore the version history.
+
+`--skipWait`
+: Don't wait for the copy operation to complete.
 ```
 
 <Global />
@@ -43,7 +48,6 @@ m365 spo file copy [options]
 ## Remarks
 
 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.
@@ -56,16 +60,16 @@ Copy a file by server-relative URL to a document library in another site collect
 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 by site-relative URL to a document library in another site collection and clear the author and created date.
+Copy a file by site-relative URL to a document library in another site collection and ignore the file history.
 
 ```sh
-m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourceUrl "/Shared Documents/Document.pdf" --targetUrl "/sites/IT/Shared Documents" --resetAuthorAndCreated
+m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourceUrl "/Shared Documents/Document.pdf" --targetUrl "/sites/IT/Shared Documents" --ignoreVersionHistory
 ```
 
-Copy file by sourceId (UniqueId) to a document library in another site collection and rename the file.
+Copy file by sourceId (UniqueId) to a document library in another site collection and rename the file (without specifying the file extension).
 
 ```sh
-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"
+m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourceId "b2307a39-e878-458b-bc90-03bc578531d6" --targetUrl "/sites/IT/Shared Documents" --newName "Report"
 ```
 
 Copy file by sourceId (UniqueId) to a document library in another site collection with a new name, rename the file if it already exists.
@@ -76,8 +80,111 @@ m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourc
 
 ## 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 copy --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
 
-- 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)
+The command won't return a response on success.

package/docs/docs/cmd/spo/folder/folder-set.mdx

@@ -10,12 +10,6 @@ Updates a folder
 m365 spo folder set [options]
 ```
 
-## Alias
-
-```sh
-m365 spo folder rename [options]
-```
-
 ## Options
 
 ```md definition-list

package/docs/docs/cmd/spo/folder/folder-sharinglink-get.mdx

@@ -0,0 +1,110 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spo folder sharinglink get
+
+Gets details about a specific sharing link on a folder
+
+## Usage
+
+```sh
+m365 spo folder sharinglink get [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: The URL of the site where the folder is located.
+
+`--folderUrl [folderUrl]`
+: The server- or site-relative decoded URL of the folder. Specify either `folderUrl` or `folderId` but not both.
+
+`--folderId [folderId]`
+: The Unique ID (GUID) of the folder. Specify either `folderUrl` or `folderId` but not both.
+
+`-i, --id <id>`
+: The sharing link ID.
+```
+
+<Global />
+
+## Examples
+
+Gets a specific sharing link of a folder by id.
+
+```sh
+m365 spo folder sharinglink get --webUrl https://contoso.sharepoint.com/sites/demo --id 45fa6aed-362f-48b1-b04e-6da85a526506 --folderId daebb04b-a773-4baa-b1d1-3625418e3234
+```
+
+Gets a specific sharing link of a folder by url.
+
+```sh
+m365 spo folder sharinglink get --webUrl https://contoso.sharepoint.com/sites/demo --id 45fa6aed-362f-48b1-b04e-6da85a526506 --folderUrl "/sites/demo/shared documents/folder"
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "d6f6a428-9857-471f-9635-edd68d5aa6c1",
+    "roles": [
+      "write"
+    ],
+    "shareId": "u!aHR0cHM6Ly9uYWNoYW4zNjUuc2hhcmVwb2ludC5jb20vOmY6L3MvU1BEZW1vL0VxXzlYcXRIdks1RW9wd3NfX1kteko0QlNybFFNUy1qUTBFOWJsazhVLVNTdVE",
+    "hasPassword": false,
+    "grantedToIdentitiesV2": [],
+    "grantedToIdentities": [],
+    "link": {
+      "scope": "anonymous",
+      "type": "edit",
+      "webUrl": "https://contoso.sharepoint.com/:f:/s/demo/Eq_9XqtHvK5Eopws__Y-zJ4BSrlQMS-jQ0E9blk8U-SSuQ",
+      "preventsDownload": false
+    }
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  grantedToIdentities            : []
+  grantedToIdentitiesV2          : []
+  hasPassword                    : false
+  id                             : d6f6a428-9857-471f-9635-edd68d5aa6c1
+  link                           : {"scope":"anonymous","type":"edit","webUrl":"https://contoso.sharepoint.com/:f:/s/demo/Eq_9XqtHvK5Eopws__Y-zJ4BSrlQMS-jQ0E9blk8U-SSuQ","preventsDownload":false}
+  roles                          : ["write"]
+  shareId                        : u!aHR0cHM6Ly9uYWNoYW4zNjUuc2hhcmVwb2ludC5jb20vOmY6L3MvU1BEZW1vL0VxXzlYcXRIdks1RW9wd3NfX1kteko0QlNybFFNUy1qUTBFOWJsazhVLVNTdVE
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,shareId,hasPassword
+  d6f6a428-9857-471f-9635-edd68d5aa6c1,u!aHR0cHM6Ly9uYWNoYW4zNjUuc2hhcmVwb2ludC5jb20vOmY6L3MvU1BEZW1vL0VxXzlYcXRIdks1RW9wd3NfX1kteko0QlNybFFNUy1qUTBFOWJsazhVLVNTdVE,
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spo folder sharinglink get --webUrl "https://contoso.sharepoint.com/sites/demo" --id "d6f6a428-9857-471f-9635-edd68d5aa6c1" --folderUrl "/sites/demo/shared documents/Test"
+
+  Date: 5/2/2024
+
+  ## d6f6a428-9857-471f-9635-edd68d5aa6c1
+
+  Property | Value
+  ---------|-------
+  id | d6f6a428-9857-471f-9635-edd68d5aa6c1
+  shareId | u!aHR0cHM6Ly9uYWNoYW4zNjUuc2hhcmVwb2ludC5jb20vOmY6L3MvU1BEZW1vL0VxXzlYcXRIdks1RW9wd3NfX1kteko0QlNybFFNUy1qUTBFOWJsazhVLVNTdVE
+  hasPassword | false
+  ```
+
+  </TabItem>
+</Tabs>

package/docs/docs/cmd/spo/folder/folder-sharinglink-list.mdx

@@ -0,0 +1,114 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spo folder sharinglink list
+
+Lists all the sharing links of a specific folder
+
+## Usage
+
+```sh
+m365 spo folder sharinglink list [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: The URL of the site where the folder is located.
+
+`--folderUrl [folderUrl]`
+: The server- or site-relative decoded URL of the folder. Specify either `folderUrl` or `folderId` but not both.
+
+`--folderId [folderId]`
+: The UniqueId (GUID) of the folder. Specify either `folderUrl` or `folderId` but not both.
+
+`-s, --scope [scope]`
+: Filter the results to only sharing links of a given scope: `anonymous`, `users` or `organization`. By default all sharing links are listed.
+```
+
+<Global />
+
+## Examples
+
+List sharing links of a folder by id.
+
+```sh
+m365 spo folder sharinglink list --webUrl https://contoso.sharepoint.com/sites/demo --folderId daebb04b-a773-4baa-b1d1-3625418e3234
+```
+
+List sharing links of a folder by url.
+
+```sh
+m365 spo folder sharinglink list --webUrl https://contoso.sharepoint.com/sites/demo --folderUrl "/sites/demo/shared documents/folder"
+```
+
+List anonymous sharing links of a folder by url.
+
+```sh
+m365 spo folder sharinglink list --webUrl https://contoso.sharepoint.com/sites/demo --folderUrl "/sites/demo/shared documents/folder" --scope anonymous
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "id": "e6100f73-981c-4bde-986b-eed262f04659",
+      "roles": [
+        "write"
+      ],
+      "shareId": "u!aHR0cHM6Ly83NTY2YXZhLnNoYXJlcG9pbnQuY29tLzpmOi9nL0V2QVFpdnpLV2ZoT3ZJOHJiNm1UVEhjQmQzUUxCOXVsUGIyQTQ1UG81ZmRuYWc",
+      "hasPassword": false,
+      "grantedToIdentitiesV2": [],
+      "grantedToIdentities": [],
+      "link": {
+        "scope": "anonymous",
+        "type": "edit",
+        "webUrl": "https://contoso.sharepoint.com/:f:/g/EvAQivzKWfhOvI8rb6mTTHcBd3QLB9ulPb2A45Po5fdnag",
+        "preventsDownload": false
+      }
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  id                                    scope         roles  link
+  ------------------------------------  ------------  -----  -----------------------------------------------------------------------------------
+  e6100f73-981c-4bde-986b-eed262f04659  anonymous     write  https://contoso.sharepoint.com/:f:/g/EvAQivzKWfhOvI8rb6mTTHcBd3QLB9ulPb2A45Po5fdnag
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,shareId,hasPassword
+  e6100f73-981c-4bde-986b-eed262f04659,u!aHR0cHM6Ly83NTY2YXZhLnNoYXJlcG9pbnQuY29tLzpmOi9nL0V2QVFpdnpLV2ZoT3ZJOHJiNm1UVEhjQmQzUUxCOXVsUGIyQTQ1UG81ZmRuYWc,
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spo folder sharinglink list --webUrl "https://contoso.sharepoint.com/" --folderUrl "/shared documents/folder1"
+
+  Date: 24/04/2024
+
+  ## e6100f73-981c-4bde-986b-eed262f04659
+
+  Property | Value
+  ---------|-------
+  id | e6100f73-981c-4bde-986b-eed262f04659
+  shareId | u!aHR0cHM6Ly83NTY2YXZhLnNoYXJlcG9pbnQuY29tLzpmOi9nL0V2QVFpdnpLV2ZoT3ZJOHJiNm1UVEhjQmQzUUxCOXVsUGIyQTQ1UG81ZmRuYWc
+  hasPassword | false
+  ```
+
+  </TabItem>
+</Tabs>

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

@@ -91,6 +91,11 @@ m365 spo list get --title Documents --webUrl https://contoso.sharepoint.com/site
 
   ```json
   {
+    "VersionPolicies": {
+      "DefaultExpireAfterDays": 0,
+      "DefaultTrimMode": 0,
+      "DefaultTrimModeValue": "NoExpiration"
+    },
     "AllowContentTypes": true,
     "BaseTemplate": 100,
     "BaseType": 0,
@@ -210,6 +215,7 @@ m365 spo list get --title Documents --webUrl https://contoso.sharepoint.com/site
   ServerTemplateCanCreateFolders           : true
   TemplateFeatureId                        : 00bfea71-de22-43b2-a848-c05709900100
   Title                                    : Test
+  VersionPolicies                          : {"DefaultExpireAfterDays": 0,"DefaultTrimMode": 0,"DefaultTrimModeValue": "NoExpiration"}
   ```
 
   </TabItem>

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

@@ -126,8 +126,7 @@ m365 spo list list --webUrl https://contoso.sharepoint.com/sites/project-x --fil
       "ParserDisabled": false,
       "ServerTemplateCanCreateFolders": false,
       "TemplateFeatureId": "00000000-0000-0000-0000-000000000000",
-      "Title": "Theme Gallery",
-      "Url": "/_catalogs/theme"
+      "Title": "Theme Gallery"
     }
   ]
   ```
@@ -136,17 +135,17 @@ m365 spo list list --webUrl https://contoso.sharepoint.com/sites/project-x --fil
   <TabItem value="Text">
 
   ```text
-  Id                                    Url
+  Id                                    Title
   ------------------------------------  ----------------
-  66e5148c-7060-4479-88e7-636d79579148  /_catalogs/theme
+  66e5148c-7060-4479-88e7-636d79579148  Theme Gallery
   ```
 
   </TabItem>
   <TabItem value="CSV">
 
   ```csv
-  Id,Url
-  Theme Gallery,/_catalogs/theme,66e5148c-7060-4479-88e7-636d79579148
+  Id,Title
+  66e5148c-7060-4479-88e7-636d79579148,Theme Gallery
   ```
 
   </TabItem>
@@ -211,7 +210,6 @@ m365 spo list list --webUrl https://contoso.sharepoint.com/sites/project-x --fil
   ServerTemplateCanCreateFolders | true
   TemplateFeatureId | 00000000-0000-0000-0000-000000000000
   Title | Theme Gallery
-  Url | //\_catalogs/theme
   ```
 
   </TabItem>

package/docs/docs/cmd/spo/site/site-appcatalog-remove.mdx

@@ -14,7 +14,10 @@ m365 spo site appcatalog remove [options]
 
 ```md definition-list
 `-u, --siteUrl <siteUrl>`
-: URL of the site collection containing the app catalog to disable
+: URL of the site collection containing the app catalog to disable.
+
+`-f, --force`
+: Don't prompt for confirmation.
 ```
 
 <Global />
@@ -31,12 +34,18 @@ To use this command you have to have permissions to access the tenant admin site
     
 ## Examples
 
-Remove the site collection app catalog from specified site
+Remove the site collection app catalog from specified site.
 
 ```sh
 m365 spo site appcatalog remove --siteUrl https://contoso.sharepoint/sites/site
 ```
 
+Remove the site collection app catalog from specified site without prompting for confirmation.
+
+```sh
+m365 spo site appcatalog remove --siteUrl https://contoso.sharepoint/sites/site --force
+```
+
 ## Response
 
 The command won't return a response on success.

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

@@ -22,9 +22,6 @@ m365 spo site remove [options]
 `--fromRecycleBin`
 : Set to remove the site from the recycle bin.
 
-`--wait`
-: (deprecated) Wait for the site to be removed before completing the command.
-
 `-f, --force`
 : Don't prompt for confirmation.
 ```

package/docs/docs/cmd/spo/tenant/tenant-recyclebinitem-restore.mdx

@@ -17,9 +17,6 @@ m365 spo tenant recyclebinitem restore [options]
 ```md definition-list
 `-u, --siteUrl <siteUrl>`
 : URL of the site.
-
-`--wait`
-: (deprecated) Wait for the site collection to be restored before completing the command.
 ```
 
 <Global />
@@ -34,7 +31,7 @@ To use this command you must be a Global or SharePoint administrator.
     
 ## Examples
 
-Restore a deleted site collection from tenant recycle bin
+Restores a deleted site collection from tenant recycle bin.
 
 ```sh
 m365 spo tenant recyclebinitem restore --siteUrl https://contoso.sharepoint.com/sites/team
@@ -42,48 +39,4 @@ m365 spo tenant recyclebinitem restore --siteUrl https://contoso.sharepoint.com/
 
 ## Response
 
-<Tabs>
-  <TabItem value="JSON">
-
-  ```json
-  {
-    "HasTimedout": false,
-    "IsComplete": true,
-    "PollingInterval": 15000
-  }
-  ```
-
-  </TabItem>
-  <TabItem value="Text">
-
-  ```text
-  HasTimedout    : false
-  IsComplete     : true
-  PollingInterval: 15000
-  ```
-
-  </TabItem>
-  <TabItem value="CSV">
-
-  ```csv
-  HasTimedout,IsComplete,PollingInterval
-  ,1,15000
-  ```
-
-  </TabItem>
-  <TabItem value="Markdown">
-
-  ```md
-  # spo tenant recyclebinitem restore --siteUrl "https://contoso.sharepoint.com/teams/team1"
-
-  Date: 2023-06-22
-
-  Property | Value
-  ---------|-------
-  HasTimedout | false
-  IsComplete | true
-  PollingInterval | 15000
-  ```
-
-  </TabItem>
-</Tabs>
+The command won't return a response on success.

package/docs/docs/cmd/teams/message/message-remove.mdx

@@ -36,7 +36,6 @@ m365 teams message remove [options]
 
 ## Remarks
 
-You can only remove Microsoft Teams messages that you created yourself.  
 
 :::info
 
@@ -44,6 +43,8 @@ This command does only support delegated permissions.
 
 :::
 
+You can only remove Microsoft Teams messages that you created yourself.
+
 ## Examples
 
 Remove a message by using IDs

package/docs/docs/cmd/teams/message/message-restore.mdx

@@ -0,0 +1,62 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# teams message restore
+
+Restores a deleted message from a channel in a Microsoft Teams team
+
+## Usage
+
+```sh
+m365 teams message restore [options]
+```
+
+## Options
+
+```md definition-list
+`--teamId [teamId]`
+: ID of the Microsoft Teams team. Specify either `teamId` or `teamName` but not both.
+
+`--teamName [teamName]`
+:	Name of the Microsoft Teams team. Specify either `teamId` or `teamName` but not both.
+
+`--channelId [channelId]`
+:	Channel ID of the Microsoft Teams team. Specify either `channelId` or `channelName` but not both.
+
+`--channelName [channelName]`
+:	Channel name of the Microsoft Teams team. Specify either `channelId` or `channelName` but not both.
+
+`-i, --id <id>`
+:	The ID of the Teams message.
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+This command does only support delegated permissions.
+
+:::
+
+You can only restore Microsoft Teams messages that you created yourself.
+
+## Examples
+
+Restore a deleted message by using IDs
+
+```sh
+m365 teams message restore --teamId 5f5d7b71-1161-44d8-bcc1-3da710eb4171 --channelId 19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2 --id 1540747442203
+```
+
+Restore a deleted message by using display names
+
+```sh
+m365 teams message restore --teamName Marketing --channelName Branding --id 1540747442203
+```
+
+## Response
+
+The command won't return a response on success.