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

package/docs/docs/cmd/spo/list/list-view-list.md

@@ -121,3 +121,64 @@ m365 spo list view list --webUrl https://contoso.sharepoint.com/sites/project-x
     Id,Title,DefaultView,Hidden,BaseViewId
     3cd2e934-f482-4d4a-a9b8-a13b49b3d226,All events,,,1
     ```
+
+=== "Markdown"
+
+    ```md
+    # spo list view list --webUrl "https://contoso.sharepoint.com" --listTitle "My List"
+
+    Date: 2/20/2023
+
+    ## All Items (6275ed5c-8e4f-4e81-8060-2d9162b29952)
+
+    Property | Value
+    ---------|-------
+    Aggregations | null
+    AggregationsStatus | null
+    AssociatedContentTypeId | null
+    BaseViewId | 1
+    CalendarViewStyles | null
+    ColumnWidth | null
+    ContentTypeId | {"StringValue":"0x"}
+    CustomFormatter |
+    CustomOrder | null
+    DefaultView | true
+    DefaultViewForContentType | false
+    EditorModified | false
+    Formats | null
+    GridLayout | null
+    Hidden | false
+    HtmlSchemaXml | <View Name="{6275ED5C-8E4F-4E81-8060-2D9162B29952}" DefaultView="TRUE" MobileView="TRUE" MobileDefaultView="TRUE" Type="HTML" DisplayName="All Items" Url="/teams/AllStars/Lists/My List/AllItems.aspx" Level="1" BaseViewID="1" ContentTypeID="0x" ImageUrl="/\_layouts/15/images/generic.png?rev=47"><Query /><ViewFields><FieldRef Name="LinkTitle" /><FieldRef Name="FieldName1" /></ViewFields><Toolbar Type="Standard" /><CustomFormatter /><XslLink Default="TRUE">main.xsl</XslLink><JSLink>clienttemplates.js</JSLink><RowLimit Paged="TRUE">30</RowLimit><ParameterBindings><ParameterBinding Name="NoAnnouncements" Location="Resource(wss,noXinviewofY\_LIST)" /><ParameterBinding Name="NoAnnouncementsHowTo" Location="Resource(wss,noXinviewofY\_DEFAULT)" /></ParameterBindings></View>
+    Id | 6275ed5c-8e4f-4e81-8060-2d9162b29952
+    ImageUrl | /\_layouts/15/images/generic.png?rev=47
+    IncludeRootFolder | false
+    ViewJoins | null
+    JSLink | clienttemplates.js
+    ListViewXml | <View Name="{6275ED5C-8E4F-4E81-8060-2D9162B29952}" DefaultView="TRUE" MobileView="TRUE" MobileDefaultView="TRUE" Type="HTML" DisplayName="All Items" Url="/teams/AllStars/Lists/My List/AllItems.aspx" Level="1" BaseViewID="1" ContentTypeID="0x" ImageUrl="/\_layouts/15/images/generic.png?rev=47" ><Query /><ViewFields><FieldRef Name="LinkTitle" /><FieldRef Name="FieldName1" /></ViewFields><RowLimit Paged="TRUE">30</RowLimit><JSLink>clienttemplates.js</JSLink><XslLink Default="TRUE">main.xsl</XslLink><CustomFormatter /><Toolbar Type="Standard"/></View>
+    Method | null
+    MobileDefaultView | true
+    MobileView | true
+    ModerationType | null
+    NewDocumentTemplates | null
+    OrderedView | false
+    Paged | true
+    PersonalView | false
+    ViewProjectedFields | null
+    ViewQuery |
+    ReadOnlyView | false
+    RequiresClientIntegration | false
+    RowLimit | 30
+    Scope | 0
+    ServerRelativePath | {"DecodedUrl":"/teams/AllStars/Lists/My List/AllItems.aspx"}
+    ServerRelativeUrl | /teams/AllStars/Lists/My List/AllItems.aspx
+    StyleId | null
+    TabularView | true
+    Threaded | false
+    Title | All Items
+    Toolbar |
+    ToolbarTemplateName | null
+    ViewType | HTML
+    ViewData | null
+    ViewType2 | null
+    VisualizationInfo | null
+    ```

package/docs/docs/cmd/spo/list/list-view-set.md

@@ -19,7 +19,7 @@ m365 spo list view set [options]
 `--listTitle [listTitle]`
 : Title of the list where the view is located. Specify either `listId`, `listTitle`, or `listUrl`.
 
- `--listUrl [listUrl]`
+`--listUrl [listUrl]`
 : Server- or site-relative URL of the list. Specify either `listId` , `listTitle` or `listUrl`.
 
 `--id [id]`

package/docs/docs/cmd/spo/list/list-webhook-add.md

@@ -86,3 +86,22 @@ m365 spo list webhook add --webUrl https://contoso.sharepoint.com/sites/ninja --
     clientState,expirationDateTime,id,notificationUrl,resource,resourceData
     random client state,2019-05-29T23:00:00.000Z,ef69c37d-cb0e-46d9-9758-5ebdeffd6959,https://contoso-funcions.azurewebsites.net/webhook,0987cfd9-f02c-479b-9fb4-3f0550462848,
     ```
+
+=== "Markdown"
+
+    ```md
+    # spo list webhook add --webUrl "https://contoso.sharepoint.com/sites/ninja" --listUrl "/sites/ninja/Documents" --notificationUrl "https://contoso-funcions.azurewebsites.net/webhook" --expirationDateTime "2019-01-21"
+
+    Date: 2/20/2023
+
+    ## ef69c37d-cb0e-46d9-9758-5ebdeffd6959
+
+    Property | Value
+    ---------|-------
+    clientState | random client state
+    expirationDateTime | 2019-05-29T23:00:00.000Z
+    id | ef69c37d-cb0e-46d9-9758-5ebdeffd6959
+    notificationUrl | https://contoso-funcions.azurewebsites.net/webhook
+    resource | 0987cfd9-f02c-479b-9fb4-3f0550462848
+    resourceData | null
+    ```

package/docs/docs/cmd/spo/list/list-webhook-get.md

@@ -83,3 +83,22 @@ m365 spo list webhook get --webUrl https://contoso.sharepoint.com/sites/project-
     clientState,expirationDateTime,id,notificationUrl,resource,resourceData
     system-managed:8082D436-D8DA-458D-96AD-34C902B73F37,2022-11-16T20:25:12.2735056Z,b8838bbb-9ddb-44fb-9016-0aacb9e02b77,https://northeurope1-0.pushnp.svc.ms/notifications?token=1e263e06-4bea-4db1-9f9f-5c8f713eef76,97d19285-b8a6-4c7f-9c6c-d6b850a6561a,
     ```
+
+=== "Markdown"
+
+    ```md
+    # spo list webhook get --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "Documents" --id "b8838bbb-9ddb-44fb-9016-0aacb9e02b77"
+
+    Date: 2/20/2023
+
+    ## b8838bbb-9ddb-44fb-9016-0aacb9e02b77
+
+    Property | Value
+    ---------|-------
+    clientState| system-managed:8082D436-D8DA-458D-96AD-34C902B73F37
+    expirationDateTime| 2022-11-16T20:25:12.2735056Z
+    id| b8838bbb-9ddb-44fb-9016-0aacb9e02b77
+    notificationUrl| https://northeurope1-0.pushnp.svc.ms/notifications?token=1e263e06-4bea-4db1-9f9f-5c8f713eef76
+    resource| 97d19285-b8a6-4c7f-9c6c-d6b850a6561a
+    resourceData| null
+    ```

package/docs/docs/cmd/spo/list/list-webhook-list.md

@@ -75,3 +75,22 @@ m365 spo list webhook list --webUrl https://contoso.sharepoint.com/sites/project
     id,clientState,expirationDateTime,resource
     b8838bbb-9ddb-44fb-9016-0aacb9e02b77,system-managed:8082D436-D8DA-458D-96AD-34C902B73F37,2022-11-16T20:25:12.2735056Z,97d19285-b8a6-4c7f-9c6c-d6b850a6561a
     ```
+
+=== "Markdown"
+
+    ```md
+    # spo list webhook list --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "Documents"
+
+    Date: 2/20/2023
+
+    ## b8838bbb-9ddb-44fb-9016-0aacb9e02b77
+
+    Property | Value
+    ---------|-------
+    clientState| system-managed:8082D436-D8DA-458D-96AD-34C902B73F37
+    expirationDateTime| 2022-11-16T20:25:12.2735056Z
+    id| b8838bbb-9ddb-44fb-9016-0aacb9e02b77
+    notificationUrl| https://northeurope1-0.pushnp.svc.ms/notifications?token=1e263e06-4bea-4db1-9f9f-5c8f713eef76
+    resource| 97d19285-b8a6-4c7f-9c6c-d6b850a6561a
+    resourceData| null
+    ```

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

@@ -132,3 +132,32 @@ m365 spo listitem add --listTitle "Demo List" --webUrl https://contoso.sharepoin
     FileSystemObjectType,Id,ServerRedirectedEmbedUri,ServerRedirectedEmbedUrl,ID,ContentTypeId,Title,Modified,Created,AuthorId,EditorId,OData__UIVersionString,Attachments,GUID,ComplianceAssetId,OData__vti_ItemDeclaredRecord
     0,235,,,235,0x01003CDBEB7138618C47A98D56499135D6EE0004C0F5794DEBCC4BAC981AC4AE1BD803,Test,2022-11-16T20:56:09Z,2022-11-16T20:56:09Z,10,10,1.0,,7aa8f3bd-a0a2-4974-81c8-2ac7ddc8e2d8,,
     ```
+
+=== "Markdown"
+
+    ```md
+    # spo listitem add --contentType "Item" --listTitle "My List" --webUrl "https://contoso.sharepoint.com/sites/project-x" --Title "Test"
+
+    Date: 2/20/2023
+
+    ## Test (234)
+
+    Property | Value
+    ---------|-------
+    FileSystemObjectType | 0
+    Id | 234
+    ServerRedirectedEmbedUri | null
+    ServerRedirectedEmbedUrl |
+    ContentTypeId | 0x01003CDBEB7138618C47A98D56499135D6EE0004C0F5794DEBCC4BAC981AC4AE1BD803
+    Title | Test
+    ComplianceAssetId | null
+    FieldName1 | null
+    ID | 234
+    Modified | 2022-11-16T20:55:45Z
+    Created | 2022-11-16T20:55:45Z
+    AuthorId | 10
+    EditorId | 10
+    OData\_\_UIVersionString | 1.0
+    Attachments | false
+    GUID | 352e3855-56fa-4b68-b6be-4644d6adf204
+    ```

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

@@ -11,19 +11,19 @@ m365 spo listitem attachment list [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-URL of the site from which the item should be retrieved
+: 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`
 
 `--itemId <itemId>`
-ID of the list item to in question
+: ID of the list item to in question
 
 --8<-- "docs/cmd/_global.md"
 
@@ -80,3 +80,18 @@ m365 spo listitem attachment list --webUrl https://contoso.sharepoint.com/sites/
     FileName,ServerRelativeUrl
     DummyDocument.docx,/Lists/Test/Attachments/236/DummyDocument.docx
     ```
+
+=== "Markdown"
+
+    ```md
+    # spo listitem attachment list --webUrl "https://contoso.sharepoint.com" --listTitle "Test" --itemId "236"
+
+    Date: 2/20/2023
+
+    Property | Value
+    ---------|-------
+    FileName | DummyDocument.docx
+    FileNameAsPath | {"DecodedUrl":"DummyDocument.docx"}
+    ServerRelativePath | {"DecodedUrl":"/Lists/Test/Attachments/236/DummyDocument.docx"}
+    ServerRelativeUrl | /Lists/Test/Attachments/236/DummyDocument.docx
+    ```

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

@@ -118,6 +118,34 @@ m365 spo listitem get --listTitle "Demo List" --id 147 --webUrl https://contoso.
     0,147,,,0x010078BC2C6F12F0DB41BA554210A2BFA81600A320A11ABE6E90468525ECC747660126,Demo Item,2022-10-30T10:55:37Z,2022-10-30T10:55:22Z,10,10,3.0,,87f3138d-fac3-4126-97c0-543e55672261,
     ```
 
+=== "Markdown"
+
+    ```md
+    # spo listitem get --webUrl "https://contoso.sharepoint.com" --listTitle "My List" --id "147"
+
+    Date: 2/20/2023
+
+    ## Demo Item (147)
+
+    Property | Value
+    ---------|-------
+    FileSystemObjectType | 0
+    Id | 147
+    ServerRedirectedEmbedUri | null
+    ServerRedirectedEmbedUrl |
+    ContentTypeId | 0x010078BC2C6F12F0DB41BA554210A2BFA81600A320A11ABE6E90468525ECC747660126
+    Title | Demo Item
+    ComplianceAssetId | null
+    FieldName1 | null
+    Modified | 2022-10-30T10:55:37Z
+    Created | 2022-10-30T10:55:22Z
+    AuthorId | 10
+    EditorId | 10
+    OData\_\_UIVersionString | 3.0
+    Attachments | false
+    GUID | 87f3138d-fac3-4126-97c0-543e55672261
+    ```
+
 ### `withPermissions` response
 
 When we make use of the option `withPermissions` the response will differ. 
@@ -242,3 +270,32 @@ When we make use of the option `withPermissions` the response will differ.
     FileSystemObjectType,Id,ServerRedirectedEmbedUri,ServerRedirectedEmbedUrl,ContentTypeId,Title,Modified,Created,AuthorId,EditorId,OData__UIVersionString,Attachments,GUID,ComplianceAssetId,RoleAssignments
     0,147,,,0x010078BC2C6F12F0DB41BA554210A2BFA81600A320A11ABE6E90468525ECC747660126,Demo Item,2022-10-30T10:55:37Z,2022-10-30T10:55:22Z,10,10,3.0,,87f3138d-fac3-4126-97c0-543e55672261,"[{""Member"":{""Id"":3,""IsHiddenInUI"":false,""LoginName"":""Communication site Owners"",""Title"":""Communication site Owners"",""PrincipalType"":8,""AllowMembersEditMembership"":false,""AllowRequestToJoinLeave"":false,""AutoAcceptRequestToJoinLeave"":false,""Description"":null,""OnlyAllowMembersViewMembership"":false,""OwnerTitle"":""Communication site Owners"",""RequestToJoinLeaveEmailSetting"":""""},""RoleDefinitionBindings"":[{""BasePermissions"":{""High"":""2147483647"",""Low"":""4294967295""},""Description"":""Has full control."",""Hidden"":false,""Id"":1073741829,""Name"":""Full Control"",""Order"":1,""RoleTypeKind"":5,""BasePermissionsValue"":[""ViewListItems"",""AddListItems"",""EditListItems"",""DeleteListItems"",""ApproveItems"",""OpenItems"",""ViewVersions"",""DeleteVersions"",""CancelCheckout"",""ManagePersonalViews"",""ManageLists"",""ViewFormPages"",""AnonymousSearchAccessList"",""Open"",""ViewPages"",""AddAndCustomizePages"",""ApplyThemeAndBorder"",""ApplyStyleSheets"",""ViewUsageData"",""CreateSSCSite"",""ManageSubwebs"",""CreateGroups"",""ManagePermissions"",""BrowseDirectories"",""BrowseUserInfo"",""AddDelPrivateWebParts"",""UpdatePersonalWebParts"",""ManageWeb"",""AnonymousSearchAccessWebLists"",""UseClientIntegration"",""UseRemoteAPIs"",""ManageAlerts"",""CreateAlerts"",""EditMyUserInfo"",""EnumeratePermissions""],""RoleTypeKindValue"":""Administrator""}],""PrincipalId"":3}]"
     ```
+
+=== "Markdown"
+
+    ```md
+    # spo listitem get --webUrl "https://contoso.sharepoint.com" --listTitle "My List" --id "147" --withPermissions "true"
+
+    Date: 2/20/2023
+
+    ## Demo Item (1)
+
+    Property | Value
+    ---------|-------
+    FileSystemObjectType | 0
+    Id | 147
+    ServerRedirectedEmbedUri | null
+    ServerRedirectedEmbedUrl |
+    ContentTypeId | 0x010078BC2C6F12F0DB41BA554210A2BFA81600A320A11ABE6E90468525ECC747660126
+    Title | Demo Item
+    ComplianceAssetId | null
+    FieldName1 | null
+    Modified | 2022-10-30T10:55:37Z
+    Created | 2022-10-30T10:55:22Z
+    AuthorId | 10
+    EditorId | 10
+    OData\_\_UIVersionString | 3.0
+    Attachments | false
+    GUID | 87f3138d-fac3-4126-97c0-543e55672261
+    RoleAssignments | [{"Member":{"Id":3,"IsHiddenInUI":false,"LoginName":"Communication site Owners","Title":"Communication site Owners","PrincipalType":8,"AllowMembersEditMembership":false,"AllowRequestToJoinLeave":false,"AutoAcceptRequestToJoinLeave":false,"Description":null,"OnlyAllowMembersViewMembership":false,"OwnerTitle":"Communication site Owners","RequestToJoinLeaveEmailSetting":""},"RoleDefinitionBindings":[{"BasePermissions":{"High":"2147483647","Low":"4294967295"},"Description":"Has full control.","Hidden":false,"Id":1073741829,"Name":"Full Control","Order":1,"RoleTypeKind":5,"BasePermissionsValue":["ViewListItems","AddListItems","EditListItems","DeleteListItems","ApproveItems","OpenItems","ViewVersions","DeleteVersions","CancelCheckout","ManagePersonalViews","ManageLists","ViewFormPages","AnonymousSearchAccessList","Open","ViewPages","AddAndCustomizePages","ApplyThemeAndBorder","ApplyStyleSheets","ViewUsageData","CreateSSCSite","ManageSubwebs","CreateGroups","ManagePermissions","BrowseDirectories","BrowseUserInfo","AddDelPrivateWebParts","UpdatePersonalWebParts","ManageWeb","AnonymousSearchAccessWebLists","UseClientIntegration","UseRemoteAPIs","ManageAlerts","CreateAlerts","EditMyUserInfo","EnumeratePermissions"],"RoleTypeKindValue":"Administrator"}],"PrincipalId":3}]
+    ```

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`
@@ -66,3 +66,9 @@ m365 spo listitem isrecord --webUrl https://contoso.sharepoint.com/sites/project
     ```csv
     false
     ```
+
+=== "Markdown"
+
+    ```md
+    false
+    ```

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

@@ -135,3 +135,31 @@ m365 spo listitem list --listUrl /sites/project-x/documents --webUrl https://con
     FileSystemObjectType,Id,ServerRedirectedEmbedUri,ServerRedirectedEmbedUrl,ContentTypeId,Title,Modified,Created,AuthorId,EditorId,OData__UIVersionString,Attachments,GUID,ComplianceAssetId,OData__vti_ItemDeclaredRecord
     0,236,,,0x01003CDBEB7138618C47A98D56499135D6EE0004C0F5794DEBCC4BAC981AC4AE1BD803,Test,2022-11-16T21:00:03Z,2022-11-16T20:56:31Z,10,10,6.0,1,cac57513-e870-4e7a-9f23-f4ea10e14f4e,,
     ```
+
+=== "Markdown"
+
+    ```md
+    # spo listitem list --webUrl "https://contoso.sharepoint.com" --listTitle "My List"
+
+    Date: 2/20/2023
+
+    ## Demo Item (147)
+
+    Property | Value
+    ---------|-------
+    FileSystemObjectType | 0
+    Id | 236
+    ServerRedirectedEmbedUri | null
+    ServerRedirectedEmbedUrl |
+    ContentTypeId | 0x01003CDBEB7138618C47A98D56499135D6EE0004C0F5794DEBCC4BAC981AC4AE1BD803
+    Title | Test
+    ComplianceAssetId | null
+    Modified | 2022-11-16T21:00:03Z
+    Created | 2022-11-16T20:56:31Z
+    AuthorId | 10
+    EditorId | 10
+    OData\_\_UIVersionString | 6.0
+    Attachments | false
+    GUID | cac57513-e870-4e7a-9f23-f4ea10e14f4e
+    OData__vti_ItemDeclaredRecord | null
+    ```

package/docs/docs/cmd/spo/listitem/listitem-record-declare.md

@@ -84,3 +84,18 @@ m365 spo listitem record declare --webUrl https://contoso.sharepoint.com/sites/p
     SchemaVersion,LibraryVersion,ErrorInfo,TraceCorrelationId
     15.0.0.0,16.0.23102.12004,,0d4779a0-609c-5000-843d-c98e4764c937
     ```
+
+=== "Markdown"
+
+    ```md
+    # spo listitem record declare --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "Demo List" --listItemId "1" --date "2012-03-14"
+    
+    Date: 2/20/2023
+
+    Property | Value
+    ---------|-------
+    SchemaVersion | 15.0.0.0
+    LibraryVersion | 16.0.23102.12004
+    ErrorInfo | null
+    TraceCorrelationId | 064779a0-d05b-5000-843d-c36803e58f12
+    ```

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

@@ -129,3 +129,33 @@ m365 spo listitem set --listTitle "Demo List" --id 147 --webUrl https://contoso.
     FileSystemObjectType,Id,ServerRedirectedEmbedUri,ServerRedirectedEmbedUrl,ID,ContentTypeId,Title,Modified,Created,AuthorId,EditorId,OData__UIVersionString,Attachments,GUID,ComplianceAssetId,OData__vti_ItemDeclaredRecord
     0,236,,,236,0x01003CDBEB7138618C47A98D56499135D6EE0004C0F5794DEBCC4BAC981AC4AE1BD803,Updated Title,2022-11-16T21:10:55Z,2022-11-16T20:56:31Z,10,10,9.0,1,cac57513-e870-4e7a-9f23-f4ea10e14f4e,,
     ```
+
+=== "Markdown"
+
+    ```md
+    # spo listitem set --listTitle "My List" --id "236" --webUrl "https://contoso.sharepoint.com" --Title "Updated Title"
+
+    Date: 2/20/2023
+
+    ## Updated Title (236)
+
+    Property | Value
+    ---------|-------
+    FileSystemObjectType | 0
+    Id | 236
+    ServerRedirectedEmbedUri | null
+    ServerRedirectedEmbedUrl |
+    ContentTypeId | 0x01003CDBEB7138618C47A98D56499135D6EE0004C0F5794DEBCC4BAC981AC4AE1BD803
+    Title | Updated Title
+    ComplianceAssetId | null
+    FieldName1 | null
+    ID | 236
+    Modified | 2022-11-16T21:10:06Z
+    Created | 2022-11-16T20:56:31Z
+    AuthorId | 10
+    EditorId | 10
+    OData\_\_UIVersionString | 7.0
+    Attachments | true
+    GUID | cac57513-e870-4e7a-9f23-f4ea10e14f4e
+    OData__vti_ItemDeclaredRecord | null
+    ```

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,27 @@ 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
+    ```
+
+=== "Markdown"
+
+    ```md
+    # spo navigation node get --webUrl "https://contoso.sharepoint.com/sites/team-a" --location "TopNavigationBar" --title "Navigation Link" --url "https://contoso.sharepoint.com"
+
+    Date: 2/20/2023
+
+    ## Navigation Link (2030)
+
+    Property | Value
+    ---------|-------
+    AudienceIds | ["7aa4a1ca-4035-4f2f-bac7-7beada59b5ba"]
+    CurrentLCID | 1033
+    Id | 2030
+    IsDocLib | true
+    IsExternal | false
+    IsVisible | true
+    ListTemplateType | 0
+    Title | Navigation Link
+    Url | https://contoso.sharepoint.com
     ```

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