@pnp/cli-microsoft365 6.8.0 → 6.9.0-beta.bb31388

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

@@ -1,190 +0,0 @@
-# spo hubsite list
-
-Lists hub sites in the current tenant
-
-## Usage
-
-```sh
-m365 spo hubsite list [options]
-```
-
-## Options
-
-`-i, --includeAssociatedSites`
-: Include the associated sites in the result (only in JSON output).
-
---8<-- "docs/cmd/_global.md"
-
-## Remarks
-
-When using the text or csv output type, the command lists only the values of the `ID`, `SiteUrl` and `Title` properties of the hub site. With the output type as JSON, all available properties are included in the command output.
-
-## Examples
-
-List hub sites in the current tenant
-
-```sh
-m365 spo hubsite list
-```
-
-List hub sites, including their associated sites, in the current tenant. Associated site info is only shown in JSON output.
-
-```sh
-m365 spo hubsite list --includeAssociatedSites --output json
-```
-
-## Response
-
-### Standard response
-
-=== "JSON"
-
-    ```json
-    [
-      {
-        "Description": "Intranet Hub Site",
-        "EnablePermissionsSync": false,
-        "EnforcedECTs": null,
-        "EnforcedECTsVersion": 0,
-        "HideNameInNavigation": false,
-        "ID": "af80c11f-0138-4d72-bb37-514542c3aabb",
-        "LogoUrl": "https://contoso.sharepoint.com/sites/intra/SiteAssets/work.png",
-        "ParentHubSiteId": "ec78f3aa-5a74-4f16-be49-3396df045f34",
-        "PermissionsSyncTag": 0,
-        "RequiresJoinApproval": false,
-        "SiteDesignId": "184644fb-90ed-4841-a7ad-6930cf819060",
-        "SiteId": "af80c11f-0138-4d72-bb37-514542c3aabb",
-        "SiteUrl": "https://contoso.sharepoint.com/sites/intra",
-        "Targets": null,
-        "TenantInstanceId": "5d128b52-7228-46b5-8765-5b338476054d",
-        "Title": "Intranet"
-      }
-    ]
-    ```
-
-=== "Text"
-
-    ```text
-    ID                                    SiteUrl                                     Title
-    ------------------------------------  ------------------------------------------  --------
-    af80c11f-0138-4d72-bb37-514542c3aabb  https://contoso.sharepoint.com/sites/intra  Intranet
-    ```
-
-=== "CSV"
-
-    ```csv
-    ID,SiteUrl,Title
-    af80c11f-0138-4d72-bb37-514542c3aabb,https://contoso.sharepoint.com/sites/intra,Intranet
-    ```
-
-=== "Markdown"
-
-    ```md
-    # spo hubsite list
-
-    Date: 2/20/2023
-
-    ## Intranet (af80c11f-0138-4d72-bb37-514542c3aabb)
-
-    Property | Value
-    ---------|-------
-    Description | Intranet Hub Site
-    EnablePermissionsSync | false
-    EnforcedECTs | null
-    EnforcedECTsVersion | 0
-    HideNameInNavigation | false
-    ID | af80c11f-0138-4d72-bb37-514542c3aabb
-    LogoUrl | https://contoso.sharepoint.com/sites/intra/SiteAssets/work.png
-    ParentHubSiteId | ec78f3aa-5a74-4f16-be49-3396df045f34
-    PermissionsSyncTag | 0
-    RequiresJoinApproval | false
-    SiteDesignId | 184644fb-90ed-4841-a7ad-6930cf819060
-    SiteId | af80c11f-0138-4d72-bb37-514542c3aabb
-    SiteUrl | https://contoso.sharepoint.com/sites/intra
-    Targets | null
-    TenantInstanceId | 5d128b52-7228-46b5-8765-5b338476054d
-    Title | Intranet
-    ```
-
-### `includeAssociatedSites` response
-
-When we make use of the option `includeAssociatedSites` the response will differ. 
-
-=== "JSON"
-
-    ```json
-    [
-      {
-        "Description": "Intranet Hub Site",
-        "EnablePermissionsSync": false,
-        "EnforcedECTs": null,
-        "EnforcedECTsVersion": 0,
-        "HideNameInNavigation": false,
-        "ID": "af80c11f-0138-4d72-bb37-514542c3aabb",
-        "LogoUrl": "https://contoso.sharepoint.com/sites/intra/SiteAssets/work.png",
-        "ParentHubSiteId": "ec78f3aa-5a74-4f16-be49-3396df045f34",
-        "PermissionsSyncTag": 0,
-        "RequiresJoinApproval": false,
-        "SiteDesignId": "184644fb-90ed-4841-a7ad-6930cf819060",
-        "SiteId": "af80c11f-0138-4d72-bb37-514542c3aabb",
-        "SiteUrl": "https://contoso.sharepoint.com/sites/intra",
-        "Targets": null,
-        "TenantInstanceId": "5d128b52-7228-46b5-8765-5b338476054d",
-        "Title": "Intranet",
-        "AssociatedSites": [
-          {
-            "Title": "About Us",
-            "SiteUrl": "https://contoso.sharepoint.com/sites/about-us"
-          }
-        ]
-      }
-    ]
-    ```
-
-=== "Text"
-
-    ```text
-    ID                                    SiteUrl                                     Title
-    ------------------------------------  ------------------------------------------  --------
-    af80c11f-0138-4d72-bb37-514542c3aabb  https://contoso.sharepoint.com/sites/intra  Intranet
-    ```
-
-=== "CSV"
-
-    ```csv
-    ID,SiteUrl,Title
-    af80c11f-0138-4d72-bb37-514542c3aabb,https://contoso.sharepoint.com/sites/intra,Intranet
-    ```
-
-=== "Markdown"
-
-    ```md
-    # spo hubsite list --includeAssociatedSites "true"
-
-    Date: 2/20/2023
-
-    ## Intranet (af80c11f-0138-4d72-bb37-514542c3aabb)
-
-    Property | Value
-    ---------|-------
-    Description | Intranet Hub Site
-    EnablePermissionsSync | false
-    EnforcedECTs | null
-    EnforcedECTsVersion | 0
-    HideNameInNavigation | false
-    ID | af80c11f-0138-4d72-bb37-514542c3aabb
-    LogoUrl | https://contoso.sharepoint.com/sites/intra/SiteAssets/work.png
-    ParentHubSiteId | ec78f3aa-5a74-4f16-be49-3396df045f34
-    PermissionsSyncTag | 0
-    RequiresJoinApproval | false
-    SiteDesignId | 184644fb-90ed-4841-a7ad-6930cf819060
-    SiteId | af80c11f-0138-4d72-bb37-514542c3aabb
-    SiteUrl | https://contoso.sharepoint.com/sites/intra
-    Targets | null
-    TenantInstanceId | 5d128b52-7228-46b5-8765-5b338476054d
-    Title | Intranet
-    ```
-
-## More information
-
-- SharePoint hub sites new in Microsoft 365: [https://techcommunity.microsoft.com/t5/SharePoint-Blog/SharePoint-hub-sites-new-in-Office-365/ba-p/109547](https://techcommunity.microsoft.com/t5/SharePoint-Blog/SharePoint-hub-sites-new-in-Office-365/ba-p/109547)

package/docs/docs/cmd/spo/hubsite/hubsite-register.md

@@ -1,117 +0,0 @@
-# spo hubsite register
-
-Registers the specified site collection as a hub site
-
-## Usage
-
-```sh
-m365 spo hubsite register [options]
-```
-
-## Options
-
-`-u, --siteUrl <siteUrl>`
-: URL of the site collection to register as a hub site.
-
---8<-- "docs/cmd/_global.md"
-
-## Remarks
-
-!!! important
-    To use this command you must be a Global or SharePoint administrator.
-
-If the specified site collection is already registered as a hub site, you will get a `This site is already a HubSite.` error.
-
-## Examples
-
-Register the site collection with URL _https://contoso.sharepoint.com/sites/sales_ as a hub site
-
-```sh
-m365 spo hubsite register --siteUrl https://contoso.sharepoint.com/sites/sales
-```
-
-## Response
-
-=== "JSON"
-
-    ```json
-    {
-      "Description": "",
-      "EnablePermissionsSync": false,
-      "EnforcedECTs": null,
-      "EnforcedECTsVersion": 0,
-      "HideNameInNavigation": false,
-      "ID": "0f9b8f4f-0e8e-4630-bb0a-501442db9b64",
-      "LogoUrl": null,
-      "ParentHubSiteId": "00000000-0000-0000-0000-000000000000",
-      "PermissionsSyncTag": 0,
-      "RequiresJoinApproval": false,
-      "SiteDesignId": "00000000-0000-0000-0000-000000000000",
-      "SiteId": "0f9b8f4f-0e8e-4630-bb0a-501442db9b64",
-      "SiteUrl": "https://contoso.sharepoint.com/sites/newHubSite",
-      "Targets": null,
-      "TenantInstanceId": "4d128b52-7228-46b5-8765-5b338476054d",
-      "Title": "New Hub Site"
-    }
-    ```
-
-=== "Text"
-
-    ```text
-    Description          : null
-    EnablePermissionsSync: false
-    EnforcedECTs         : null
-    EnforcedECTsVersion  : 0
-    HideNameInNavigation : false
-    ID                   : 0f9b8f4f-0e8e-4630-bb0a-501442db9b64
-    LogoUrl              : null
-    ParentHubSiteId      : 00000000-0000-0000-0000-000000000000
-    PermissionsSyncTag   : 0
-    RequiresJoinApproval : false
-    SiteDesignId         : 00000000-0000-0000-0000-000000000000
-    SiteId               : 0f9b8f4f-0e8e-4630-bb0a-501442db9b64
-    SiteUrl              : https://contoso.sharepoint.com/sites/newHubsite
-    Targets              : null
-    TenantInstanceId     : 4d128b52-7228-46b5-8765-5b338476054d
-    Title                : New Hub Site
-    ```
-
-=== "CSV"
-
-    ```csv
-    Description,EnablePermissionsSync,EnforcedECTs,EnforcedECTsVersion,HideNameInNavigation,ID,LogoUrl,ParentHubSiteId,PermissionsSyncTag,RequiresJoinApproval,SiteDesignId,SiteId,SiteUrl,Targets,TenantInstanceId,Title
-    ,,,0,,0f9b8f4f-0e8e-4630-bb0a-501442db9b64,,00000000-0000-0000-0000-000000000000,0,,00000000-0000-0000-0000-000000000000,0f9b8f4f-0e8e-4630-bb0a-501442db9b64,https://contoso.sharepoint.com/sites/newHubSite,,4d128b52-7228-46b5-8765-5b338476054d,New Hub Site
-    ```
-
-=== "Markdown"
-
-    ```md
-    # spo hubsite register --siteUrl "https://contoso.sharepoint.com/sites/newHubSite"
-
-    Date: 2/20/2023
-
-    ## New Hub Site (0f9b8f4f-0e8e-4630-bb0a-501442db9b64)
-
-    Property | Value
-    ---------|-------
-    Description | null
-    EnablePermissionsSync | false
-    EnforcedECTs | null
-    EnforcedECTsVersion | 0
-    HideNameInNavigation | false
-    ID | 0f9b8f4f-0e8e-4630-bb0a-501442db9b64
-    LogoUrl | null
-    ParentHubSiteId | 00000000-0000-0000-0000-000000000000
-    PermissionsSyncTag | 0
-    RequiresJoinApproval | false
-    SiteDesignId | 00000000-0000-0000-0000-000000000000
-    SiteId | 0f9b8f4f-0e8e-4630-bb0a-501442db9b64
-    SiteUrl | https://contoso.sharepoint.com/sites/newHubSite
-    Targets | null
-    TenantInstanceId | 4d128b52-7228-46b5-8765-5b338476054d
-    Title | New Hub Site
-    ```
-
-## More information
-
-- SharePoint hub sites new in Microsoft 365: [https://techcommunity.microsoft.com/t5/SharePoint-Blog/SharePoint-hub-sites-new-in-Office-365/ba-p/109547](https://techcommunity.microsoft.com/t5/SharePoint-Blog/SharePoint-hub-sites-new-in-Office-365/ba-p/109547)

package/docs/docs/cmd/spo/hubsite/hubsite-rights-grant.md

@@ -1,55 +0,0 @@
-# spo hubsite rights grant
-
-Grants permissions to join the hub site for one or more principals
-
-## Usage
-
-```sh
-m365 spo hubsite rights grant [options]
-```
-
-## Options
-
-`-u, --hubSiteUrl <hubSiteUrl>`
-: The URL of the hub site to grant rights on.
-
-`-p, --principals <principals>`
-: Comma-separated list of principals to grant join rights. Principals can be users or mail-enabled security groups in the form of `alias` or `alias@<domain name>.com`.
-
-`-r, --rights <rights>`
-: Rights to grant to principals. Available values `Join`.
-
---8<-- "docs/cmd/_global.md"
-
-## Remarks
-
-!!! important
-    To use this command you must be a Global or SharePoint administrator.
-
-## Examples
-
-Grant user with specific alias, permission to join sites to the hub site with specific URL.
-
-```sh
-m365 spo hubsite rights grant --hubSiteUrl https://contoso.sharepoint.com/sites/sales --principals PattiF --rights Join
-```
-
-Grant users with specific aliases, permission to join sites to the hub site with specific URL.
-
-```sh
-m365 spo hubsite rights grant --hubSiteUrl https://contoso.sharepoint.com/sites/sales --principals "PattiF,AdeleV" --rights Join
-```
-
-Grant user with specific email, permission to join sites to the hub site with specific URL.
-
-```sh
-m365 spo hubsite rights grant --hubSiteUrl https://contoso.sharepoint.com/sites/sales --principals PattiF@contoso.com --rights Join
-```
-
-## Response
-
-The command won't return a response on success.
-
-## More information
-
-- SharePoint hub sites new in Microsoft 365: [https://techcommunity.microsoft.com/t5/SharePoint-Blog/SharePoint-hub-sites-new-in-Office-365/ba-p/109547](https://techcommunity.microsoft.com/t5/SharePoint-Blog/SharePoint-hub-sites-new-in-Office-365/ba-p/109547)

package/docs/docs/cmd/spo/hubsite/hubsite-rights-revoke.md

@@ -1,49 +0,0 @@
-# spo hubsite rights revoke
-
-Revokes rights to join sites to the specified hub site for one or more principals
-
-## Usage
-
-```sh
-m365 spo hubsite rights revoke [options]
-```
-
-## Options
-
-`-u, --hubSiteUrl <hubSiteUrl>`
-: The URL of the hub site to revoke rights on.
-
-`-p, --principals <principals>`
-: Comma-separated list of principals to revoke join rights. Principals can be users or mail-enabled security groups in the form of `alias` or `alias@<domain name>.com`.
-
-`--confirm`
-: Don't prompt for confirming revoking rights
-
---8<-- "docs/cmd/_global.md"
-
-## Remarks
-
-!!! important
-    To use this command you must be a Global or SharePoint administrator.
-
-## Examples
-
-Revoke rights to join sites to the hub site with specific URL. from user with specific alias. Will prompt for confirmation before revoking the rights.
-
-```sh
-m365 spo hubsite rights revoke --hubSiteUrl https://contoso.sharepoint.com/sites/sales --principals PattiF
-```
-
-Revoke rights to join sites to the hub site with specific URL. from user with specific aliases without prompting for confirmation.
-
-```sh
-m365 spo hubsite rights revoke --hubSiteUrl https://contoso.sharepoint.com/sites/sales --principals "PattiF,AdeleV" --confirm
-```
-
-## Response
-
-The command won't return a response on success.
-
-## More information
-
-- SharePoint hub sites new in Microsoft 365: [https://techcommunity.microsoft.com/t5/SharePoint-Blog/SharePoint-hub-sites-new-in-Office-365/ba-p/109547](https://techcommunity.microsoft.com/t5/SharePoint-Blog/SharePoint-hub-sites-new-in-Office-365/ba-p/109547)

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

@@ -1,120 +0,0 @@
-# spo hubsite set
-
-Updates properties of the specified hub site
-
-## Usage
-
-```sh
-m365 spo hubsite set [options]
-```
-
-## Options
-
-`-i, --id <id>`
-: ID of the hub site.
-
-`-t, --title [title]`
-: The new title for the hub site.
-
-`-d, --description [description]`
-: The new description for the hub site.
-
-`-l, --logoUrl [logoUrl]`
-: The URL of the new logo for the hub site.
-
---8<-- "docs/cmd/_global.md"
-
-## Remarks
-
-!!! important
-    To use this command you must be a Global or SharePoint administrator.
-
-If the specified `id` doesn't refer to an existing hub site, you will get an `Unknown Error` error.
-
-## Examples
-
-Update hub site's title.
-
-```sh
-m365 spo hubsite set --id 255a50b2-527f-4413-8485-57f4c17a24d1 --title Sales
-```
-
-Update hub site's title and description.
-
-```sh
-m365 spo hubsite set --id 255a50b2-527f-4413-8485-57f4c17a24d1 --title Sales --description "All things sales"
-```
-
-## Response
-
-=== "JSON"
-
-    ```json
-    {
-      "Description": "All things sales",
-      "EnablePermissionsSync": false,
-      "HideNameInNavigation": false,
-      "ID": "255a50b2-527f-4413-8485-57f4c17a24d1",
-      "LogoUrl": "https://contoso.sharepoint.com/sites/intra/SiteAssets/teapoint.png",
-      "ParentHubSiteId": "/Guid(00000000-0000-0000-0000-000000000000)/",
-      "Permissions": null,
-      "RequiresJoinApproval": false,
-      "SiteDesignId": "/Guid(184644fb-90ed-4841-a7ad-6930cf819060)/",
-      "SiteId": "255a50b2-527f-4413-8485-57f4c17a24d1",
-      "SiteUrl": "https://contoso.sharepoint.com/sites/intra",
-      "Title": "Sales"
-    }
-    ```
-
-=== "Text"
-
-    ```text
-    Description          : All things sales
-    EnablePermissionsSync: false
-    HideNameInNavigation : false
-    ID                   : 255a50b2-527f-4413-8485-57f4c17a24d1
-    LogoUrl              : https://contoso.sharepoint.com/sites/intra/SiteAssets/teapoint.png
-    ParentHubSiteId      : /Guid(00000000-0000-0000-0000-000000000000)/
-    Permissions          : null
-    RequiresJoinApproval : false
-    SiteDesignId         : /Guid(184644fb-90ed-4841-a7ad-6930cf819060)/
-    SiteId               : 255a50b2-527f-4413-8485-57f4c17a24d1
-    SiteUrl              : https://contoso.sharepoint.com/sites/intra
-    Title                : Sales
-    ```
-
-=== "CSV"
-
-    ```csv
-    Description,EnablePermissionsSync,HideNameInNavigation,ID,LogoUrl,ParentHubSiteId,Permissions,RequiresJoinApproval,SiteDesignId,SiteId,SiteUrl,Title
-    All things sales,,,255a50b2-527f-4413-8485-57f4c17a24d1,https://contoso.sharepoint.com/sites/intra/SiteAssets/teapoint.png,/Guid(00000000-0000-0000-0000-000000000000)/,,,/Guid(184644fb-90ed-4841-a7ad-6930cf819060)/,255a50b2-527f-4413-8485-57f4c17a24d1,https://contoso.sharepoint.com/sites/intra,Sales
-    ```
-
-=== "Markdown"
-
-    ```md
-    # spo hubsite set --id "255a50b2-527f-4413-8485-57f4c17a24d1" --title "Sales" --description "All things sales"
-
-    Date: 2/20/2023
-
-    ## Sales (255a50b2-527f-4413-8485-57f4c17a24d1)
-
-    Property | Value
-    ---------|-------
-    Description | All things sales
-    EnablePermissionsSync | false
-    HideNameInNavigation | false
-    ID | 255a50b2-527f-4413-8485-57f4c17a24d1
-    LogoUrl | https://contoso.sharepoint.com/sites/intra/SiteAssets/teapoint.png
-    ParentHubSiteId | /Guid(00000000-0000-0000-0000-000000000000)/
-    Permissions | null
-    RequiresJoinApproval | false
-    SiteDesignId | /Guid(00000000-0000-0000-0000-000000000000)/
-    SiteId | 255a50b2-527f-4413-8485-57f4c17a24d1
-    SiteUrl | https://contoso.sharepoint.com/sites/intra
-    Title | Sales
-    ```
-
-## More information
-
-- SharePoint hub sites new in Microsoft 365: [https://techcommunity.microsoft.com/t5/SharePoint-Blog/SharePoint-hub-sites-new-in-Office-365/ba-p/109547](https://techcommunity.microsoft.com/t5/SharePoint-Blog/SharePoint-hub-sites-new-in-Office-365/ba-p/109547)

package/docs/docs/cmd/spo/hubsite/hubsite-unregister.md

@@ -1,48 +0,0 @@
-# spo hubsite unregister
-
-Unregisters the specified site collection as a hub site
-
-## Usage
-
-```sh
-m365 spo hubsite unregister [options]
-```
-
-## Options
-
-`-u, --url <url>`
-: URL of the site collection.
-
-`--confirm`
-: Don't prompt for confirmation.
-
---8<-- "docs/cmd/_global.md"
-
-## Remarks
-
-!!! important
-    To use this command you must be a Global or SharePoint administrator.
-
-If the specified site collection is not registered as a hub site, you will get a `hubSiteId` error.
-
-## Examples
-
-Unregister the site collection with specific URL. as a hub site. Will prompt for confirmation before unregistering the hub site.
-
-```sh
-m365 spo hubsite unregister --url https://contoso.sharepoint.com/sites/sales
-```
-
-Unregister the site collection with specific URL. as a hub site without prompting for confirmation.
-
-```sh
-m365 spo hubsite unregister --url https://contoso.sharepoint.com/sites/sales --confirm
-```
-
-## Response
-
-The command won't return a response on success.
-
-## More information
-
-- SharePoint hub sites new in Microsoft 365: [https://techcommunity.microsoft.com/t5/SharePoint-Blog/SharePoint-hub-sites-new-in-Office-365/ba-p/109547](https://techcommunity.microsoft.com/t5/SharePoint-Blog/SharePoint-hub-sites-new-in-Office-365/ba-p/109547)

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

@@ -1,52 +0,0 @@
-# spo knowledgehub get
-
-Gets the Knowledge Hub Site URL for your tenant
-
-## Usage
-
-```sh
-m365 spo knowledgehub get [options]
-```
-
-## Options
-
---8<-- "docs/cmd/_global.md"
-
-## Remarks
-
-!!! important
-    To use this command you have to have permissions to access the tenant admin site.
-
-## Examples
-
-Gets the Knowledge Hub Site URL for your tenant.
-
-```sh
-m365 spo knowledgehub get
-```
-
-## Response
-
-=== "JSON"
-
-    ```json
-    "https://contoso.sharepoint.com"
-    ```
-
-=== "Text"
-
-    ```text
-    https://contoso.sharepoint.com
-    ```
-
-=== "CSV"
-
-    ```csv
-    https://contoso.sharepoint.com
-    ```
-
-=== "Markdown"
-
-    ```md
-    https://contoso.sharepoint.com
-    ```

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

@@ -1,61 +0,0 @@
-# spo knowledgehub remove
-
-Removes the Knowledge Hub Site setting for your tenant
-
-## Usage
-
-```sh
-m365 spo knowledgehub remove [options]
-```
-
-## Options
-
-`--confirm`
-: Do not prompt for confirmation before removing the Knowledge Hub Site setting for your tenant.
-
---8<-- "docs/cmd/_global.md"
-
-## Remarks
-
-!!! important
-    To use this command you have to have permissions to access the tenant admin site.
-
-## Examples
-
-Removes the Knowledge Hub Site setting for your tenant.
-
-```sh
-m365 spo knowledgehub remove
-```
-
-Removes the Knowledge Hub Site setting for your tenant without confirmation.
-
-```sh
-m365 spo knowledgehub remove --confirm
-```
-
-## Response
-
-=== "JSON"
-
-    ```json
-    "The knowledge hub site setting was removed."
-    ```
-
-=== "Text"
-
-    ```text
-    The knowledge hub site setting was removed.
-    ```
-
-=== "CSV"
-
-    ```csv
-    The knowledge hub site setting was removed.
-    ```
-
-=== "Markdown"
-
-    ```md
-    The knowledge hub site setting was removed.
-    ```