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

package/docs/docs/cmd/onenote/notebook/notebook-add.mdx

@@ -0,0 +1,169 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# onenote notebook add
+
+Create a new OneNote notebook.
+
+## Usage
+
+```sh
+m365 onenote notebook add [options]
+```
+
+## Options
+
+```md definition-list
+`-n, --name <name>`
+: Name of the notebook. Notebook names must be unique. The name cannot contain more than 128 characters or contain the following characters: `?*/:<>`
+
+`--userId [userId]`
+: Id of the user. Specify either `userId`, `userName`, `groupId`, `groupName` or `webUrl`, but not multiple.
+
+`--userName [userName]`
+: Name of the user. Specify either `userId`, `userName`, `groupId`, `groupName` or `webUrl`, but not multiple.
+
+`--groupId [groupId]`
+: Id of the SharePoint group. Specify either `userId`, `userName`, `groupId`, `groupName` or `webUrl`, but not multiple.
+
+`--groupName [groupName]`
+: Name of the SharePoint group. Specify either `userId`, `userName`, `groupId`, `groupName` or `webUrl`, but not multiple.
+
+`-u, --webUrl [webUrl]`
+: URL of the SharePoint site. Specify either `userId`, `userName`, `groupId`, `groupName` or `webUrl`, but not multiple.
+```
+
+<Global />
+
+## Examples
+
+Create a Microsoft OneNote notebook for the currently logged in user
+
+```sh
+m365 onenote notebook add --name "Private Notebook"
+```
+
+Create a Microsoft OneNote notebook in a group specified by id.
+
+```sh
+m365 onenote notebook add --name "Private Notebook" --groupId 233e43d0-dc6a-482e-9b4e-0de7a7bce9b4
+```
+
+Create a Microsoft OneNote notebook in a group specified by displayName.
+
+```sh
+m365 onenote notebook add --name "Private Notebook" --groupName "MyGroup"
+```
+
+Create a Microsoft OneNote notebook for a user specified by name
+
+```sh
+m365 onenote notebook add --name "Private Notebook" --userName user1@contoso.onmicrosoft.com
+```
+
+Create a Microsoft OneNote notebook for a user specified by id
+
+```sh
+m365 onenote notebook add --name "Private Notebook" --userId 2609af39-7775-4f94-a3dc-0dd67657e900
+```
+
+Creates a Microsoft OneNote notebooks for a site
+
+```sh
+ m365 onenote notebook add --name "Private Notebook" --webUrl https://contoso.sharepoint.com/sites/testsite
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "1-08554ffd-b769-4a4a-9563-faaa3191f253",
+    "self": "https://graph.microsoft.com/v1.0/users/fe36f75e-c103-410b-a18a-2bf6df06ac3a/onenote/notebooks/1-08554ffd-b769-4a4a-9563-faaa3191f253",
+    "createdDateTime": "2024-04-05T17:58:27Z",
+    "displayName": "Private Notebook",
+    "lastModifiedDateTime": "2024-04-05T17:58:27Z",
+    "isDefault": false,
+    "userRole": "Owner",
+    "isShared": false,
+    "sectionsUrl": "https://graph.microsoft.com/v1.0/users/fe36f75e-c103-410b-a18a-2bf6df06ac3a/onenote/notebooks/1-08554ffd-b769-4a4a-9563-faaa3191f253/sections",
+    "sectionGroupsUrl": "https://graph.microsoft.com/v1.0/users/fe36f75e-c103-410b-a18a-2bf6df06ac3a/onenote/notebooks/1-08554ffd-b769-4a4a-9563-faaa3191f253/sectionGroups",
+    "createdBy": {
+      "user": {
+        "id": "fe36f75e-c103-410b-a18a-2bf6df06ac3a",
+        "displayName": "John Doe"
+      }
+    },
+    "lastModifiedBy": {
+      "user": {
+        "id": "fe36f75e-c103-410b-a18a-2bf6df06ac3a",
+        "displayName": "John Doe"
+      }
+    },
+    "links": {
+      "oneNoteClientUrl": {
+        "href": "onenote:https://contoso-my.sharepoint.com/personal/john_contoso_onmicrosoft_com/Documents/Notebooks/Private Notebook"
+      },
+      "oneNoteWebUrl": {
+        "href": "https://contoso-my.sharepoint.com/personal/john_contoso_onmicrosoft_com/Documents/Notebooks/Private Notebook"
+      }
+    }
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  createdBy           : {"user":{"id":"fe36f75e-c103-410b-a18a-2bf6df06ac3a","displayName":"John Doe"}}
+  createdDateTime     : 2024-04-05T17:58:36Z
+  displayName         : Private Notebook
+  id                  : 1-f4bba32b-9b3e-4892-8df4-931a15f7eb6f
+  isDefault           : false
+  isShared            : false
+  lastModifiedBy      : {"user":{"id":"fe36f75e-c103-410b-a18a-2bf6df06ac3a","displayName":"John Doe"}}
+  lastModifiedDateTime: 2024-04-05T17:58:36Z
+  links               : {"oneNoteClientUrl":{"href":"onenote:https://contoso-my.sharepoint.com/personal/john_contoso_onmicrosoft_com/Documents/Notebooks/Private Notebook"},"oneNoteWebUrl":{"href":"https://contoso-my.sharepoint.com/personal/john_contoso_onmicrosoft_com/Documents/Notebooks/Private Notebook"}}
+  sectionGroupsUrl    : https://graph.microsoft.com/v1.0/users/fe36f75e-c103-410b-a18a-2bf6df06ac3a/onenote/notebooks/1-f4bba32b-9b3e-4892-8df4-931a15f7eb6f/sectionGroups
+  sectionsUrl         : https://graph.microsoft.com/v1.0/users/fe36f75e-c103-410b-a18a-2bf6df06ac3a/onenote/notebooks/1-f4bba32b-9b3e-4892-8df4-931a15f7eb6f/sections
+  self                : https://graph.microsoft.com/v1.0/users/fe36f75e-c103-410b-a18a-2bf6df06ac3a/onenote/notebooks/1-f4bba32b-9b3e-4892-8df4-931a15f7eb6f
+  userRole            : Owner
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,self,createdDateTime,displayName,lastModifiedDateTime,isDefault,userRole,isShared,sectionsUrl,sectionGroupsUrl
+  1-272a5791-2c95-45cf-b27d-7f68e07f6149,https://graph.microsoft.com/v1.0/users/fe36f75e-c103-410b-a18a-2bf6df06ac3a/onenote/notebooks/1-272a5791-2c95-45cf-b27d-7f68e07f6149,2024-04-05T18:00:28Z,Private Notebook,2024-04-05T18:00:28Z,,Owner,,https://graph.microsoft.com/v1.0/users/fe36f75e-c103-410b-a18a-2bf6df06ac3a/onenote/notebooks/1-272a5791-2c95-45cf-b27d-7f68e07f6149/sections,https://graph.microsoft.com/v1.0/users/fe36f75e-c103-410b-a18a-2bf6df06ac3a/onenote/notebooks/1-272a5791-2c95-45cf-b27d-7f68e07f6149/sectionGroups
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # onenote notebook add --name "Private Notebook"
+
+  Date: 05/04/2024
+
+  ## Private Notebook (1-fa279d79-4701-43a2-9593-c2abfbe6999f)
+
+  Property | Value
+  ---------|-------
+  id | 1-fa279d79-4701-43a2-9593-c2abfbe6999f
+  self | https://graph.microsoft.com/v1.0/users/fe36f75e-c103-410b-a18a-2bf6df06ac3a/onenote/notebooks/1-fa279d79-4701-43a2-9593-c2abfbe6999f
+  createdDateTime | 2024-04-05T18:00:58Z
+  displayName | Private Notebook
+  lastModifiedDateTime | 2024-04-05T18:00:58Z
+  isDefault | false
+  userRole | Owner
+  isShared | false
+  sectionsUrl | https://graph.microsoft.com/v1.0/users/fe36f75e-c103-410b-a18a-2bf6df06ac3a/onenote/notebooks/1-fa279d79-4701-43a2-9593-c2abfbe6999f/sections
+  sectionGroupsUrl | https://graph.microsoft.com/v1.0/users/fe36f75e-c103-410b-a18a-2bf6df06ac3a/onenote/notebooks/1-fa279d79-4701-43a2-9593-c2abfbe6999f/sectionGroups
+  ```
+
+  </TabItem>
+</Tabs>

package/docs/docs/cmd/pa/app/app-export.mdx

@@ -14,25 +14,25 @@ m365 pa app export [options]
 
 ```md definition-list
 `-n, --name <name>`
-: The name (GUID) of the Power Apps app to export
+: The name (GUID) of the Power Apps app to export.
 
 `-e, --environmentName <environmentName>`
-: The name of the environment for which to export the app
+: The name of the environment for which to export the app.
 
 `--packageDisplayName [packageDisplayName]`
-: The display name to use in the exported package
+: The display name to use in the exported package.
 
 `-d, --packageDescription [packageDescription]`
-: The description to use in the exported package
+: The description to use in the exported package.
 
 `-c, --packageCreatedBy [packageCreatedBy]`
-: The name of the person to be used as the creator of the exported package
+: The name of the person to be used as the creator of the exported package.
 
 `-s, --packageSourceEnvironment [packageSourceEnvironment]`
-: The name of the source environment from which the exported package was taken
+: The name of the source environment from which the exported package was taken.
 
 `-p, --path [path]`
-: The path to save the exported package to. If not specified the app will be exported in the current working directory
+: The path to save the exported package to. If not specified the app will be exported in the current working directory.
 ```
 
 <Global />
@@ -42,13 +42,19 @@ m365 pa app export [options]
 Export the specified Power App as a ZIP file
 
 ```sh
-m365 pa app export --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --packageDisplayName "PowerApp"
+m365 pa app export --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d
+```
+
+Export the specified Power App as a ZIP file with a custom package name
+
+```sh
+m365 pa app export --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --packageDisplayName "Assets app"
 ```
 
 Export the specified Power App as a ZIP file with the package displayname, package description, the one who created it, the package source environment and the path
 
 ```sh
-m365 pa app export --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --packageDisplayName "PowerApp" --packageDescription "Power App Description" --packageCreatedBy "John Doe" --packageSourceEnvironment "Contoso" --path "C:/Users/John/Documents"
+m365 pa app export --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --packageDisplayName "Assets app" --packageDescription "App to track assets of people" --packageCreatedBy "John Doe" --packageSourceEnvironment "Contoso" --path "C:/Users/John/Documents"
 ```
 
 ## Response

package/docs/docs/cmd/setup.mdx

@@ -18,6 +18,9 @@ m365 setup [options]
 
 `--scripting`
 : Configure CLI for Microsoft 365 for use in scripts without prompting for additional information.
+
+`--skipApp`
+: Skip configuring an Entra app for use with CLI for Microsoft 365.
 ```
 
 <Global />
@@ -28,6 +31,10 @@ The `m365 setup` command is a wizard that helps you configure the CLI for Micros
 
 The command will ask you the following questions:
 
+- _CLI for Microsoft 365 requires a Microsoft Entra app. Do you want to create a new app registration or use an existing one?_
+
+  You can choose between using an existing Entra app or creating a new one. If you choose to create a new app, the CLI will ask you to choose between a minimal and a full set of permissions. It then signs in as Azure CLI to your tenant, creates a new app registration, and stores its information in the CLI configuration.
+
 - _How do you plan to use the CLI?_
 
   You can choose between **interactive** and **scripting** use. In interactive mode, the CLI for Microsoft 365 will prompt you for additional information when needed, automatically open links browser, automatically show help on errors and show spinners. In **scripting** mode, the CLI will not use interactivity to prevent blocking your scripts.
@@ -71,24 +78,30 @@ The `m365 setup` command uses the following presets:
 
 ## Examples
 
-Configure CLI for Microsoft based on your preferences interactively
+Configure CLI for Microsoft 365 based on your preferences interactively
 
 ```sh
 m365 setup
 ```
 
-Configure CLI for Microsoft for interactive use without prompting for additional information
+Configure CLI for Microsoft 365 for interactive use without prompting for additional information
 
 ```sh
 m365 setup --interactive
 ```
 
-Configure CLI for Microsoft for use in scripts without prompting for additional information
+Configure CLI for Microsoft 365 for use in scripts without prompting for additional information
 
 ```sh
 m365 setup --scripting
 ```
 
+Configure CLI for Microsoft 365 without setting up an Entra app
+
+```sh
+m365 setup --skipApp
+```
+
 ## Response
 
 The command won't return a response on success.

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/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/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.