@pnp/cli-microsoft365 6.3.0 → 6.4.0-beta.39e5130

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

@@ -11,10 +11,13 @@ m365 spo customaction get [options]
 ## Options
 
 `-i, --id [id]`
-: ID of the user custom action to retrieve information for. Specify either `id` or `title`
+: ID of the user custom action to retrieve information for. Specify either `id`, `title` or `clientSideComponentId`
 
 `-t, --title [title]`
-: Title of the user custom action to retrieve information for. Specify either `id` or `title`
+: Title of the user custom action to retrieve information for. Specify either `id`, `title` or `clientSideComponentId`
+
+`-c, --clientSideComponentId [clientSideComponentId]`
+: clientSideComponentId of the user custom action to retrieve information for. Specify either `id`, `title` or `clientSideComponentId`
 
 `-u, --webUrl <webUrl>`
 : Url of the site or site collection to retrieve the custom action from
@@ -26,34 +29,133 @@ m365 spo customaction get [options]
 
 ## Remarks
 
-If the command finds multiple user custom actions with the specified title, it will prompt you to disambiguate which user custom action it should use, listing the discovered IDs.
+If the command finds multiple user custom actions with the specified `title` or `clientSideComponentId`, it will prompt you to disambiguate which user custom action it should get, listing the discovered IDs.
 
 ## Examples
 
-Return details about the user custom action with ID _058140e3-0e37-44fc-a1d3-79c487d371a3_ located in site or site collection _https://contoso.sharepoint.com/sites/test_
+Return details about the user custom action based on the id and a given url
 
 ```sh
 m365 spo customaction get --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --webUrl https://contoso.sharepoint.com/sites/test
 ```
 
-Return details about the user custom action with Title _YourAppCustomizer_ located in site or site collection _https://contoso.sharepoint.com/sites/test_
+Return details about the user custom action based on the title and a given url
 
 ```sh
 m365 spo customaction get --title "YourAppCustomizer" --webUrl https://contoso.sharepoint.com/sites/test
 ```
 
-Return details about the user custom action with ID _058140e3-0e37-44fc-a1d3-79c487d371a3_ located in site collection _https://contoso.sharepoint.com/sites/test_
+Return details about the user custom action based on the clientSideComponentId and a given url
+
+```sh
+m365 spo customaction get --clientSideComponentId "34a019f9-6198-4053-a3b6-fbdea9a107fd" --webUrl https://contoso.sharepoint.com/sites/test
+```
+
+Return details about the user custom action based on the id and a given url and the scope
 
 ```sh
-m365 spo customaction get --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --webUrl https://contoso.sharepoint.com/sites/test --scope Site
+m365 spo customaction get --id "058140e3-0e37-44fc-a1d3-79c487d371a3" --webUrl https://contoso.sharepoint.com/sites/test --scope Site
 ```
 
-Return details about the user custom action with ID _058140e3-0e37-44fc-a1d3-79c487d371a3_ located in site _https://contoso.sharepoint.com/sites/test_
+Return details about the user custom action based on the id and a given url and the scope
 
 ```sh
-m365 spo customaction get --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --webUrl https://contoso.sharepoint.com/sites/test --scope Web
+m365 spo customaction get --id "058140e3-0e37-44fc-a1d3-79c487d371a3" --webUrl https://contoso.sharepoint.com/sites/test --scope Web
 ```
 
-## More information
+Return details about the user custom action based on the id and a given url and the scope
+
+```sh
+m365 spo customaction get --id "058140e3-0e37-44fc-a1d3-79c487d371a3" --webUrl https://contoso.sharepoint.com/sites/test --scope Web
+```
 
-- UserCustomAction REST API resources: [https://msdn.microsoft.com/en-us/library/office/dn531432.aspx#bk_UserCustomAction](https://msdn.microsoft.com/en-us/library/office/dn531432.aspx#bk_UserCustomAction)
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "ClientSideComponentId": "34a019f9-6198-4053-a3b6-fbdea9a107fd",
+      "ClientSideComponentProperties": "{\"sampleTextOne\":\"One item is selected in the list.\", \"sampleTextTwo\":\"This command is always visible.\"}",
+      "CommandUIExtension": null,
+      "Description": null,
+      "Group": null,
+      "Id": "158cb0d1-8703-4a36-866d-84aed8233bd3",
+      "ImageUrl": null,
+      "Location": "ClientSideExtension.ListViewCommandSet.CommandBar",
+      "Name": "{158cb0d1-8703-4a36-866d-84aed8233bd3}",
+      "RegistrationId": "100",
+      "RegistrationType": 1,
+      "Rights": "{\"High\":0,\"Low\":0}",
+      "Scope": "Web",
+      "ScriptBlock": null,
+      "ScriptSrc": null,
+      "Sequence": 65536,
+      "Title": "ExtensionTraining",
+      "Url": null,
+      "VersionOfUserCustomAction": "1.0.1.0"
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    ClientSideComponentId        : 34a019f9-6198-4053-a3b6-fbdea9a107fd
+    ClientSideComponentProperties: {"sampleTextOne":"One item is selected in the list.", "sampleTextTwo":"This command is always visible."}
+    CommandUIExtension           : null
+    Description                  : null
+    Group                        : null
+    Id                           : 158cb0d1-8703-4a36-866d-84aed8233bd3
+    ImageUrl                     : null
+    Location                     : ClientSideExtension.ListViewCommandSet.CommandBar
+    Name                         : {158cb0d1-8703-4a36-866d-84aed8233bd3}
+    RegistrationId               : 100
+    RegistrationType             : 1
+    Rights                       : {"High":0,"Low":0}
+    Scope                        : Web
+    ScriptBlock                  : null
+    ScriptSrc                    : null
+    Sequence                     : 65536
+    Title                        : ExtensionTraining
+    Url                          : null
+    VersionOfUserCustomAction    : 1.0.1.0
+    ```
+
+=== "CSV"
+
+    ```csv
+    ClientSideComponentId,ClientSideComponentProperties,CommandUIExtension,Description,Group,Id,ImageUrl,Location,Name,RegistrationId,RegistrationType,Rights,Scope,ScriptBlock,ScriptSrc,Sequence,Title,Url,VersionOfUserCustomAction
+    34a019f9-6198-4053-a3b6-fbdea9a107fd,"{""sampleTextOne"":""One item is selected in the list."", ""sampleTextTwo"":""This command is always visible.""}",,,,158cb0d1-8703-4a36-866d-84aed8233bd3,,ClientSideExtension.ListViewCommandSet.CommandBar,{158cb0d1-8703-4a36-866d-84aed8233bd3},100,1,"{""High"":0,""Low"":0}",Web,,,65536,ExtensionTraining,,1.0.1.0
+    ```
+
+=== "Markdown"
+
+    ```md
+    # spo customaction get --webUrl "https://contoso.sharepoint.com" --clientSideComponentId "34a019f9-6198-4053-a3b6-fbdea9a107fd" --scope "Web"
+
+    Date: 27/1/2023
+
+    ## ExtensionTraining (158cb0d1-8703-4a36-866d-84aed8233bd3)
+
+    Property | Value
+    ---------|-------
+    ClientSideComponentId | 34a019f9-6198-4053-a3b6-fbdea9a107fd
+    ClientSideComponentProperties | {"sampleTextOne":"One item is selected in the list.", "sampleTextTwo":"This command is always visible."}
+    CommandUIExtension | null
+    Description | null
+    Group | null
+    Id | 158cb0d1-8703-4a36-866d-84aed8233bd3
+    ImageUrl | null
+    Location | ClientSideExtension.ListViewCommandSet.CommandBar
+    Name | {158cb0d1-8703-4a36-866d-84aed8233bd3}
+    RegistrationId | 100
+    RegistrationType | 1
+    Rights | {"High":0,"Low":0}
+    Scope | Web
+    ScriptBlock | null
+    ScriptSrc | null
+    Sequence | 65536
+    Title | ExtensionTraining
+    Url | null
+    VersionOfUserCustomAction | 1.0.1.0
+    ```

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

@@ -27,6 +27,8 @@ m365 spo externaluser list [options]
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
 !!! important
     To use this command you have to have permissions to access the tenant admin site.
 

package/docs/docs/cmd/spo/group/group-member-add.md

@@ -20,16 +20,16 @@ m365 spo group member add [options]
 : Name of the SharePoint Group to which the user needs to be added, specify either `groupId` or `groupName`
 
 `--userName [userName]`
-: User's UPN (user principal name, eg. megan.bowen@contoso.com). If multiple users need to be added, they have to be comma separated (ex. megan.bowen@contoso.com,alex.wilber@contoso.com). Specify either `userId`, `userName`, `email`, `aadGroupId` or `aadGroupName`
+: User's UPN (user principal name, eg. megan.bowen@contoso.com). If multiple users need to be added, they have to be comma-separated (e.g. megan.bowen@contoso.com,alex.wilber@contoso.com). Specify either `userId`, `userName`, `email`, `aadGroupId` or `aadGroupName`
 
 `--email [email]`
-: User's email (eg. megan.bowen@contoso.com). If multiple users need to be added, they have to be comma separated (ex. megan.bowen@contoso.com,alex.wilber@contoso.com). Specify either `userId`, `userName`, `email`, `aadGroupId` or `aadGroupName`
+: User's email (eg. megan.bowen@contoso.com). If multiple users need to be added, they have to be comma-separated (e.g. megan.bowen@contoso.com,alex.wilber@contoso.com). Specify either `userId`, `userName`, `email`, `aadGroupId` or `aadGroupName`
 
 `--userId [userId]`
-: The user Id of the user to add as a member. (Id of the site user, for example: 14) If multiple users need to be added, the Ids have to be comma separated. Specify either `userId`, `userName`, `email`, `aadGroupId` or `aadGroupName`
+: The user Id of the user to add as a member. (Id of the site user, for example: 14) If multiple users need to be added, the Ids have to be comma-separated. Specify either `userId`, `userName`, `email`, `aadGroupId` or `aadGroupName`
 
 `--aadGroupId [aadGroupId]`
-: The object Id of the Azure AD group to add as a member. If multiple groups need to be added, the Ids have to be comma separated. Specify either `userId`, `userName`, `email`, `aadGroupId` or `aadGroupName`
+: The object Id of the Azure AD group to add as a member. If multiple groups need to be added, the Ids have to be comma-separated. Specify either `userId`, `userName`, `email`, `aadGroupId` or `aadGroupName`
 
 `--aadGroupName [aadGroupName]`
 : The name of the Azure AD group to add as a member. Specify either `userId`, `userName`, `email`, `aadGroupId` or `aadGroupName`
@@ -126,3 +126,25 @@ m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --
     DisplayName,Email
     John Doe,john.doe@contoso.onmicrosoft.com
     ```
+
+=== "Markdown"
+
+    ```md
+    # spo group member add --webUrl "https://contoso.sharepoint.com" --groupId "5" --aadGroupId "f2fb2f10-cfd2-4054-8ffd-64533657a5ab"
+
+    Date: 13/2/2023
+
+    ## All Company Members
+
+    Property | Value
+    ---------|-------
+    AllowedRoles | [0]
+    CurrentRole | 0
+    DisplayName | All Company Members
+    Email | allcompany@contoso.onmicrosoft.com
+    InvitationLink | null
+    IsUserKnown | true
+    Message | null
+    Status | true
+    User | c:0o.c\|federateddirectoryclaimprovider\|f2fb2f10-cfd2-4054-8ffd-64533657a5ab
+    ```

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

@@ -12,6 +12,8 @@ m365 spo hidedefaultthemes get [options]
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
 !!! important
     To use this command you have to have permissions to access the tenant admin site.
 

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

@@ -15,6 +15,8 @@ m365 spo hidedefaultthemes set [options]
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
 !!! important
     To use this command you have to have permissions to access the tenant admin site.
 

package/docs/docs/cmd/spo/homesite/homesite-remove.md

@@ -15,6 +15,8 @@ m365 spo homesite remove [options]
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
 !!! important
     To use this command you have to have permissions to access the tenant admin site.
 

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

@@ -15,6 +15,8 @@ m365 spo homesite set [options]
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
 !!! important
     To use this command you have to have permissions to access the tenant admin site.
 

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

@@ -12,6 +12,8 @@ m365 spo knowledgehub get [options]
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
 !!! important
     To use this command you have to have permissions to access the tenant admin site.
 

package/docs/docs/cmd/spo/knowledgehub/knowledgehub-remove.md

@@ -15,6 +15,8 @@ m365 spo knowledgehub remove [options]
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
 !!! important
     To use this command you have to have permissions to access the tenant admin site.
 

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

@@ -15,13 +15,13 @@ m365 spo knowledgehub set [options]
 
 --8<-- "docs/cmd/_global.md"
 
-!!! important
-    To use this command you have to have permissions to access the tenant admin site.
-
 ## Remarks
 
 If the specified url doesn't refer to an existing site collection, you will get a `404 - "404 FILE NOT FOUND"` error.
 
+!!! important
+    To use this command you have to have permissions to access the tenant admin site.
+    
 ## Examples
 
 Sets the Knowledge Hub Site for your tenant.

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

@@ -13,8 +13,8 @@ m365 spo list add [options]
 `-t, --title <title>`
 : Title of the list to add.
 
-`--baseTemplate <baseTemplate>`
-: The list definition type on which the list is based. Allowed values `Announcements`, `Contacts`, `CustomGrid`, `DataSources`,`DiscussionBoard`, `DocumentLibrary`, `Events`, `GanttTasks`, `GenericList`, `IssuesTracking`, `Links`, `NoCodeWorkflows`,`PictureLibrary`, `Survey`, `Tasks`, `WebPageLibrary`, `WorkflowHistory`, `WorkflowProcess`, `XmlForm`. Default `GenericList`.
+`--baseTemplate [baseTemplate]`
+: The list definition type on which the list is based. Allowed values `Announcements`, `Contacts`, `CustomGrid`, `DataSources`,`DiscussionBoard`, `DocumentLibrary`, `Events`, `GanttTasks`, `GenericList`, `IssuesTracking`, `Links`, `NoCodeWorkflows`,`PictureLibrary`, `Survey`, `Tasks`, `WebPageLibrary`, `WorkflowHistory`, `WorkflowProcess`, `XmlForm`. Default value is `GenericList`.
 
 `-u, --webUrl <webUrl>`
 : URL of the site where the list should be added.

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

@@ -59,7 +59,7 @@ m365 spo list set [options]
 : Property for assigning or retrieving grid editing on the list. Valid values are `true`, `false`.
 
 `--draftVersionVisibility [draftVersionVisibility]`
-: Value that specifies the minimum permission required to view minor versions and drafts within the list. Allowed values `Reader`, `Author`, `Approver`. Default `Reader`.
+: Value that specifies the minimum permission required to view minor versions and drafts within the list. Allowed values `Reader`, `Author`, `Approver`.
 
 `--emailAlias [emailAlias]`
 : If e-mail notification is enabled, gets or sets the e-mail address to use tonotify to the owner of an item when an assignment has changed or the item has been updated.
@@ -137,7 +137,7 @@ m365 spo list set [options]
 : Indicates whether this list should be treated as a top level navigation object or not.
 
 `--listExperienceOptions [listExperienceOptions]`
-: Gets or sets the list experience for the list. Allowed values `Auto`, `NewExperience`, `ClassicExperience`. Default `Auto`.
+: Gets or sets the list experience for the list. Allowed values `Auto`, `NewExperience`, `ClassicExperience`.
 
 `--majorVersionLimit [majorVersionLimit]`
 : Gets or sets the maximum number of major versions allowed for an item in a document library that uses version control with major versions only.

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

@@ -59,7 +59,7 @@ m365 spo listitem add --listTitle "Demo List" --webUrl https://contoso.sharepoin
 Add an item with Title _Demo Multi Person Field_ and a multi-select people field named _MultiPeopleField_ to list with title _Demo List_ in site _https://contoso.sharepoint.com/sites/project-x_
 
 ```sh
-m365 spo listitem add --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --Title "Demo Multi Person Field" --MultiPeopleField "[{'Key':'i:0#.f|membership|markh@conotoso.com'},{'Key':'i:0#.f|membership|adamb@conotoso.com'}]"
+m365 spo listitem add --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --Title "Demo Multi Person Field" --MultiPeopleField "[{'Key':'i:0#.f|membership|markh@conotoso.com'},{'Key':'i:0#.f|membership|john.doe@conotoso.com'}]"
 ```
 
 Add an item with Title _Demo Hyperlink Field_ and a hyperlink field named _CustomHyperlink_ to list with title _Demo List_ in site _https://contoso.sharepoint.com/sites/project-x_

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

@@ -53,7 +53,7 @@ A sample CSV can be found below. The first line of the CSV-file should contain t
 
 ```csv
 ContentType,Title,SingleChoiceField,MultiChoiceField,SingleMetadataField,MultiMetadataField,SinglePeopleField,MultiPeopleField,CustomHyperlink,NumberField
-Item,Title A,Choice 1,Choice 1;#Choice 2,Engineering|4a3cc5f3-a4a6-433e-a07a-746978ff1760;,Engineering|4a3cc5f3-a4a6-433e-a07a-746978ff1760;Finance|f994a4ac-cf34-448e-a22c-2b35fd9bbffa;,[{'Key':'i:0#.f|membership|markh@contoso.com'}],"[{'Key':'i:0#.f|membership|markh@contoso.com'},{'Key':'i:0#.f|membership|adamb@contoso.com'}]","https://bing.com, URL",5
+Item,Title A,Choice 1,Choice 1;#Choice 2,Engineering|4a3cc5f3-a4a6-433e-a07a-746978ff1760;,Engineering|4a3cc5f3-a4a6-433e-a07a-746978ff1760;Finance|f994a4ac-cf34-448e-a22c-2b35fd9bbffa;,[{'Key':'i:0#.f|membership|markh@contoso.com'}],"[{'Key':'i:0#.f|membership|markh@contoso.com'},{'Key':'i:0#.f|membership|john.doe@contoso.com'}]","https://bing.com, URL",5
 ```
 
 ## Response

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

@@ -62,7 +62,7 @@ m365 spo listitem set --listTitle "Demo List" --id 147 --webUrl https://contoso.
 Update an item with id _147_ with Title _Demo Multi Person Field_ and a multi-select people field named _MultiPeopleField_ to list with title _Demo List_ in site _https://contoso.sharepoint.com/sites/project-x_
 
 ```sh
-m365 spo listitem set --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --Title "Demo Multi Person Field" --MultiPeopleField "[{'Key':'i:0#.f|membership|markh@conotoso.com'},{'Key':'i:0#.f|membership|adamb@conotoso.com'}]"
+m365 spo listitem set --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --Title "Demo Multi Person Field" --MultiPeopleField "[{'Key':'i:0#.f|membership|markh@conotoso.com'},{'Key':'i:0#.f|membership|john.doe@conotoso.com'}]"
 ```
 
 Update the field _Title_ and _CustomHyperlink_ of an item with a specific id in a list retrieved by server-relative URL in a specific site

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

@@ -19,8 +19,8 @@ m365 spo navigation node add [options]
 `-t, --title <title>`
 : Navigation node title.
 
-`--url <url>`
-: Navigation node URL.
+`--url [url]`
+: Navigation node URL. When not specified a linkless label will be created.
 
 `--parentNodeId [parentNodeId]`
 : ID of the node below which the node should be added. Specify either `location` or `parentNodeId` but not both.
@@ -29,7 +29,7 @@ m365 spo navigation node add [options]
 : 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.
+: 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"
 

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

@@ -20,10 +20,10 @@ m365 spo navigation node set [options]
 : New title of the navigation node.
 
 `--url [url]`
-: New URL of the navigation node.
+: 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.
+: 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`.

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

@@ -21,6 +21,8 @@ m365 spo orgassetslibrary add [options]
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
 !!! important
     To use this command you have to have permissions to access the tenant admin site.
 

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

@@ -12,6 +12,8 @@ m365 spo orgassetslibrary list [options]
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
 !!! important
     To use this command you have to have permissions to access the tenant admin site.
 

package/docs/docs/cmd/spo/orgassetslibrary/orgassetslibrary-remove.md

@@ -18,6 +18,8 @@ m365 spo orgassetslibrary remove [options]
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
 !!! important
     To use this command you have to have permissions to access the tenant admin site.
 

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

@@ -12,6 +12,8 @@ m365 spo orgnewssite list [options]
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
 !!! important
     To use this command you have to have permissions to access the tenant admin site.
 

package/docs/docs/cmd/spo/orgnewssite/orgnewssite-remove.md

@@ -18,6 +18,8 @@ m365 spo orgnewssite remove [options]
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
 !!! important
     To use this command you have to have permissions to access the tenant admin site.
 

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

@@ -15,13 +15,13 @@ m365 spo orgnewssite set [options]
 
 --8<-- "docs/cmd/_global.md"
 
-!!! important
-    To use this command you have to have permissions to access the tenant admin site.
-
 ## Remarks
 
 Using the `-u, --url` option you can specify which site to add to the list of organizational news sites.
 
+!!! important
+    To use this command you have to have permissions to access the tenant admin site.
+    
 ## Examples
 
 Set a site as an organizational news site

package/docs/docs/cmd/spo/site/site-appcatalog-add.md

@@ -15,6 +15,8 @@ m365 spo site appcatalog add [options]
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
 !!! important
     To use this command you have to have permissions to access the tenant admin site.
 

package/docs/docs/cmd/spo/site/site-appcatalog-remove.md

@@ -15,13 +15,13 @@ m365 spo site appcatalog remove [options]
 
 --8<-- "docs/cmd/_global.md"
 
-!!! important
-    To use this command you have to have permissions to access the tenant admin site.
-
 ## Remarks
 
 While the command uses the term *'remove'*, like its equivalent PowerShell cmdlet, it does not remove the special library **Apps for SharePoint** from the site collection. Instead, it disables the site collection app catalog in that site. Packages deployed to the app catalog are not available within the site collection.
 
+!!! important
+    To use this command you have to have permissions to access the tenant admin site.
+    
 ## Examples
 
 Remove the site collection app catalog from specified site

package/docs/docs/cmd/spo/site/site-commsite-enable.md

@@ -18,6 +18,8 @@ m365 spo site commsite enable [options]
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
 !!! important
     To use this command you have to have permissions to access the tenant admin site.
 

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

@@ -27,15 +27,15 @@ m365 spo site list [options]
 
 --8<-- "docs/cmd/_global.md"
 
-!!! important
-    To use this command you have to have permissions to access the tenant admin site.
-
 ## Remarks
 
 Using the `-f, --filter` option you can specify which sites you want to retrieve. For example, to get sites with _project_ in their URL, use `Url -like 'project'` as the filter.
 
 When using the text output type, the command lists only the values of the `Title`, and `Url` properties of the site. When setting the output type to JSON, all available properties are included in the command output.
 
+!!! important
+    To use this command you have to have permissions to access the tenant admin site.
+    
 ## Examples
 
 List all sites in the currently connected tenant

package/docs/docs/cmd/spo/site/site-remove.md

@@ -27,9 +27,6 @@ m365 spo site remove [options]
 
 --8<-- "docs/cmd/_global.md"
 
-!!! important
-    To use this command you have to have permissions to access the tenant admin site.
-
 ## Remarks
 
 Deleting a site collection is by default asynchronous and depending on the current state of Microsoft 365, might take up to few minutes. If you're building a script with steps that require the site to be fully deleted, you should use the `--wait` flag. When using this flag, the `spo site remove` command will keep running until it received confirmation from Microsoft 365 that the site has been fully deleted.
@@ -38,6 +35,9 @@ If the site which you have selected to remove is groupified (Modern Team Site) a
 
 If the argument `--fromRecycleBin` is passed, the selected site will be permanently removed even if it's a groupified one.
 
+!!! important
+    To use this command you have to have permissions to access the tenant admin site.
+
 ## Examples
 
 Remove the specified site and place it in the Recycle Bin

package/docs/docs/cmd/spo/site/site-rename.md

@@ -30,13 +30,13 @@ m365 spo site rename [options]
 
 --8<-- "docs/cmd/_global.md"
 
-!!! important
-    To use this command you must have permissions to access the tenant admin site.
-
 ## Remarks
 
 Renaming site collections is by default asynchronous and depending on the current state of Microsoft 365, might take up to few minutes. If you're building a script with steps that require the operation to complete fully, you should use the `--wait` flag. When using this flag, the `spo site rename` command  will keep running until it receives confirmation from Microsoft 365 that the site rename operation has completed.
 
+!!! important
+    To use this command you must have permissions to access the tenant admin site.
+    
 ## Examples
 
 Starts the rename of the site collection with name "samplesite" to "renamed" without modifying the title

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

@@ -69,9 +69,6 @@ m365 spo site set [options]
 
 --8<-- "docs/cmd/_global.md"
 
-!!! important
-    To use this command you have to have permissions to access the tenant admin site.
-
 ## Remarks
 
 If the specified url doesn't refer to an existing site collection, you will get a `404 - "404 FILE NOT FOUND"` error.
@@ -94,6 +91,9 @@ For more information on configuring no script sites see [https://support.office.
 
 Setting site properties is by default asynchronous and depending on the current state of Microsoft 365, might take up to few minutes. If you're building a script with steps that require the site to be fully configured, you should use the `--wait` flag. When using this flag, the `spo site set` command will keep running until it received confirmation from Microsoft 365 that the site has been fully configured.
 
+!!! important
+    To use this command you have to have permissions to access the tenant admin site.
+    
 ## Examples
 
 Update site collection's classification
@@ -159,13 +159,13 @@ m365 spo site set --url https://contoso.sharepoint.com/sites/sales --sharingCapa
 Set the logo on the site
 
 ```sh
-m365 spo site set --url https://estruyfdev2.sharepoint.com/sites/sales --siteLogoUrl "/sites/sales/SiteAssets/parker-ms-1200.png"
+m365 spo site set --url https://contoso.sharepoint.com/sites/sales --siteLogoUrl "/sites/sales/SiteAssets/parker-ms-1200.png"
 ```
 
 Unset the logo on the site
 
 ```sh
-m365 spo site set --url https://estruyfdev2.sharepoint.com/sites/sales --siteLogoUrl ""
+m365 spo site set --url https://contoso.sharepoint.com/sites/sales --siteLogoUrl ""
 ```
 
 Lock the site preventing users from accessing it. Wait for the configuration to complete

package/docs/docs/cmd/spo/storageentity/storageentity-remove.md

@@ -21,13 +21,13 @@ m365 spo storageentity remove [options]
 
 --8<-- "docs/cmd/_global.md"
 
-!!! important
-    To use this command you have to have permissions to access the tenant admin site.
-
 ## Remarks
 
 Tenant properties are stored in the app catalog site associated with that tenant. To remove a property, you have to specify the absolute URL of the app catalog site. If you specify the URL of a site different than the app catalog, you will get an access denied error.
 
+!!! important
+    To use this command you have to have permissions to access the tenant admin site.
+    
 ## Examples
 
 Remove the _AnalyticsId_ tenant property. Yields a confirmation prompt before actually removing the property

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

@@ -27,15 +27,15 @@ m365 spo storageentity set [options]
 
 --8<-- "docs/cmd/_global.md"
 
-!!! important
-    To use this command you have to have permissions to access the tenant admin site.
-
 ## Remarks
 
 Tenant properties are stored in the app catalog site associated with that tenant. To set a property, you have to specify the absolute URL of the app catalog site without a trailing slash. If you specify the URL with trailing slash you get the error `The managed path sites/apps is not a managed path in this tenant.`
 
 If you specify the URL of a site different than the app catalog, you will get an access denied error.
 
+!!! important
+    To use this command you have to have permissions to access the tenant admin site.
+
 ## Examples
 
 Set _123_ as the value of the _AnalyticsId_ tenant property. Also include a description and a comment for additional clarification of the usage of the property.