@pnp/cli-microsoft365 12.0.0-beta.8dff3ac → 12.0.0-beta.93e11fb

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/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/navigation/navigation-node-add.mdx

@@ -30,9 +30,6 @@ m365 spo navigation node add [options]
 `--parentNodeId [parentNodeId]`
 : ID of the node below which the node should be added. Specify either `location` or `parentNodeId` but not both.
 
-`--isExternal`
-: Set, if the navigation node points to an external URL.
-
 `--audienceIds [audienceIds]`
 : Comma-separated list of group IDs that will be used for audience targeting. The limit is 10 ids per navigation node.
 
@@ -57,7 +54,7 @@ m365 spo navigation node add --webUrl https://contoso.sharepoint.com/sites/team-
 Add a navigation node pointing to an external page to the quick launch.
 
 ```sh
-m365 spo navigation node add --webUrl https://contoso.sharepoint.com/sites/team-a --location QuickLaunch --title "About us" --url https://contoso.com/about-us --isExternal
+m365 spo navigation node add --webUrl https://contoso.sharepoint.com/sites/team-a --location QuickLaunch --title "About us" --url https://contoso.com/about-us
 ```
 
 Add a navigation node below an existing node and opens it in a new window.
@@ -72,6 +69,12 @@ Add a navigation node to the top navigation which is audience targetted and open
 m365 spo navigation node add --webUrl https://contoso.sharepoint.com/sites/team-a --location TopNavigationBar --title About --url /sites/team-s/sitepages/about.aspx --audienceIds "7aa4a1ca-4035-4f2f-bac7-7beada59b5ba,4bbf236f-a131-4019-b4a2-315902fcfa3a" --openInNewWindow
 ```
 
+Add a linkless label to the quick launch.
+
+```sh
+m365 spo navigation node add --webUrl https://contoso.sharepoint.com/sites/team-a --location QuickLaunch --title Resources
+```
+
 ## Response
 
 <Tabs>
@@ -83,13 +86,18 @@ m365 spo navigation node add --webUrl https://contoso.sharepoint.com/sites/team-
       "7aa4a1ca-4035-4f2f-bac7-7beada59b5ba"
     ],
     "CurrentLCID": 1033,
-    "Id": 2030,
-    "IsDocLib": true,
-    "IsExternal": true,
-    "IsVisible": true,
-    "ListTemplateType": 0,
+    "CustomProperties": [],
+    "FriendlyUrlSegment": "",
+    "IsDeleted": false,
+    "IsHidden": false,
+    "IsTitleForExistingLanguage": false,
+    "Key": "2030",
+    "Nodes": [],
+    "NodeType": 0,
+    "OpenInNewWindow": true,
+    "SimpleUrl": "https://contoso.sharepoint.com",
     "Title": "Navigation Link",
-    "Url": "https://contoso.sharepoint.com"
+    "Translations": []
   }
   ```
 
@@ -97,45 +105,52 @@ m365 spo navigation node add --webUrl https://contoso.sharepoint.com/sites/team-
   <TabItem value="Text">
 
   ```text
-  AudienceIds     : ["7aa4a1ca-4035-4f2f-bac7-7beada59b5ba"]
-  CurrentLCID     : 1033
-  Id              : 2031
-  IsDocLib        : true
-  IsExternal      : true
-  IsVisible       : true
-  ListTemplateType: 0
-  Title           : Navigation Link
-  Url             : https://contoso.sharepoint.com
+  AudienceIds               : ["7aa4a1ca-4035-4f2f-bac7-7beada59b5ba"]
+  CurrentLCID               : 1033
+  CustomProperties          : []
+  FriendlyUrlSegment        :
+  IsDeleted                 : false
+  IsHidden                  : false
+  IsTitleForExistingLanguage: false
+  Key                       : 2030
+  NodeType                  : 0
+  Nodes                     : []
+  OpenInNewWindow           : true
+  SimpleUrl                 : https://contoso.sharepoint.com
+  Title                     : Navigation Link
+  Translations              : []
   ```
 
   </TabItem>
   <TabItem value="CSV">
 
   ```csv
-  AudienceIds,CurrentLCID,Id,IsDocLib,IsExternal,IsVisible,ListTemplateType,Title,Url
-  "[""7aa4a1ca-4035-4f2f-bac7-7beada59b5ba""]",1033,2032,1,1,1,0,Navigation Link,https://contoso.sharepoint.com
+  CurrentLCID,FriendlyUrlSegment,IsDeleted,IsHidden,IsTitleForExistingLanguage,Key,NodeType,OpenInNewWindow,SimpleUrl,Title
+  1033,,0,0,0,2030,0,1,https://contoso.sharepoint.com,Navigation Link
   ```
 
   </TabItem>
   <TabItem value="Markdown">
 
   ```md
-  # spo navigation node get --webUrl "https://contoso.sharepoint.com/sites/team-a" --location "TopNavigationBar" --title "Navigation Link" --url "https://contoso.sharepoint.com"
+  # spo navigation node add --webUrl "https://contoso.sharepoint.com/sites/team-a" --location "TopNavigationBar" --title "Navigation Link" --url "https://contoso.sharepoint.com" --openInNewWindow "true"
 
-  Date: 2/20/2023
+  Date: 10/7/2026
 
-  ## Navigation Link (2030)
+  ## Navigation Link
 
   Property | Value
   ---------|-------
   CurrentLCID | 1033
-  Id | 2030
-  IsDocLib | true
-  IsExternal | false
-  IsVisible | true
-  ListTemplateType | 0
+  FriendlyUrlSegment |
+  IsDeleted | false
+  IsHidden | false
+  IsTitleForExistingLanguage | false
+  Key | 2030
+  NodeType | 0
+  OpenInNewWindow | true
+  SimpleUrl | https://contoso.sharepoint.com
   Title | Navigation Link
-  Url | https://contoso.sharepoint.com
   ```
 
   </TabItem>

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

@@ -18,6 +18,9 @@ m365 spo navigation node get [options]
 `-u, --webUrl <webUrl>`
 : Absolute URL of the site.
 
+`-l, --location <location>`
+: Navigation type where the node is located. Available options: `QuickLaunch`, `TopNavigationBar`.
+
 `--id <id>`
 : Id of the navigation node.
 ```
@@ -45,10 +48,16 @@ m365 spo navigation node get [options]
 
 ## Examples
 
-Retrieve information for a specific navigation node.
+Retrieve information for a specific navigation node from the quick launch.
 
 ```sh
-m365 spo navigation node get --webUrl https://contoso.sharepoint.com/sites/Marketing --id 2209
+m365 spo navigation node get --webUrl https://contoso.sharepoint.com/sites/Marketing --location QuickLaunch --id 2209
+```
+
+Retrieve information for a specific navigation node from the top navigation.
+
+```sh
+m365 spo navigation node get --webUrl https://contoso.sharepoint.com/sites/Marketing --location TopNavigationBar --id 2209
 ```
 
 ## Response
@@ -58,31 +67,39 @@ m365 spo navigation node get --webUrl https://contoso.sharepoint.com/sites/Marke
 
   ```json
   {
-    "Children": [
+    "AudienceIds": [
+      "0d718612-8407-4d6b-833c-6891a553354f"
+    ],
+    "CurrentLCID": 1033,
+    "CustomProperties": [],
+    "FriendlyUrlSegment": "",
+    "IsDeleted": false,
+    "IsHidden": false,
+    "IsTitleForExistingLanguage": false,
+    "Key": "2209",
+    "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": "2210",
+        "Nodes": [],
+        "NodeType": 0,
+        "OpenInNewWindow": true,
+        "SimpleUrl": "https://microsoft365.com",
         "Title": "Microsoft 365",
-        "Url": "https://microsoft365.com",
-        "Children": []
+        "Translations": []
       }
     ],
-    "AudienceIds": [
-      "0d718612-8407-4d6b-833c-6891a553354f"
-    ],
-    "CurrentLCID": 1033,
-    "Id": 2209,
-    "IsDocLib": true,
-    "IsExternal": false,
-    "IsVisible": true,
-    "ListTemplateType": 100,
+    "NodeType": 0,
+    "OpenInNewWindow": null,
+    "SimpleUrl": "/sites/Marketing/Lists/Work Status/AllItems.aspx",
     "Title": "Work Status",
-    "Url": "/sites/Marketing/Lists/Work Status/AllItems.aspx"
+    "Translations": []
   }
   ```
 
@@ -90,46 +107,51 @@ m365 spo navigation node get --webUrl https://contoso.sharepoint.com/sites/Marke
   <TabItem value="Text">
 
   ```text
-  Children        : [{ AudienceIds: null, CurrentLCID: 1033, Id: 2033, IsDocLib: true, IsExternal: true, IsVisible: true, ListTemplateType: 0, Title: "Microsoft 365", Url: "https://microsoft365.com", Children: [] }]
-  AudienceIds     : ["0d718612-8407-4d6b-833c-6891a553354f"]
-  CurrentLCID     : 1033
-  Id              : 2209
-  IsDocLib        : true
-  IsExternal      : false
-  IsVisible       : true
-  ListTemplateType: 100
-  Title           : Work Status
-  Url             : /sites/Marketing/Lists/Work Status/AllItems.aspx
+  AudienceIds               : ["0d718612-8407-4d6b-833c-6891a553354f"]
+  CurrentLCID               : 1033
+  CustomProperties          : []
+  FriendlyUrlSegment        :
+  IsDeleted                 : false
+  IsHidden                  : false
+  IsTitleForExistingLanguage: false
+  Key                       : 2209
+  NodeType                  : 0
+  Nodes                     : [{"AudienceIds":[],"CurrentLCID":1033,"CustomProperties":[],"FriendlyUrlSegment":"","IsDeleted":false,"IsHidden":false,"IsTitleForExistingLanguage":false,"Key":"2210","Nodes":[],"NodeType":0,"OpenInNewWindow":true,"SimpleUrl":"https://microsoft365.com","Title":"Microsoft 365","Translations":[]}]
+  OpenInNewWindow           : null
+  SimpleUrl                 : /sites/Marketing/Lists/Work Status/AllItems.aspx
+  Title                     : Work Status
+  Translations              : []
   ```
 
   </TabItem>
   <TabItem value="CSV">
 
   ```csv
-  CurrentLCID,Id,IsDocLib,IsExternal,IsVisible,ListTemplateType,Title,Url
-  1033,2209,1,,1,100,Work Status,/sites/Marketing/Lists/Work Status/AllItems.aspx
+  CurrentLCID,FriendlyUrlSegment,IsDeleted,IsHidden,IsTitleForExistingLanguage,Key,NodeType,OpenInNewWindow,SimpleUrl,Title
+  1033,,0,0,0,2209,0,,/sites/Marketing/Lists/Work Status/AllItems.aspx,Work Status
   ```
 
   </TabItem>
   <TabItem value="Markdown">
 
   ```md
-  # spo navigation node get --webUrl "https://contoso.sharepoint.com/sites/Marketing" --id "2209"
+  # spo navigation node get --webUrl "https://contoso.sharepoint.com/sites/Marketing" --location "QuickLaunch" --id "2209"
 
-  Date: 1/29/2023
+  Date: 10/7/2026
 
-  ## Work Status (2209)
+  ## Work Status
 
   Property | Value
   ---------|-------
   CurrentLCID | 1033
-  Id | 2209
-  IsDocLib | true
-  IsExternal | false
-  IsVisible | true
-  ListTemplateType | 100
+  FriendlyUrlSegment |
+  IsDeleted | false
+  IsHidden | false
+  IsTitleForExistingLanguage | false
+  Key | 2209
+  NodeType | 0
+  SimpleUrl | /sites/Marketing/Lists/Work Status/AllItems.aspx
   Title | Work Status
-  Url | /sites/Marketing/Lists/Work Status/AllItems.aspx
   ```
 
   </TabItem>

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/navigation/navigation-node-set.mdx

@@ -16,6 +16,9 @@ m365 spo navigation node set [options]
 `-u, --webUrl <webUrl>`
 : Absolute URL of the site.
 
+`-l, --location <location>`
+: Navigation type where the node is located. Available options: `QuickLaunch`, `TopNavigationBar`.
+
 `--id <id>`
 : Id of the navigation node.
 
@@ -26,10 +29,7 @@ m365 spo navigation node set [options]
 : New URL of the navigation node. Specify an empty string `""` to update the navigation label to a linkless label.
 
 `--audienceIds [audienceIds]`
-: Comma-separated list of group IDs that will be used for audience targeting. Speficy an empty string `""` to clear this value. The limit is 10 ids per navigation node.
-
-`--isExternal [isExternal]`
-: Whether the navigation node points to an external URL. Valid values: `true` or `false`.
+: Comma-separated list of group IDs that will be used for audience targeting. Specify an empty string `""` to clear this value. The limit is 10 ids per navigation node.
 
 `--openInNewWindow [openInNewWindow]`
 : Open the URL in a new window. Valid values: `true` or `false`.
@@ -41,30 +41,32 @@ m365 spo navigation node set [options]
 
 To enable/disable audience targeting for the navigation bar, use the [`spo web set`](../web/web-set.mdx) command.
 
+SharePoint doesn't allow changing the URL of a navigation node pointing to a page in the current site into an external URL. In that case, the URL isn't updated and no error is returned. To point such a node to an external URL, remove the node using [`spo navigation node remove`](./navigation-node-remove.mdx) and add it again using [`spo navigation node add`](./navigation-node-add.mdx).
+
 ## Examples
 
 Updates the title of a navigation node
 
 ```sh
-m365 spo navigation node set --webUrl https://contoso.sharepoint.com/sites/marketing --id 2209 --title "Pictures"
+m365 spo navigation node set --webUrl https://contoso.sharepoint.com/sites/marketing --location TopNavigationBar --id 2209 --title "Pictures"
 ```
 
 Updates the URL of a navigation node
 
 ```sh
-m365 spo navigation node set --webUrl https://contoso.sharepoint.com/sites/marketing --id 2209 --url "https://www.microsoft.com" --isExternal true
+m365 spo navigation node set --webUrl https://contoso.sharepoint.com/sites/marketing --location QuickLaunch --id 2209 --url "https://www.microsoft.com"
 ```
 
 Updates audience targeting of a navigation node with 3 groups
 
 ```sh
-m365 spo navigation node set --webUrl https://contoso.sharepoint.com/sites/marketing --id 2209 --audienceIds "61f78c73-f71a-471e-a3b9-15daa936e200,9524e6b4-e663-44fe-b179-210c963e37e7,c42b8756-494d-4141-a575-45f01320e26a"
+m365 spo navigation node set --webUrl https://contoso.sharepoint.com/sites/marketing --location QuickLaunch --id 2209 --audienceIds "61f78c73-f71a-471e-a3b9-15daa936e200,9524e6b4-e663-44fe-b179-210c963e37e7,c42b8756-494d-4141-a575-45f01320e26a"
 ```
 
 Updates the navigation node so that it opens in a new window
 
 ```sh
-m365 spo navigation node set --webUrl https://contoso.sharepoint.com/sites/marketing --id 2209 --openInNewWindow true
+m365 spo navigation node set --webUrl https://contoso.sharepoint.com/sites/marketing --location QuickLaunch --id 2209 --openInNewWindow true
 ```
 
 ## Response

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

@@ -34,8 +34,6 @@ m365 spo orgassetslibrary list
 
 ## Response
 
-### Standard response
-
 <Tabs>
   <TabItem value="JSON">
 
@@ -86,22 +84,3 @@ m365 spo orgassetslibrary list
 
   </TabItem>
 </Tabs>
-
-### Response when no library is assigned as asset library
-
-<Tabs>
-  <TabItem value="Text">
-
-  ```text
-  No libraries in Organization Assets
-  ```
-
-  </TabItem>
-  <TabItem value="Markdown">
-
-  ```md
-  No libraries in Organization Assets
-  ```
-
-  </TabItem>
-</Tabs>