@pnp/cli-microsoft365 6.2.0 → 6.3.0-beta.37c6261

package/docs/docs/cmd/spo/file/file-sharinglink-clear.md

@@ -0,0 +1,46 @@
+# spo file sharinglink clear
+
+Removes sharing links of a file
+
+## Usage
+
+```sh
+m365 spo file sharinglink clear [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: The URL of the site where the file is located.
+
+`--fileUrl [fileUrl]`
+: The server-relative (decoded) URL of the file. Specify either `fileUrl` or `fileId` but not both.
+
+`--fileId [fileId]`
+: The UniqueId (GUID) of the file. Specify either `fileUrl` or `fileId` but not both.
+
+`-s, --scope [scope]`
+: Scope of the sharing link. Possible options are: `anonymous`, `users` or `organization`. If not specified, all links will be removed.
+
+`--confirm`
+: Don't prompt for confirmation.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Removes all sharing links from a file specified by id without prompting for confirmation
+
+```sh
+m365 spo file sharinglink clear --webUrl https://contoso.sharepoint.com/sites/demo --fileId daebb04b-a773-4baa-b1d1-3625418e3234 --confirm
+```
+
+Removes sharing links of type anonymous from a file specified by url with prompting for confirmation
+
+```sh
+m365 spo file sharinglink clear --webUrl https://contoso.sharepoint.com/sites/demo --fileUrl '/sites/demo/Shared Documents/document.docx' --scope anonymous
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spo/file/file-sharinglink-list.md

@@ -19,7 +19,7 @@ m365 spo file sharinglink list [options]
 `--fileId [fileId]`
 : The UniqueId (GUID) of the file. Specify either `fileUrl` or `fileId` but not both.
 
-`--scope [scope]`
+`-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.
 
 --8<-- "docs/cmd/_global.md"

package/docs/docs/cmd/spo/file/file-sharinglink-set.md

@@ -0,0 +1,104 @@
+# spo file sharinglink set
+
+Updates a sharing link of a file
+
+## Usage
+
+```sh
+m365 spo file sharinglink set [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+:	The URL of the site where the file is located.
+
+`--fileUrl [fileUrl]`
+:	The server-relative (decoded) URL of the file. Specify either `fileUrl` or `fileId` but not both.
+
+`--fileId [fileId]`
+:	The UniqueId (GUID) of the file. Specify either `fileUrl` or `fileId` but not both.
+
+`--id <id>`
+: The ID of the sharing link.
+
+`--expirationDateTime <expirationDateTime>`
+:	The date and time to set the expiration. This should be defined as a valid ISO 8601 string. This options only works for anonymous links.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Updates an anonymous sharing link from a file by a specified site-relative URL with the expirationDateTime parameter
+
+```sh
+m365 spo file sharinglink set --webUrl https://contoso.sharepoint.com --fileUrl "/sites/demo/Shared Documents/Document.docx" --id 7c9f97c9-1bda-433c-9364-bb83e81771ee --expirationDateTime "2023-01-09T16:57:00.000Z"
+```
+
+Updates an anonymous sharing link from a file by id with the expirationDateTime parameter
+
+```sh
+m365 spo file sharinglink set --webUrl https://contoso.sharepoint.com --fileId daebb04b-a773-4baa-b1d1-3625418e3234 --id 7c9f97c9-1bda-433c-9364-bb83e81771ee --expirationDateTime "2023-01-09T16:57:00.000Z"
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "id": "7c9f97c9-1bda-433c-9364-bb83e81771ee",
+      "roles": [
+        "read"
+      ],
+      "expirationDateTime": "2023-02-09T16:57:00Z",
+      "hasPassword": false,
+      "grantedToIdentitiesV2": [],
+      "grantedToIdentities": [],
+      "link": {
+        "scope": "anonymous",
+        "type": "view",
+        "webUrl": "https://contoso.sharepoint.com/:b:/g/EbZx4QPyndlGp6HV-gvSPksBftmUNAiXjm0y-_527_fI9g",
+        "preventsDownload": false
+      }
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    expirationDateTime   : 2023-02-09T16:57:00Z
+    grantedToIdentities  : []
+    grantedToIdentitiesV2: []
+    hasPassword          : false
+    id                   : 7c9f97c9-1bda-433c-9364-bb83e81771ee
+    link                 : {"scope":"anonymous","type":"view","webUrl":"https://contoso.sharepoint.com/:b:/g/EbZx4QPyndlGp6HV-gvSPksBftmUNAiXjm0y-_527_fI9g","preventsDownload":false}
+    roles                : ["read"]
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,roles,expirationDateTime,hasPassword,grantedToIdentitiesV2,grantedToIdentities,link
+    7c9f97c9-1bda-433c-9364-bb83e81771ee,"[""read""]",2023-02-09T16:57:00Z,,[],[],"{""scope"":""anonymous"",""type"":""view"",""webUrl"":""https://contoso.sharepoint.com/:b:/g/EbZx4QPyndlGp6HV-gvSPksBftmUNAiXjm0y-_527_fI9g"",""preventsDownload"":false}"
+    ```
+
+=== "Markdown"
+
+    ```md
+    # spo file sharinglink set --webUrl "https://contoso.sharepoint.com" --fileUrl "/sites/demo/Shared Documents/Document.docx" --expirationDateTime "2023-02-09T16:57:00.000Z" --id "7c9f97c9-1bda-433c-9364-bb83e81771ee"
+
+    Date: 5/2/2023
+
+    ## 7c9f97c9-1bda-433c-9364-bb83e81771ee
+
+    Property | Value
+    ---------|-------
+    id | 7c9f97c9-1bda-433c-9364-bb83e81771ee
+    roles | ["read"]
+    expirationDateTime | 2023-02-09T16:57:00Z
+    hasPassword | false
+    grantedToIdentitiesV2 | []
+    grantedToIdentities | []
+    link | {"scope":"anonymous","type":"view","webUrl":"https://contoso.sharepoint.com/:b:/g/EbZx4QPyndlGp6HV-gvSPksBftmUNAiXjm0y-\_527\_fI9g","preventsDownload":false}
+    ```

package/docs/docs/cmd/spo/listitem/listitem-attachment-list.md

@@ -14,10 +14,10 @@ m365 spo listitem attachment list [options]
 URL of the site from which the item should be retrieved
 
 `--listId [listId]`
-: ID of the list where the item should be added. Specify either `listTitle`, `listId` or `listUrl`
+: ID of the list where the item should be retrieved. Specify either `listTitle`, `listId` or `listUrl`
 
 `--listTitle [listTitle]`
-: Title of the list where the item should be added. Specify either `listTitle`, `listId` or `listUrl`
+: Title of the list where the item should be retrieved. Specify either `listTitle`, `listId` or `listUrl`
 
 `--listUrl [listUrl]`
 : Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`

package/docs/docs/cmd/spo/listitem/listitem-isrecord.md

@@ -17,10 +17,10 @@ m365 spo listitem isrecord [options]
 : The ID of the list item to check if it is a record
 
 `-l, --listId [listId]`
-: ID of the list where the item should be added. Specify either `listTitle`, `listId` or `listUrl`
+: ID of the list where the item should be checked. Specify either `listTitle`, `listId` or `listUrl`
 
 `-t, --listTitle [listTitle]`
-: Title of the list where the item should be added. Specify either `listTitle`, `listId` or `listUrl`
+: Title of the list where the item should be checked. Specify either `listTitle`, `listId` or `listUrl`
 
 `--listUrl [listUrl]`
 : Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`

package/docs/docs/cmd/spo/navigation/navigation-node-add.md

@@ -28,8 +28,15 @@ m365 spo navigation node add [options]
 `--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.
+
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
+To enable/disable audience targeting for the navigation bar, use the [`spo web set`](../web/web-set.md) command.
+
 ## Examples
 
 Add a navigation node pointing to a SharePoint page to the top navigation
@@ -50,13 +57,21 @@ Add a navigation node below an existing node
 m365 spo navigation node add --webUrl https://contoso.sharepoint.com/sites/team-a --parentNodeId 2010 --title About --url /sites/team-s/sitepages/about.aspx
 ```
 
+Add a navigation node to the top navigation which is audience targetted
+
+```sh
+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"
+```
+
 ## Response
 
 === "JSON"
 
     ```json
     {
-      "AudienceIds": null,
+      "AudienceIds": [
+        "7aa4a1ca-4035-4f2f-bac7-7beada59b5ba"
+      ],
       "CurrentLCID": 1033,
       "Id": 2030,
       "IsDocLib": true,
@@ -71,7 +86,7 @@ m365 spo navigation node add --webUrl https://contoso.sharepoint.com/sites/team-
 === "Text"
 
     ```text
-    AudienceIds     : null
+    AudienceIds     : ["7aa4a1ca-4035-4f2f-bac7-7beada59b5ba"]
     CurrentLCID     : 1033
     Id              : 2031
     IsDocLib        : true
@@ -86,5 +101,5 @@ m365 spo navigation node add --webUrl https://contoso.sharepoint.com/sites/team-
 
     ```csv
     AudienceIds,CurrentLCID,Id,IsDocLib,IsExternal,IsVisible,ListTemplateType,Title,Url
-    ,1033,2032,1,1,1,0,Navigation Link,https://contoso.sharepoint.com
+    "[""7aa4a1ca-4035-4f2f-bac7-7beada59b5ba""]",1033,2032,1,1,1,0,Navigation Link,https://contoso.sharepoint.com
     ```

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

@@ -39,7 +39,15 @@ m365 spo navigation node list --webUrl https://contoso.sharepoint.com/sites/team
     ```json
     [
       {
+        "AudienceIds": [
+          "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"
       }
@@ -60,3 +68,25 @@ m365 spo navigation node list --webUrl https://contoso.sharepoint.com/sites/team
     Id,Title,Url
     2032,Navigation Link,https://contoso.sharepoint.com
     ```
+
+=== "Markdown"
+
+    ```md
+    # spo navigation node list --webUrl "https://contoso.sharepoint.com" --location "QuickLaunch"
+
+    Date: 27/1/2023
+
+    ## Home (1031)
+
+    Property | Value
+    ---------|-------
+    AudienceIds | ["5786b8e8-c495-4734-b345-756733960730"]
+    CurrentLCID | 1033
+    Id | 2032
+    IsDocLib | true
+    IsExternal | false
+    IsVisible | true
+    ListTemplateType | 0
+    Title | Navigation Link
+    Url | https://contoso.sharepoint.com
+    ```

package/docs/docs/cmd/spo/navigation/navigation-node-remove.md

@@ -14,7 +14,7 @@ m365 spo navigation node remove [options]
 : Absolute URL of the site to which navigation should be modified
 
 `-l, --location <location>`
-: Navigation type where the node should be added. Available options: `QuickLaunch,TopNavigationBar`
+: Navigation type where the node should be removed. Available options: `QuickLaunch,TopNavigationBar`
 
 `-i, --id <id>`
 : ID of the node to remove

package/docs/docs/cmd/spo/navigation/navigation-node-set.md

@@ -0,0 +1,59 @@
+# spo navigation node set
+
+Updates a SharePoint navigation node
+
+## Usage
+
+```sh
+m365 spo navigation node set [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: Absolute URL of the site.
+
+`--id <id>`
+: Id of the navigation node.
+
+`--title [title]`
+: New title of the navigation node.
+
+`--url [url]`
+: New URL of the navigation node.
+
+`--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`.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+To enable/disable audience targeting for the navigation bar, use the [`spo web set`](../web/web-set.md) command.
+
+## 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"
+```
+
+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
+```
+
+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"
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spo/web/web-set.md

@@ -37,6 +37,9 @@ m365 spo web set [options]
 `--footerEnabled [footerEnabled]`
 : Set to `true` to enable footer and to `false` to disable it
 
+`--navAudienceTargetingEnabled [navAudienceTargetingEnabled]`
+: Enable or disable site navigation audience targeting. Allowed values: `true` or `false`.
+
 `--searchScope [searchScope]`
 : Search scope to set in the site. Allowed values `DefaultScope,Tenant,Hub,Site`
 
@@ -87,6 +90,12 @@ Hide footer in the site
 m365 spo web set --url https://contoso.sharepoint.com/sites/team-a --footerEnabled false
 ```
 
+Enable navigation audience targetting in the site
+
+```sh
+m365 spo web set --url https://contoso.sharepoint.com/sites/team-a --navAudienceTargetingEnabled true
+```
+
 Set search scope to tenant scope
 
 ```sh

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "6.2.0",
+  "version": "6.3.0",
   "lockfileVersion": 2,
   "requires": true,
   "packages": {
     "": {
       "name": "@pnp/cli-microsoft365",
-      "version": "6.2.0",
+      "version": "6.3.0",
       "license": "MIT",
       "dependencies": {
         "@azure/msal-node": "^1.14.5",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "6.2.0",
+  "version": "6.3.0-beta.37c6261",
   "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
   "license": "MIT",
   "main": "./dist/api.js",
@@ -272,4 +272,4 @@
     "sinon": "^15.0.1",
     "source-map-support": "^0.5.21"
   }
-}
+}