@pnp/cli-microsoft365 12.0.0-beta.e4f7675 → 12.0.0-beta.feb621e

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

@@ -0,0 +1,76 @@
+import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spo folder unarchive
+
+Unarchives a folder
+
+## Usage
+
+```sh
+m365 spo folder unarchive [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: The URL of the site where the folder is located.
+
+`--url [url]`
+: The server- or site-relative decoded URL of the folder to unarchive. Specify either `url` or `id`, but not both.
+
+`-i, --id [id]`
+: The unique ID (GUID) of the folder to unarchive. Specify either `url` or `id`, but not both.
+
+`-f, --force`
+: Don't prompt for confirmation.
+```
+
+<Global />
+
+## Remarks
+
+:::warning
+
+Reactivation could take up to 24 hours. Folders that are reactivated cannot be archived again for **120 days**.
+
+:::
+
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions    |
+  |------------|----------------|
+  | SharePoint | AllSites.Write |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions         |
+  |------------|---------------------|
+  | SharePoint | Sites.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
+## Examples
+
+Unarchive a folder without prompting for confirmation
+
+```sh
+m365 spo folder unarchive --webUrl https://contoso.sharepoint.com/sites/Marketing --id 7a8c9207-7745-4cda-b0e2-be2618ee3030 --force
+```
+
+Unarchive a folder by URL with prompting for confirmation
+
+```sh
+m365 spo folder unarchive --webUrl https://contoso.sharepoint.com/sites/Marketing --url '/sites/Marketing/documents/general'
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -24,8 +24,8 @@ m365 spo list remove [options]
 `-t, --title [title]`
 : Title of the list to remove. Specify either `id` or `title` but not both.
 
-`--recycle`
-: Instead of permanently deleting, send the list to the recycle bin.
+`--permanent`
+: Permanently delete the list instead of moving it to the recycle bin.
 
 `-f, --force`
 : Don't prompt for confirming removing the list.
@@ -66,10 +66,10 @@ Remove the list with a specific title located in a specific site.
 m365 spo list remove --webUrl https://contoso.sharepoint.com/sites/project-x --title 'List 1'
 ```
 
-Remove a list specified by id by sending it to the recycle bin instead of permanently removing it
+Permanently remove a list specified by ID.
 
 ```sh
-m365 spo list remove --webUrl https://contoso.sharepoint.com/sites/project-x --id 0cd891ef-afce-4e55-b836-fce03286cccf --recycle
+m365 spo list remove --webUrl https://contoso.sharepoint.com/sites/project-x --id 0cd891ef-afce-4e55-b836-fce03286cccf --permanent
 ```
 
 ## Response

package/docs/docs/cmd/spo/listitem/listitem-batch-remove.mdx

@@ -31,8 +31,8 @@ m365 spo listitem batch remove [options]
 `-i, --ids [ids]`
 : Comma separated list of list item IDs. Specify `filePath` or `ids`, but not both.
 
-`-r, --recycle`
-: Recycle the list items. Otherwise, they will be permanently deleted.
+`--permanent`
+: Permanently delete the list items instead of moving them to the recycle bin.
 
 `-f, --force`
 : Don't prompt for confirmation.
@@ -65,6 +65,12 @@ Remove a list of IDs from a list by specifying the IDs
 m365 spo listitem batch remove --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle "Demo List" --ids "123,234,345"
 ```
 
+Permanently remove a list of IDs from a list.
+
+```sh
+m365 spo listitem batch remove --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle "Demo List" --ids "123,234,345" --permanent
+```
+
 ## Response
 
 The command won't return a response on success.

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

@@ -44,12 +44,6 @@ m365 spo listitem get [options]
 
 ## Remarks
 
-:::note
-
-The `--properties` option has been renamed to `--fields`. If you use `--properties`, the command still works but shows a deprecation warning.
-
-:::
-
 If you want to specify a lookup type in the `fields` option, define which columns from the related list should be returned.
 
 ## Examples

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

@@ -28,8 +28,8 @@ m365 spo listitem remove [options]
 `--listUrl [listUrl]`
 : Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`
 
-`--recycle`
-: Recycle the list item
+`--permanent`
+: Permanently delete the list item instead of moving it to the recycle bin.
 
 `-f, --force`
 : Don't prompt for confirming removing the list item
@@ -57,6 +57,12 @@ Remove the list item located in a given site based on the server-relative list u
 m365 spo listitem remove --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl /sites/project-x/lists/TestList --id 1
 ```
 
+Permanently remove a list item.
+
+```sh
+m365 spo listitem remove --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'List 1' --id 1 --permanent
+```
+
 ## Response
 
 The command won't return a response on success.

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

@@ -69,27 +69,35 @@ m365 spo navigation node list --webUrl https://contoso.sharepoint.com/sites/Mark
         "5786b8e8-c495-4734-b345-756733960730"
       ],
       "CurrentLCID": 1033,
-      "Id": 2032,
-      "IsDocLib": true,
-      "IsExternal": true,
-      "IsVisible": true,
-      "ListTemplateType": 0,
-      "Title": "Navigation Link",
-      "Url": "https://contoso.sharepoint.com",
-      "Children": [
+      "CustomProperties": [],
+      "FriendlyUrlSegment": "",
+      "IsDeleted": false,
+      "IsHidden": false,
+      "IsTitleForExistingLanguage": false,
+      "Key": "2032",
+      "Nodes": [
         {
-          "AudienceIds": null,
+          "AudienceIds": [],
           "CurrentLCID": 1033,
-          "Id": 2033,
-          "IsDocLib": true,
-          "IsExternal": true,
-          "IsVisible": true,
-          "ListTemplateType": 0,
+          "CustomProperties": [],
+          "FriendlyUrlSegment": "",
+          "IsDeleted": false,
+          "IsHidden": false,
+          "IsTitleForExistingLanguage": false,
+          "Key": "2033",
+          "Nodes": [],
+          "NodeType": 0,
+          "OpenInNewWindow": true,
+          "SimpleUrl": "https://microsoft365.com",
           "Title": "Microsoft 365",
-          "Url": "https://microsoft365.com",
-          "Children": []
+          "Translations": []
         }
-      ]
+      ],
+      "NodeType": 0,
+      "OpenInNewWindow": false,
+      "SimpleUrl": "https://contoso.sharepoint.com",
+      "Title": "Navigation Link",
+      "Translations": []
     }
   ]
   ```
@@ -98,7 +106,7 @@ m365 spo navigation node list --webUrl https://contoso.sharepoint.com/sites/Mark
   <TabItem value="Text">
 
   ```text
-  Id    Title            Url
+  Key   Title            SimpleUrl
   ----  ---------------  ------------------------------
   2032  Navigation Link  https://contoso.sharepoint.com
   ```
@@ -107,8 +115,8 @@ m365 spo navigation node list --webUrl https://contoso.sharepoint.com/sites/Mark
   <TabItem value="CSV">
 
   ```csv
-  Id,Title,Url
-  2032,Navigation Link,https://contoso.sharepoint.com
+  CurrentLCID,FriendlyUrlSegment,IsDeleted,IsHidden,IsTitleForExistingLanguage,Key,NodeType,OpenInNewWindow,SimpleUrl,Title
+  1033,,0,0,0,2032,0,0,https://contoso.sharepoint.com,Navigation Link
   ```
 
   </TabItem>
@@ -119,18 +127,20 @@ m365 spo navigation node list --webUrl https://contoso.sharepoint.com/sites/Mark
 
   Date: 27/1/2023
 
-  ## Home (1031)
+  ## Navigation Link
 
   Property | Value
   ---------|-------
   CurrentLCID | 1033
-  Id | 2032
-  IsDocLib | true
-  IsExternal | false
-  IsVisible | true
-  ListTemplateType | 0
+  FriendlyUrlSegment |
+  IsDeleted | false
+  IsHidden | false
+  IsTitleForExistingLanguage | false
+  Key | 2032
+  NodeType | 0
+  OpenInNewWindow | false
+  SimpleUrl | https://contoso.sharepoint.com
   Title | Navigation Link
-  Url | https://contoso.sharepoint.com
   ```
 
   </TabItem>

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

@@ -19,8 +19,8 @@ m365 spo page remove [options]
 `-n, --name <name>`
 : Name of the page.
 
-`--recycle`
-: Send the page to the recycle bin instead of permanently deleting it.
+`--permanent`
+: Permanently delete the page instead of moving it to the recycle bin.
 
 `--bypassSharedLock`
 : Remove the page even if it is locked for shared use.
@@ -45,10 +45,10 @@ Remove a modern page without a confirmation prompt
 m365 spo page remove --name HR.aspx --webUrl https://contoso.sharepoint.com/sites/Marketing --force
 ```
 
-Send a page to the recycle bin
+Permanently remove a page
 
 ```sh
-m365 spo page remove --name HR.aspx --webUrl https://contoso.sharepoint.com/sites/Marketing --recycle
+m365 spo page remove --name HR.aspx --webUrl https://contoso.sharepoint.com/sites/Marketing --permanent
 ```
 
 Remove a page that is locked

package/docs/docs/cmd/spo/site/site-apppermission-add.mdx

@@ -34,14 +34,45 @@ m365 spo site apppermission add [options]
 
 To set permissions, specify at minimum either `appId` or `appDisplayName`. For best performance specify both values to avoid extra lookup.
 
-## Example
+## Permissions
 
-Grants the specified app the _read_ permission to site _https://contoso.sharepoint.com/sites/project-x_
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                                 |
+  |-----------------|---------------------------------------------|
+  | Microsoft Graph | Sites.FullControl.All, Application.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                                 |
+  |-----------------|---------------------------------------------|
+  | Microsoft Graph | Sites.FullControl.All, Application.Read.All |
+
+  </TabItem>
+</Tabs>
+
+## Examples
+
+Grants the app with the specified display name the _read_ permission to a specific site
 
 ```sh
 m365 spo site apppermission add --siteUrl https://contoso.sharepoint.com/sites/project-x --permission read --appDisplayName Foo
 ```
 
+Grants the app with the specified ID the _write_ permission to a specific site
+
+```sh
+m365 spo site apppermission add --siteUrl https://contoso.sharepoint.com/sites/project-x --permission write --appId 5c89fbbf-670e-48e7-a0bc-fa8942c895a2
+```
+
+Grants the app with the specified ID and display name the _manage_ permission to a specific site
+
+```sh
+m365 spo site apppermission add --siteUrl https://contoso.sharepoint.com/sites/project-x --permission manage --appId 5c89fbbf-670e-48e7-a0bc-fa8942c895a2 --appDisplayName Foo
+```
+
 ## Response
 
 <Tabs>
@@ -49,27 +80,27 @@ m365 spo site apppermission add --siteUrl https://contoso.sharepoint.com/sites/p
 
   ```json
   {
-  "id": "aTowaS50fG1zLnNwLmV4dHw1Yzg5ZmJiZi02NzBlLTQ4ZTctYTBiYy1mYTg5NDJjODk1YTJAMWU4NTJiNDktYmY0Yi00YmE1LWJjZDQtYThjNDcwNmM4ZWQ0",
-  "roles": [
-    "read"
-  ],
-  "grantedToIdentitiesV2": [
-    {
-      "application": {
-        "displayName": "Foo",
-        "id": "5c89fbbf-670e-48e7-a0bc-fa8942c895a2"
+    "id": "aTowaS50fG1zLnNwLmV4dHw1Yzg5ZmJiZi02NzBlLTQ4ZTctYTBiYy1mYTg5NDJjODk1YTJAMWU4NTJiNDktYmY0Yi00YmE1LWJjZDQtYThjNDcwNmM4ZWQ0",
+    "roles": [
+      "read"
+    ],
+    "grantedToIdentitiesV2": [
+      {
+        "application": {
+          "displayName": "Foo",
+          "id": "5c89fbbf-670e-48e7-a0bc-fa8942c895a2"
+        }
       }
-    }
-  ],
-  "grantedToIdentities": [
-    {
-      "application": {
-        "displayName": "Foo",
-        "id": "5c89fbbf-670e-48e7-a0bc-fa8942c895a2"
+    ],
+    "grantedToIdentities": [
+      {
+        "application": {
+          "displayName": "Foo",
+          "id": "5c89fbbf-670e-48e7-a0bc-fa8942c895a2"
+        }
       }
-    }
-  ]
-}
+    ]
+  }
   ```
 
   </TabItem>

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

@@ -16,8 +16,8 @@ m365 spo site remove [options]
 `-u, --url <url>`
 : URL of the site.
 
-`--skipRecycleBin`
-: Set to directly remove the site without moving it to the recycle bin.
+`--permanent`
+: Permanently remove the site without leaving it in the recycle bin.
 
 `--fromRecycleBin`
 : Set to remove the site from the recycle bin.
@@ -49,7 +49,7 @@ m365 spo site remove --url https://contoso.sharepoint.com/sites/demosite
 Remove the site without moving it to the recycle bin.
 
 ```sh
-m365 spo site remove --url https://contoso.sharepoint.com/sites/demosite --skipRecycleBin
+m365 spo site remove --url https://contoso.sharepoint.com/sites/demosite --permanent
 ```
 
 Remove the previously deleted site from the recycle bin.

package/docs/docs/cmd/spo/web/web-rule-get.mdx

@@ -0,0 +1,108 @@
+import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spo web rule get
+
+Retrieves information about a specific alert from a SharePoint list
+
+## Usage
+
+```sh
+m365 spo web rule get [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: The URL of the SharePoint site.
+
+`--id <id>`
+: The ID of the rule.
+```
+
+<Global />
+
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions          |
+  |-----------------|----------------------|
+  | SharePoint      | AllSites.FullControl |
+  | Microsoft Graph | User.ReadBasic.All   |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions           |
+  |-----------------|-----------------------|
+  | SharePoint      | Sites.FullControl.All |
+  | Microsoft Graph | User.ReadBasic.All    |
+
+  </TabItem>
+</Tabs>
+
+## Examples
+
+Retrieve a rule by ID
+
+```sh
+m365 spo web rule get --webUrl https://contoso.sharepoint.com/sites/Marketing --id 7cbb4c8d-8e4d-4d2e-9c6f-3f1d8b2e6a0e
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "AlertFrequency": 0,
+    "AlertTemplateName": "SPAlertTemplateType.DocumentLibrary",
+    "AlertType": 0,
+    "AlwaysNotify": false,
+    "DeliveryChannels": 1,
+    "EventType": -1,
+    "Filter": "",
+    "ID": "7cbb4c8d-8e4d-4d2e-9c6f-3f1d8b2e6a0e",
+    "Status": 0,
+    "Title": "Marketing documents",
+    "UserId": 8,
+    "List": {
+      "Id": "39d9e102-9e8f-4e74-8f17-84a92f972fcf",
+      "Title": "Documents",
+      "RootFolder": {
+        "ServerRelativeUrl": "/sites/Marketing/Shared Documents"
+      }
+    },
+    "User": {
+      "Id": 8,
+      "UserPrincipalName": "jane.doe@contoso.com"
+    }
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  AlertFrequency   : 0
+  AlertTemplateName: SPAlertTemplateType.DocumentLibrary
+  AlertType        : 0
+  AlwaysNotify     : false
+  DeliveryChannels : 1
+  EventType        : -1
+  Filter           : 
+  ID               : 7cbb4c8d-8e4d-4d2e-9c6f-3f1d8b2e6a0e
+  Status           : 0
+  Title            : Marketing documents
+  UserId           : 8
+  List             : {"Id":"39d9e102-9e8f-4e74-8f17-84a92f972fcf","Title":"Documents","RootFolder":{"ServerRelativeUrl":"/sites/Marketing/Shared Documents"}}
+  User             : {"Id":8,"UserPrincipalName":"jane.doe@contoso.com"}
+  ```
+
+  </TabItem>
+</Tabs>

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

@@ -12,12 +12,6 @@ Lists all SharePoint list alerts
 m365 spo web rule list [options]
 ```
 
-## Alias
-
-```sh
-m365 spo web alert list
-```
-
 ## Options
 
 ```md definition-list
@@ -47,16 +41,18 @@ m365 spo web alert list
 <Tabs>
   <TabItem value="Delegated">
 
-  | Resource   | Permissions          |
-  |------------|----------------------|
-  | SharePoint | AllSites.FullControl |
+  | Resource        | Permissions          |
+  |-----------------|----------------------|
+  | SharePoint      | AllSites.FullControl |
+  | Microsoft Graph | User.ReadBasic.All   |
 
   </TabItem>
   <TabItem value="Application">
 
-  | Resource   | Permissions           |
-  |------------|-----------------------|
-  | SharePoint | Sites.FullControl.All |
+  | Resource        | Permissions           |
+  |-----------------|-----------------------|
+  | SharePoint      | Sites.FullControl.All |
+  | Microsoft Graph | User.ReadBasic.All    |
 
   </TabItem>
 </Tabs>

package/docs/docs/cmd/spo/web/web-rule-remove.mdx

@@ -12,12 +12,6 @@ Removes an alert from a SharePoint list
 m365 spo web rule remove [options]
 ```
 
-## Alias
-
-```sh
-m365 spo web alert remove
-```
-
 ## Options
 
 ```md definition-list

package/docs/docs/cmd/spp/model/model-get.mdx

@@ -32,7 +32,7 @@ m365 spp model get [options]
 
 ## Examples
 
-Retrieve information about a SharePoint Premium document understanding model, using model UniqueId.
+Retrieve information about a SharePoint Premium document understanding model, using model unique ID.
 
 ```sh
 m365 spp model get --siteUrl "https://contoso.sharepoint.com/sites/ContentCenter" --id "7645e69d-21fb-4a24-a17a-9bdfa7cb63dc"

package/docs/docs/cmd/spp/model/model-remove.mdx

@@ -40,7 +40,7 @@ The model must be removed from all libraries before it can be deleted.
 
 ## Examples
 
-Delete a SharePoint Premium document understanding model using the model’s UniqueId.
+Delete a SharePoint Premium document understanding model using the model’s unique ID.
 
 ```sh
 m365 spp model remove --siteUrl "https://contoso.sharepoint.com/sites/ContentCenter" --id "7645e69d-21fb-4a24-a17a-9bdfa7cb63dc"

package/docs/docs/cmd/teams/app/app-install.mdx

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # teams app install
 
@@ -35,6 +37,25 @@ m365 teams app install [options]
 
 The `id` has to be the ID of the app from the Microsoft Teams App Catalog. Do not use the ID from the manifest of the zip app package. Use the [teams app list](./app-list.mdx) command to get this ID instead.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                                                                                                         |
+  |-----------------|---------------------------------------------------------------------------------------------------------------------|
+  | Microsoft Graph | AppCatalog.Submit, TeamsAppInstallation.ReadWriteForTeam, TeamsAppInstallation.ReadWriteForUser, User.ReadBasic.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                                                                                                              |
+  |-----------------|--------------------------------------------------------------------------------------------------------------------------|
+  | Microsoft Graph | AppCatalog.Read.All, TeamsAppInstallation.ReadWriteForTeam.All, TeamsAppInstallation.ReadWriteForUser.All, User.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Install an app from the catalog in a Microsoft Teams team

package/docs/docs/cmd/teams/app/app-list.mdx

@@ -21,6 +21,25 @@ m365 teams app list [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions       |
+  |-----------------|-------------------|
+  | Microsoft Graph | AppCatalog.Submit |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions         |
+  |-----------------|---------------------|
+  | Microsoft Graph | AppCatalog.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 List all apps from the Microsoft Teams app catalog

package/docs/docs/cmd/teams/app/app-publish.mdx

@@ -29,6 +29,23 @@ To use this command you must be a Global administrator.
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions              |
+  |-----------------|--------------------------|
+  | Microsoft Graph | AppCatalog.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  This command does not support application permissions.
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Add the _teams-manifest.zip_ file to the organization's app catalog