@pnp/cli-microsoft365 6.3.0-beta.c3dc921 → 6.3.0-beta.fee5cdb

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

@@ -0,0 +1,91 @@
+# spo navigation node get
+
+Gets information about a specific navigation node.
+
+## Usage
+
+```sh
+m365 spo navigation node get [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: Absolute URL of the site.
+
+`--id <id>`
+: Id of the navigation node.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Retrieve information for a specific navigation node.
+
+```sh
+m365 spo navigation node get --webUrl https://contoso.sharepoint.com/sites/team-a --id 2209
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "AudienceIds": [
+        "0d718612-8407-4d6b-833c-6891a553354f",
+        "f864446f-b4d7-475a-a2ba-1080c6474020"
+      ],
+      "CurrentLCID": 1033,
+      "Id": 2209,
+      "IsDocLib": true,
+      "IsExternal": false,
+      "IsVisible": true,
+      "ListTemplateType": 100,
+      "Title": "Work Status",
+      "Url": "/sites/team-a/Lists/Work Status/AllItems.aspx"
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    AudienceIds     : ["0d718612-8407-4d6b-833c-6891a553354f", "f864446f-b4d7-475a-a2ba-1080c6474020"]
+    CurrentLCID     : 1033
+    Id              : 2209
+    IsDocLib        : true
+    IsExternal      : false
+    IsVisible       : true
+    ListTemplateType: 100
+    Title           : Work Status
+    Url             : /sites/team-a/Lists/Work Status/AllItems.aspx
+    ```
+
+=== "CSV"
+
+    ```csv
+    AudienceIds,CurrentLCID,Id,IsDocLib,IsExternal,IsVisible,ListTemplateType,Title,Url
+    [""0d718612-8407-4d6b-833c-6891a553354f"", ""f864446f-b4d7-475a-a2ba-1080c6474020""],1033,2209,1,,1,100,Work Status,/sites/team-a/Lists/Work Status/AllItems.aspx
+    ```
+
+=== "Markdown"
+
+    ```md
+    # spo navigation node get --webUrl "https://contoso.sharepoint.com/sites/team-a" --id "2209"
+
+    Date: 1/29/2023
+
+    ## Work Status (2209)
+
+    Property | Value
+    ---------|-------
+    AudienceIds | ["0d718612-8407-4d6b-833c-6891a553354f", "f864446f-b4d7-475a-a2ba-1080c6474020"]
+    CurrentLCID | 1033
+    Id | 2209
+    IsDocLib | true
+    IsExternal | false
+    IsVisible | true
+    ListTemplateType | 100
+    Title | Work Status
+    Url | /sites/team-a/Lists/Work Status/AllItems.aspx
+    ```

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/sitedesign/sitedesign-add.md

@@ -28,6 +28,9 @@ m365 spo sitedesign add [options]
 `-a, --previewImageAltText [previewImageAltText]`
 : The alt text description of the image for accessibility
 
+`--thumbnailUrl [thumbnailUrl]`
+: The new URL of a thumbnail image. If none is specified SharePoint will use a generic image
+
 `--isDefault`
 : Set if the site design is applied as the default site design
 

package/docs/docs/cmd/spo/tenant/tenant-applicationcustomizer-add.md

@@ -0,0 +1,59 @@
+# spo tenant applicationcustomizer add
+
+Add an application customizer as a tenant wide extension.
+
+## Usage
+
+```sh
+m365 spo tenant applicationcustomizer add [options]
+```
+
+## Options
+
+`-t, --title <title>`
+: The title of the Application Customizer.
+
+`-i, --clientSideComponentId <clientSideComponentId>`
+: The Client Side Component Id (GUID) of the application customizer.
+
+`-p, --clientSideComponentProperties [clientSideComponentProperties]`
+: The Client Side Component properties of the application customizer.
+
+`-w, --webTemplate [webTemplate]`
+: Optionally add a web template (e.g. STS#3, SITEPAGEPUBLISHING#0, etc) as a filter for what kind of sites the application customizer is registered on.
+
+--8<-- "docs/cmd/_global.md"
+
+!!! important
+    To use this command, you need to be a SharePoint Admin.
+
+## Remarks
+
+Running this command from the Windows Command Shell (cmd.exe) or PowerShell for Windows OS XP, 7, 8, 8.1 without bash installed might require additional formatting for command options that have JSON, XML or JavaScript values because the command shell treat quotes differently. For example, this is how ApplicationCustomizer user custom action can be created from the Windows cmd.exe:
+
+```sh
+m365 spo tenant applicationcustomizer add --title "YourAppCustomizer" --clientSideComponentId b41916e7-e69d-467f-b37f-ff8ecf8f99f2 --clientSideComponentProperties '{\"testMessage\":\"Test message\"}'
+```
+
+Note, how the clientSideComponentProperties option has escaped double quotes `'{\"testMessage\":\"Test message\"}'` compared to execution from bash `'{"testMessage":"Test message"}'`.
+
+!!! warning "Escaping JSON in PowerShell"
+    When using the `--clientSideComponentProperties` option it's possible to enter a JSON string. In PowerShell 5 to 7.2 [specific escaping rules](./../../../user-guide/using-cli.md#escaping-double-quotes-in-powershell) apply due to an issue. Remember that you can also use [file tokens](./../../../user-guide/using-cli.md#passing-complex-content-into-cli-options) instead.
+
+## Examples
+
+Adds an application customizer that's deployed tenant wide
+
+```sh
+m365 spo tenant applicationcustomizer add --title "Some customizer" --clientSideComponentId  799883f5-7962-4384-a10a-105adaec6ffc 
+```
+
+Adds an application customizer that is configured for all communication sites.
+
+```sh
+m365 spo tenant applicationcustomizer add --title "Some customizer" --clientSideComponentId  799883f5-7962-4384-a10a-105adaec6ffc --webTemplate "SITEPAGEPUBLISHING#0"
+```
+
+## 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/docs/docs/cmd/status.md

@@ -23,3 +23,49 @@ Show the information about the current login to the Microsoft 365
 ```sh
 m365 status
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "connectedAs": "john.doe@contoso.onmicrosoft.com",
+      "authType": "DeviceCode",
+      "appId": "31359c7f-bd7e-475c-86db-fdb8c937548e",
+      "appTenant": "common"
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    appId      : 31359c7f-bd7e-475c-86db-fdb8c937548e
+    appTenant  : common
+    authType   : DeviceCode
+    connectedAs: john.doe@contoso.onmicrosoft.com
+    ```
+
+=== "CSV"
+
+    ```csv
+    connectedAs,authType,appId,appTenant
+    john.doe@contoso.onmicrosoft.com,DeviceCode,31359c7f-bd7e-475c-86db-fdb8c937548e,common
+    ```
+
+=== "Markdown"
+
+    ```md
+    # status
+
+    Date: 7/2/2023
+
+
+
+    Property | Value
+    ---------|-------
+    connectedAs | john.doe@contoso.onmicrosoft.com
+    authType | DeviceCode
+    appId | 31359c7f-bd7e-475c-86db-fdb8c937548e
+    appTenant | common
+    ```

package/docs/docs/cmd/version.md

@@ -19,3 +19,29 @@ Show the version of CLI for Microsoft 365
 ```sh
 m365 version
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    v6.3.0
+    ```
+
+=== "Text"
+
+    ```text
+    v6.3.0
+    ```
+
+=== "CSV"
+
+    ```csv
+    v6.3.0
+    ```
+
+=== "Markdown"
+
+    ```md
+    v6.3.0
+    ```