@pnp/cli-microsoft365 6.0.0-beta.27e1012 → 6.0.0-beta.291f17c

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

@@ -10,15 +10,15 @@ m365 spo hubsite register [options]
 
 ## Options
 
-`-u, --url <url>`
+`-u, --siteUrl <siteUrl>`
 : URL of the site collection to register as a hub site
 
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
 
-!!! attention
-    This command is based on a SharePoint API that is currently in preview and is subject to change once the API reached general availability.
+!!! 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.
 
@@ -27,9 +27,62 @@ If the specified site collection is already registered as a hub site, you will g
 Register the site collection with URL _https://contoso.sharepoint.com/sites/sales_ as a hub site
 
 ```sh
-m365 spo hubsite register --url https://contoso.sharepoint.com/sites/sales
+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
+    ```
+
 ## 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

@@ -10,7 +10,7 @@ m365 spo hubsite rights grant [options]
 
 ## Options
 
-`-u, --url <url>`
+`-u, --hubSiteUrl <hubSiteUrl>`
 : The URL of the hub site to grant rights on
 
 `-p, --principals <principals>`
@@ -21,34 +21,35 @@ m365 spo hubsite rights grant [options]
 
 --8<-- "docs/cmd/_global.md"
 
-!!! important
-    To use this command you have to have permissions to access the tenant admin site.
-
 ## Remarks
 
-!!! attention
-    This command is based on a SharePoint API that is currently in preview and is subject to change once the API reached general availability.
+!!! important
+    To use this command you must be a Global or SharePoint administrator.
 
 ## Examples
 
 Grant user with alias _PattiF_ permission to join sites to the hub site with URL _https://contoso.sharepoint.com/sites/sales_
 
 ```sh
-m365 spo hubsite rights grant --url https://contoso.sharepoint.com/sites/sales --principals PattiF --rights Join
+m365 spo hubsite rights grant --hubSiteUrl https://contoso.sharepoint.com/sites/sales --principals PattiF --rights Join
 ```
 
 Grant users with aliases _PattiF_ and _AdeleV_ permission to join sites to the hub site with URL _https://contoso.sharepoint.com/sites/sales_
 
 ```sh
-m365 spo hubsite rights grant --url https://contoso.sharepoint.com/sites/sales --principals "PattiF,AdeleV" --rights Join
+m365 spo hubsite rights grant --hubSiteUrl https://contoso.sharepoint.com/sites/sales --principals "PattiF,AdeleV" --rights Join
 ```
 
 Grant user with email _PattiF@contoso.com_ permission to join sites to the hub site with URL _https://contoso.sharepoint.com/sites/sales_
 
 ```sh
-m365 spo hubsite rights grant --url https://contoso.sharepoint.com/sites/sales --principals PattiF@contoso.com --rights Join
+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

@@ -10,7 +10,7 @@ m365 spo hubsite rights revoke [options]
 
 ## Options
 
-`-u, --url <url>`
+`-u, --hubSiteUrl <hubSiteUrl>`
 : The URL of the hub site to revoke rights on
 
 `-p, --principals <principals>`
@@ -21,28 +21,29 @@ m365 spo hubsite rights revoke [options]
 
 --8<-- "docs/cmd/_global.md"
 
-!!! important
-    To use this command you have to have permissions to access the tenant admin site.
-
 ## Remarks
 
-!!! attention
-    This command is based on a SharePoint API that is currently in preview and is subject to change once the API reached general availability.
+!!! important
+    To use this command you must be a Global or SharePoint administrator.
 
 ## Examples
 
 Revoke rights to join sites to the hub site with URL _https://contoso.sharepoint.com/sites/sales_ from user with alias _PattiF_. Will prompt for confirmation before revoking the rights
 
 ```sh
-m365 spo hubsite rights revoke --url https://contoso.sharepoint.com/sites/sales --principals PattiF
+m365 spo hubsite rights revoke --hubSiteUrl https://contoso.sharepoint.com/sites/sales --principals PattiF
 ```
 
 Revoke rights to join sites to the hub site with URL _https://contoso.sharepoint.com/sites/sales_ from user with aliases _PattiF_ and _AdeleV_ without prompting for confirmation
 
 ```sh
-m365 spo hubsite rights revoke --url https://contoso.sharepoint.com/sites/sales --principals "PattiF,AdeleV" --confirm
+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

@@ -24,13 +24,10 @@ m365 spo hubsite set [options]
 
 --8<-- "docs/cmd/_global.md"
 
-!!! important
-    To use this command you have to have permissions to access the tenant admin site.
-
 ## Remarks
 
-!!! attention
-    This command is based on a SharePoint API that is currently in preview and is subject to change once the API reached general availability.
+!!! 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.
 
@@ -48,6 +45,51 @@ Update hub site's title and description
 m365 spo hubsite set --id 255a50b2-527f-4413-8485-57f4c17a24d1 --title Sales --description "All things sales"
 ```
 
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "Description": "Hello",
+      "EnablePermissionsSync": false,
+      "HideNameInNavigation": false,
+      "ID": "af80c11f-0138-4d72-bb37-514542c3aabb",
+      "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": "af80c11f-0138-4d72-bb37-514542c3aabb",
+      "SiteUrl": "https://contoso.sharepoint.com/sites/intra",
+      "Title": "Intranet"
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    Description          : Hello
+    EnablePermissionsSync: false
+    HideNameInNavigation : false
+    ID                   : af80c11f-0138-4d72-bb37-514542c3aabb
+    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               : af80c11f-0138-4d72-bb37-514542c3aabb
+    SiteUrl              : https://contoso.sharepoint.com/sites/intra
+    Title                : Intranet
+    ```
+
+=== "CSV"
+
+    ```csv
+    Description,EnablePermissionsSync,HideNameInNavigation,ID,LogoUrl,ParentHubSiteId,Permissions,RequiresJoinApproval,SiteDesignId,SiteId,SiteUrl,Title
+    Hello,,,af80c11f-0138-4d72-bb37-514542c3aabb,https://contoso.sharepoint.com/sites/intra/SiteAssets/teapoint.png,/Guid(00000000-0000-0000-0000-000000000000)/,,,/Guid(184644fb-90ed-4841-a7ad-6930cf819060)/,af80c11f-0138-4d72-bb37-514542c3aabb,https://contoso.sharepoint.com/sites/intra,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-unregister.md

@@ -1,6 +1,6 @@
 # spo hubsite unregister
 
-Unregisters the specifies site collection as a hub site
+Unregisters the specified site collection as a hub site
 
 ## Usage
 
@@ -20,8 +20,8 @@ m365 spo hubsite unregister [options]
 
 ## Remarks
 
-!!! attention
-    This command is based on a SharePoint API that is currently in preview and is subject to change once the API reached general availability.
+!!! 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.
 
@@ -33,12 +33,16 @@ Unregister the site collection with URL _https://contoso.sharepoint.com/sites/sa
 m365 spo hubsite unregister --url https://contoso.sharepoint.com/sites/sales
 ```
 
-Unregister the site collection with URL _https://contoso.sharepoint.com/sites/sales_ as a hub site without prompting for confirmation
+Unregister the site collection with URL _https://contoso.sharepoint.com/sites/sales_ 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

@@ -22,3 +22,23 @@ 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
+    ```

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

@@ -31,3 +31,23 @@ 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.
+    ```

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

@@ -10,7 +10,7 @@ m365 spo knowledgehub set [options]
 
 ## Options
 
-`-u, --url <url>`
+`-u, --siteUrl <siteUrl>`
 : URL of the site to set as Knowledge Hub
 
 --8<-- "docs/cmd/_global.md"
@@ -27,5 +27,25 @@ If the specified url doesn't refer to an existing site collection, you will get
 Sets the Knowledge Hub Site for your tenant
 
 ```sh
-m365 spo knowledgehub set --url https://contoso.sharepoint.com/sites/knowledgesite
+m365 spo knowledgehub set --siteUrl https://contoso.sharepoint.com/sites/knowledgesite
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    "The knowledge hub site with url \"https://contoso.sharepoint.com\" is added to list."
+    ```
+
+=== "Text"
+
+    ```text
+    The knowledge hub site with url "https://contoso.sharepoint.com" is added to list.
+    ```
+
+=== "CSV"
+
+    ```csv
+    The knowledge hub site with url "https://contoso.sharepoint.com" is added to list.
+    ```

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

@@ -221,6 +221,139 @@ Add a list with title _Announcements_, baseTemplate _Announcements_ in site _htt
 m365 spo list add --webUrl https://contoso.sharepoint.com/sites/project-x --title Announcements --baseTemplate Announcements --contentTypesEnabled true --enableVersioning true --majorVersionLimit 50
 ```
 
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "AllowContentTypes": true,
+      "BaseTemplate": 100,
+      "BaseType": 0,
+      "ContentTypesEnabled": false,
+      "CrawlNonDefaultViews": false,
+      "Created": "2022-11-16T19:51:42Z",
+      "CurrentChangeToken": {
+        "StringValue": "1;3;ea3dc19f-bc1f-4b77-afb8-14e08f4c0f6d;638042251016970000;564165920"
+      },
+      "DefaultContentApprovalWorkflowId": "00000000-0000-0000-0000-000000000000",
+      "DefaultItemOpenUseListSetting": false,
+      "Description": "",
+      "Direction": "none",
+      "DisableCommenting": false,
+      "DisableGridEditing": false,
+      "DocumentTemplateUrl": null,
+      "DraftVersionVisibility": 0,
+      "EnableAttachments": true,
+      "EnableFolderCreation": false,
+      "EnableMinorVersions": false,
+      "EnableModeration": false,
+      "EnableRequestSignOff": true,
+      "EnableVersioning": true,
+      "EntityTypeName": "TestList",
+      "ExemptFromBlockDownloadOfNonViewableFiles": false,
+      "FileSavePostProcessingEnabled": false,
+      "ForceCheckout": false,
+      "HasExternalDataSource": false,
+      "Hidden": false,
+      "Id": "ea3dc19f-bc1f-4b77-afb8-14e08f4c0f6d",
+      "ImagePath": {
+        "DecodedUrl": "/_layouts/15/images/itgen.png?rev=47"
+      },
+      "ImageUrl": "/_layouts/15/images/itgen.png?rev=47",
+      "DefaultSensitivityLabelForLibrary": "",
+      "IrmEnabled": false,
+      "IrmExpire": false,
+      "IrmReject": false,
+      "IsApplicationList": false,
+      "IsCatalog": false,
+      "IsPrivate": false,
+      "ItemCount": 0,
+      "LastItemDeletedDate": "2022-11-16T19:51:42Z",
+      "LastItemModifiedDate": "2022-11-16T19:51:42Z",
+      "LastItemUserModifiedDate": "2022-11-16T19:51:42Z",
+      "ListExperienceOptions": 0,
+      "ListItemEntityTypeFullName": "SP.Data.TestListItem",
+      "MajorVersionLimit": 50,
+      "MajorWithMinorVersionsLimit": 0,
+      "MultipleDataList": false,
+      "NoCrawl": false,
+      "ParentWebPath": {
+        "DecodedUrl": "/"
+      },
+      "ParentWebUrl": "/",
+      "ParserDisabled": false,
+      "ServerTemplateCanCreateFolders": true,
+      "TemplateFeatureId": "00bfea71-de22-43b2-a848-c05709900100",
+      "Title": "Test"
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    AllowContentTypes                        : true
+    BaseTemplate                             : 100
+    BaseType                                 : 0
+    ContentTypesEnabled                      : false
+    CrawlNonDefaultViews                     : false
+    Created                                  : 2022-11-16T19:52:16Z
+    CurrentChangeToken                       : {"StringValue":"1;3;4d66e81a-ac73-4894-9e33-7999edaa36bc;638042251364530000;564166119"}
+    DefaultContentApprovalWorkflowId         : 00000000-0000-0000-0000-000000000000
+    DefaultItemOpenUseListSetting            : false
+    DefaultSensitivityLabelForLibrary        :
+    Description                              :
+    Direction                                : none
+    DisableCommenting                        : false
+    DisableGridEditing                       : false
+    DocumentTemplateUrl                      : null
+    DraftVersionVisibility                   : 0
+    EnableAttachments                        : true
+    EnableFolderCreation                     : false
+    EnableMinorVersions                      : false
+    EnableModeration                         : false
+    EnableRequestSignOff                     : true
+    EnableVersioning                         : true
+    EntityTypeName                           : TestList
+    ExemptFromBlockDownloadOfNonViewableFiles: false
+    FileSavePostProcessingEnabled            : false
+    ForceCheckout                            : false
+    HasExternalDataSource                    : false
+    Hidden                                   : false
+    Id                                       : 4d66e81a-ac73-4894-9e33-7999edaa36bc
+    ImagePath                                : {"DecodedUrl":"/_layouts/15/images/itgen.png?rev=47"}
+    ImageUrl                                 : /_layouts/15/images/itgen.png?rev=47
+    IrmEnabled                               : false
+    IrmExpire                                : false
+    IrmReject                                : false
+    IsApplicationList                        : false
+    IsCatalog                                : false
+    IsPrivate                                : false
+    ItemCount                                : 0
+    LastItemDeletedDate                      : 2022-11-16T19:52:16Z
+    LastItemModifiedDate                     : 2022-11-16T19:52:16Z
+    LastItemUserModifiedDate                 : 2022-11-16T19:52:16Z
+    ListExperienceOptions                    : 0
+    ListItemEntityTypeFullName               : SP.Data.TestListItem
+    MajorVersionLimit                        : 50
+    MajorWithMinorVersionsLimit              : 0
+    MultipleDataList                         : false
+    NoCrawl                                  : false
+    ParentWebPath                            : {"DecodedUrl":"/"}
+    ParentWebUrl                             : /
+    ParserDisabled                           : false
+    ServerTemplateCanCreateFolders           : true
+    TemplateFeatureId                        : 00bfea71-de22-43b2-a848-c05709900100
+    Title                                    : Test
+    ```
+
+=== "CSV"
+
+    ```csv
+    AllowContentTypes,BaseTemplate,BaseType,ContentTypesEnabled,CrawlNonDefaultViews,Created,CurrentChangeToken,DefaultContentApprovalWorkflowId,DefaultItemOpenUseListSetting,Description,Direction,DisableCommenting,DisableGridEditing,DocumentTemplateUrl,DraftVersionVisibility,EnableAttachments,EnableFolderCreation,EnableMinorVersions,EnableModeration,EnableRequestSignOff,EnableVersioning,EntityTypeName,ExemptFromBlockDownloadOfNonViewableFiles,FileSavePostProcessingEnabled,ForceCheckout,HasExternalDataSource,Hidden,Id,ImagePath,ImageUrl,DefaultSensitivityLabelForLibrary,IrmEnabled,IrmExpire,IrmReject,IsApplicationList,IsCatalog,IsPrivate,ItemCount,LastItemDeletedDate,LastItemModifiedDate,LastItemUserModifiedDate,ListExperienceOptions,ListItemEntityTypeFullName,MajorVersionLimit,MajorWithMinorVersionsLimit,MultipleDataList,NoCrawl,ParentWebPath,ParentWebUrl,ParserDisabled,ServerTemplateCanCreateFolders,TemplateFeatureId,Title
+    1,100,0,,,2022-11-16T19:52:41Z,"{""StringValue"":""1;3;3b6bd39e-1e62-4ddf-ac8e-020bf5353891;638042251616230000;564166296""}",00000000-0000-0000-0000-000000000000,,,none,,,,0,1,,,,1,1,TestList,,,,,,3b6bd39e-1e62-4ddf-ac8e-020bf5353891,"{""DecodedUrl"":""/_layouts/15/images/itgen.png?rev=47""}",/_layouts/15/images/itgen.png?rev=47,,,,,,,,0,2022-11-16T19:52:41Z,2022-11-16T19:52:42Z,2022-11-16T19:52:41Z,0,SP.Data.TestListItem,50,0,,,"{""DecodedUrl"":""/""}",/,,1,00bfea71-de22-43b2-a848-c05709900100,Test
+    ```
+
 ## More information
 
 - SPList Class Members information: [https://msdn.microsoft.com/en-us/library/microsoft.sharepoint.client.list_members.aspx](https://msdn.microsoft.com/en-us/library/microsoft.sharepoint.client.list_members.aspx)

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

@@ -11,29 +11,125 @@ m365 spo list contenttype add [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site where the list is located
+: URL of the site where the list is located.
 
-`-l, --listId [listId]`
-: ID of the list to which to add the content type. Specify `listId` or `listTitle` but not both
+`-i, --listId [listId]`
+: ID of the list. Specify either `listTitle`, `listId` or `listUrl`.
 
 `-t, --listTitle [listTitle]`
-: Title of the list to which to add the content type. Specify `listId` or `listTitle` but not both
+: Title of the list. Specify either `listTitle`, `listId` or `listUrl`.
 
-`-c, --contentTypeId <contentTypeId>`
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`.
+
+`-i, --id <id>`
 : ID of the content type to add to the list
 
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
 
-Add existing content type with ID _0x0120_ to the list with ID _0cd891ef-afce-4e55-b836-fce03286cccf_ located in site _https://contoso.sharepoint.com/sites/project-x_
+Adds a specific existing content type to a list retrieved by id in a specific site.
+
+```sh
+m365 spo list contenttype add --webUrl https://contoso.sharepoint.com/sites/project-x --listId 0cd891ef-afce-4e55-b836-fce03286cccf --id 0x0120
+```
+
+Adds a specific existing content type to a list retrieved by title in a specific site.
 
 ```sh
-m365 spo list contenttype add --webUrl https://contoso.sharepoint.com/sites/project-x --listId 0cd891ef-afce-4e55-b836-fce03286cccf --contentTypeId 0x0120
+m365 spo list contenttype add --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle Documents --id 0x0120
 ```
 
-Add existing content type with ID _0x0120_ to the list with title _Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_
+Adds a specific existing content type to a list retrieved by server relative URL in a specific site.
 
 ```sh
-m365 spo list contenttype add --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle Documents --contentTypeId 0x0120
+m365 spo list contenttype add --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl 'sites/project-x/Documents' --id 0x0120
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "ClientFormCustomFormatter": "",
+      "Description": "Create a new list item.",
+      "DisplayFormClientSideComponentId": "",
+      "DisplayFormClientSideComponentProperties": "",
+      "DisplayFormTarget": 0,
+      "DisplayFormTemplateName": "ListForm",
+      "DisplayFormUrl": "",
+      "DocumentTemplate": "",
+      "DocumentTemplateUrl": "",
+      "EditFormClientSideComponentId": "",
+      "EditFormClientSideComponentProperties": "",
+      "EditFormTarget": 0,
+      "EditFormTemplateName": "ListForm",
+      "EditFormUrl": "",
+      "Group": "List Content Types",
+      "Hidden": false,
+      "Id": {
+        "StringValue": "0x01000B1208C5D23DF44B9F1AEE7373DE9D5E"
+      },
+      "JSLink": "",
+      "MobileDisplayFormUrl": "",
+      "MobileEditFormUrl": "",
+      "MobileNewFormUrl": "",
+      "Name": "Item",
+      "NewFormClientSideComponentId": null,
+      "NewFormClientSideComponentProperties": "",
+      "NewFormTarget": 0,
+      "NewFormTemplateName": "ListForm",
+      "NewFormUrl": "",
+      "ReadOnly": false,
+      "SchemaXml": "<ContentType ID=\"0x01000B1208C5D23DF44B9F1AEE7373DE9D5E\" Name=\"Item\" Group=\"List Content Types\" Description=\"Create a new list item.\" Version=\"0\" FeatureId=\"{695b6570-a48b-4a8e-8ea5-26ea7fc1d162}\" FeatureIds=\"{695b6570-a48b-4a8e-8ea5-26ea7fc1d162};{c94c1702-30a7-454c-be15-5a895223428d}\"><Folder TargetName=\"Item\"/><Fields><Field ID=\"{c042a256-787d-4a6f-8a8a-cf6ab767f12d}\" Type=\"Computed\" DisplayName=\"Content Type\" Name=\"ContentType\" DisplaceOnUpgrade=\"TRUE\" RenderXMLUsingPattern=\"TRUE\" Sortable=\"FALSE\" SourceID=\"http://schemas.microsoft.com/sharepoint/v3\" StaticName=\"ContentType\" Group=\"_Hidden\" PITarget=\"MicrosoftWindowsSharePointServices\" PIAttribute=\"ContentTypeID\" FromBaseType=\"TRUE\"><FieldRefs><FieldRef Name=\"ContentTypeId\"/></FieldRefs><DisplayPattern><MapToContentType><Column Name=\"ContentTypeId\"/></MapToContentType></DisplayPattern></Field><Field ID=\"{fa564e0f-0c70-4ab9-b863-0177e6ddd247}\" Type=\"Text\" Name=\"Title\" DisplayName=\"Title\" Required=\"TRUE\" SourceID=\"http://schemas.microsoft.com/sharepoint/v3\" StaticName=\"Title\" FromBaseType=\"TRUE\" ColName=\"nvarchar1\" ShowInNewForm=\"TRUE\" ShowInEditForm=\"TRUE\"/></Fields><XmlDocuments><XmlDocument NamespaceURI=\"http://schemas.microsoft.com/sharepoint/v3/contenttype/forms\"><FormTemplates xmlns=\"http://schemas.microsoft.com/sharepoint/v3/contenttype/forms\"><Display>ListForm</Display><Edit>ListForm</Edit><New>ListForm</New></FormTemplates></XmlDocument></XmlDocuments></ContentType>",
+      "Scope": "/Lists/Test",
+      "Sealed": false,
+      "StringId": "0x01000B1208C5D23DF44B9F1AEE7373DE9D5E"
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    ClientFormCustomFormatter               :
+    Description                             : Create a new list item.
+    DisplayFormClientSideComponentId        :
+    DisplayFormClientSideComponentProperties:
+    DisplayFormTarget                       : 0
+    DisplayFormTemplateName                 : ListForm
+    DisplayFormUrl                          :
+    DocumentTemplate                        :
+    DocumentTemplateUrl                     :
+    EditFormClientSideComponentId           :
+    EditFormClientSideComponentProperties   :
+    EditFormTarget                          : 0
+    EditFormTemplateName                    : ListForm
+    EditFormUrl                             :
+    Group                                   : List Content Types
+    Hidden                                  : false
+    Id                                      : {"StringValue":"0x01006510BD288ADEDD4AB8AC500FA0B356E4"}
+    JSLink                                  :
+    MobileDisplayFormUrl                    :
+    MobileEditFormUrl                       :
+    MobileNewFormUrl                        :
+    Name                                    : Item
+    NewFormClientSideComponentId            : null
+    NewFormClientSideComponentProperties    :
+    NewFormTarget                           : 0
+    NewFormTemplateName                     : ListForm
+    NewFormUrl                              :
+    ReadOnly                                : false
+    SchemaXml                               : <ContentType ID="0x01006510BD288ADEDD4AB8AC500FA0B356E4" Name="Item" Group="List Content Types" Description="Create a new list item." Version="0" FeatureId="{695b6570-a48b-4a8e-8ea5-26ea7fc1d162}" FeatureIds="{695b6570-a48b-4a8e-8ea5-26ea7fc1d162};{c94c1702-30a7-454c-be15-5a895223428d}"><Folder TargetName="Item"/><Fields><Field ID="{c042a256-787d-4a6f-8a8a-cf6ab767f12d}" Type="Computed" DisplayName="Content Type" Name="ContentType" DisplaceOnUpgrade="TRUE" RenderXMLUsingPattern="TRUE" Sortable="FALSE" SourceID="http://schemas.microsoft.com/sharepoint/v3" StaticName="ContentType" Group="_Hidden" PITarget="MicrosoftWindowsSharePointServices" PIAttribute="ContentTypeID" FromBaseType="TRUE"><FieldRefs><FieldRef Name="ContentTypeId"/></FieldRefs><DisplayPattern><MapToContentType><Column Name="ContentTypeId"/></MapToContentType></DisplayPattern></Field><Field ID="{fa564e0f-0c70-4ab9-b863-0177e6ddd247}" Type="Text" Name="Title" DisplayName="Title" Required="TRUE" SourceID="http://schemas.microsoft.com/sharepoint/v3" StaticName="Title" FromBaseType="TRUE" ColName="nvarchar1" ShowInNewForm="TRUE" ShowInEditForm="TRUE"/></Fields><XmlDocuments><XmlDocument NamespaceURI="http://schemas.microsoft.com/sharepoint/v3/contenttype/forms"><FormTemplates xmlns="http://schemas.microsoft.com/sharepoint/v3/contenttype/forms"><Display>ListForm</Display><Edit>ListForm</Edit><New>ListForm</New></FormTemplates></XmlDocument></XmlDocuments></ContentType>
+    Scope                                   : /Lists/Test
+    Sealed                                  : false
+    StringId                                : 0x01006510BD288ADEDD4AB8AC500FA0B356E4
+    ```
+
+=== "CSV"
+
+    ```csv
+    ClientFormCustomFormatter,Description,DisplayFormClientSideComponentId,DisplayFormClientSideComponentProperties,DisplayFormTarget,DisplayFormTemplateName,DisplayFormUrl,DocumentTemplate,DocumentTemplateUrl,EditFormClientSideComponentId,EditFormClientSideComponentProperties,EditFormTarget,EditFormTemplateName,EditFormUrl,Group,Hidden,Id,JSLink,MobileDisplayFormUrl,MobileEditFormUrl,MobileNewFormUrl,Name,NewFormClientSideComponentId,NewFormClientSideComponentProperties,NewFormTarget,NewFormTemplateName,NewFormUrl,ReadOnly,SchemaXml,Scope,Sealed,StringId
+    ,Create a new list item.,,,0,ListForm,,,,,,0,ListForm,,List Content Types,,"{""StringValue"":""0x01006D9EF01B2D22B3428279F8CF918B5EE0""}",,,,,Item,,,0,ListForm,,,"<ContentType ID=""0x01006D9EF01B2D22B3428279F8CF918B5EE0"" Name=""Item"" Group=""List Content Types"" Description=""Create a new list item."" Version=""0"" FeatureId=""{695b6570-a48b-4a8e-8ea5-26ea7fc1d162}"" FeatureIds=""{695b6570-a48b-4a8e-8ea5-26ea7fc1d162};{c94c1702-30a7-454c-be15-5a895223428d}""><Folder TargetName=""Item""/><Fields><Field ID=""{c042a256-787d-4a6f-8a8a-cf6ab767f12d}"" Type=""Computed"" DisplayName=""Content Type"" Name=""ContentType"" DisplaceOnUpgrade=""TRUE"" RenderXMLUsingPattern=""TRUE"" Sortable=""FALSE"" SourceID=""http://schemas.microsoft.com/sharepoint/v3"" StaticName=""ContentType"" Group=""_Hidden"" PITarget=""MicrosoftWindowsSharePointServices"" PIAttribute=""ContentTypeID"" FromBaseType=""TRUE""><FieldRefs><FieldRef Name=""ContentTypeId""/></FieldRefs><DisplayPattern><MapToContentType><Column Name=""ContentTypeId""/></MapToContentType></DisplayPattern></Field><Field ID=""{fa564e0f-0c70-4ab9-b863-0177e6ddd247}"" Type=""Text"" Name=""Title"" DisplayName=""Title"" Required=""TRUE"" SourceID=""http://schemas.microsoft.com/sharepoint/v3"" StaticName=""Title"" FromBaseType=""TRUE"" ColName=""nvarchar1"" ShowInNewForm=""TRUE"" ShowInEditForm=""TRUE""/></Fields><XmlDocuments><XmlDocument NamespaceURI=""http://schemas.microsoft.com/sharepoint/v3/contenttype/forms""><FormTemplates xmlns=""http://schemas.microsoft.com/sharepoint/v3/contenttype/forms""><Display>ListForm</Display><Edit>ListForm</Edit><New>ListForm</New></FormTemplates></XmlDocument></XmlDocuments></ContentType>",/Lists/Test,,0x01006D9EF01B2D22B3428279F8CF918B5EE0
+    ```