@pnp/cli-microsoft365 12.0.0-beta.0be7d8d → 12.0.0-beta.1752794

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

@@ -22,7 +22,7 @@ m365 spo folder get [options]
 : The server- or site-relative decoded URL of the folder to retrieve. Specify either `folderUrl` or `id` but not both.
 
 `-i, --id [id]`
-: The UniqueId (GUID) of the folder to retrieve. Specify either `url` or `id` but not both.
+: The unique ID (GUID) of the folder to retrieve. Specify either `url` or `id` but not both.
 
 `--withPermissions`
 : Set if you want to return associated roles and permissions of the folder. 
@@ -63,7 +63,7 @@ Get folder properties for a folder with a specific site-relative URL.
 m365 spo folder get --webUrl https://contoso.sharepoint.com/sites/project-x --url "/Shared Documents"
 ```
 
-Get folder properties for a folder with a specific id (UniqueId).
+Get folder properties for a folder with a specific id (unique ID).
 
 ```sh
 m365 spo folder get --webUrl https://contoso.sharepoint.com/sites/project-x --id "b2307a39-e878-458b-bc90-03bc578531d6"

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

@@ -21,8 +21,8 @@ m365 spo folder remove [options]
 `--url <url>`
 : The server- or site-relative decoded URL of the folder to delete.
 
-`--recycle`
-: Recycles the folder instead of actually deleting it.
+`--permanent`
+: Permanently deletes the folder instead of moving it to the recycle bin.
 
 `-f, --force`
 : Don't prompt for confirming deleting the folder.
@@ -61,10 +61,10 @@ Remove a folder with a specific site-relative URL.
 m365 spo folder remove --webUrl https://contoso.sharepoint.com/sites/project-x --url '/Shared Documents/My Folder'
 ```
 
-Remove a folder with a specific server relative URL to the site recycle bin.
+Permanently remove a folder with a specific server-relative URL.
 
 ```sh
-m365 spo folder remove --webUrl https://contoso.sharepoint.com/sites/project-x --url '/sites/project-x/Shared Documents/My Folder' --recycle
+m365 spo folder remove --webUrl https://contoso.sharepoint.com/sites/project-x --url '/sites/project-x/Shared Documents/My Folder' --permanent
 ```
 
 ## Response

package/docs/docs/cmd/spo/folder/folder-retentionlabel-ensure.mdx

@@ -22,7 +22,7 @@ m365 spo folder retentionlabel ensure [options]
 : The server- or site-relative decoded URL of the folder that should be labelled. Specify either `folderUrl` or `folderId` but not both.
 
 `-i, --folderId [folderId]`
-: The UniqueId (GUID) of the folder that should be labelled. Specify either `folderUrl` or `folderId` but not both.
+: The unique ID (GUID) of the folder that should be labelled. Specify either `folderUrl` or `folderId` but not both.
 
 `--name <name>`
 : Name of the retention label to apply to the folder.

package/docs/docs/cmd/spo/folder/folder-retentionlabel-remove.mdx

@@ -22,7 +22,7 @@ m365 spo folder retentionlabel remove [options]
 : The server- or site-relative decoded URL of the folder of which the label should be removed. Specify either `folderUrl` or `folderId` but not both.
 
 `-i, --folderId [folderId]`
-: The UniqueId (GUID) of the folder of which the label should be removed. Specify either `folderUrl` or `folderId` but not both.
+: The unique ID (GUID) of the folder of which the label should be removed. Specify either `folderUrl` or `folderId` but not both.
 
 `-f, --force`
 : Don't prompt for confirming to remove the label.

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

@@ -22,7 +22,7 @@ m365 spo folder sharinglink add [options]
 : 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.
+: The unique ID (GUID) of the folder. Specify either `folderUrl` or `folderId` but not both.
 
 `--type <type>`
 : The type of sharing link to create. Either `view` or `edit`.
@@ -42,6 +42,27 @@ m365 spo folder sharinglink add [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                     |
+  |-----------------|---------------------------------|
+  | Microsoft Graph | Files.ReadWrite, Sites.Read.All |
+  | SharePoint      | AllSites.Read                   |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                         |
+  |-----------------|-------------------------------------|
+  | Microsoft Graph | Files.ReadWrite.All, Sites.Read.All |
+  | SharePoint      | Sites.Read.All                      |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Creates a view-only anonymous sharing link of a folder by id.

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

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo folder sharinglink clear
 
@@ -31,6 +33,27 @@ m365 spo folder sharinglink clear [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                     |
+  |-----------------|---------------------------------|
+  | Microsoft Graph | Files.ReadWrite, Sites.Read.All |
+  | SharePoint      | AllSites.Read                   |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                         |
+  |-----------------|-------------------------------------|
+  | Microsoft Graph | Files.ReadWrite.All, Sites.Read.All |
+  | SharePoint      | Sites.Read.All                      |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Removes all sharing links from a folder specified by id without prompting for confirmation.

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

@@ -30,6 +30,27 @@ m365 spo folder sharinglink get [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                |
+  |-----------------|----------------------------|
+  | Microsoft Graph | Files.Read, Sites.Read.All |
+  | SharePoint      | AllSites.Read              |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                    |
+  |-----------------|--------------------------------|
+  | Microsoft Graph | Files.Read.All, Sites.Read.All |
+  | SharePoint      | Sites.Read.All                 |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Gets a specific sharing link of a folder by id.

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

@@ -22,7 +22,7 @@ m365 spo folder sharinglink list [options]
 : 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.
+: The unique ID (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.
@@ -30,6 +30,27 @@ m365 spo folder sharinglink list [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                |
+  |-----------------|----------------------------|
+  | Microsoft Graph | Files.Read, Sites.Read.All |
+  | SharePoint      | AllSites.Read              |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                    |
+  |-----------------|--------------------------------|
+  | Microsoft Graph | Files.Read.All, Sites.Read.All |
+  | SharePoint      | Sites.Read.All                 |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 List sharing links of a folder by id.

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

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo folder sharinglink remove
 
@@ -20,7 +22,7 @@ m365 spo folder sharinglink remove [options]
 : 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.
+: The unique ID (GUID) of the folder. Specify either `folderUrl` or `folderId` but not both.
 
 `-i, --id <id>`
 : The ID of the sharing link.
@@ -31,6 +33,27 @@ m365 spo folder sharinglink remove [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                     |
+  |-----------------|---------------------------------|
+  | Microsoft Graph | Files.ReadWrite, Sites.Read.All |
+  | SharePoint      | AllSites.Read                   |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                         |
+  |-----------------|-------------------------------------|
+  | Microsoft Graph | Files.ReadWrite.All, Sites.Read.All |
+  | SharePoint      | Sites.Read.All                      |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Removes a specific sharing link from a folder by id without prompting for confirmation.

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

@@ -33,6 +33,27 @@ m365 spo folder sharinglink set [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                     |
+  |-----------------|---------------------------------|
+  | Microsoft Graph | Files.ReadWrite, Sites.Read.All |
+  | SharePoint      | AllSites.Read                   |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                         |
+  |-----------------|-------------------------------------|
+  | Microsoft Graph | Files.ReadWrite.All, Sites.Read.All |
+  | SharePoint      | Sites.Read.All                      |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Updates the expiration datetime of an anonymous sharing link for a folder specific by folder ID.

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>