@pnp/cli-microsoft365 6.8.0-beta.a10f6e4 → 6.8.0-beta.c74eb4b

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

@@ -10,17 +10,20 @@ m365 spo term list [options]
 
 ## Options
 
+`-u, --webUrl [webUrl]`
+: If specified, allows you to list terms from the tenant term store as well as the sitecollection specific term store. Defaults to the tenant admin site.
+
 `--termGroupId [termGroupId]`
-: ID of the term group where the term set is located. Specify `termGroupId` or `termGroupName` but not both
+: ID of the term group where the term set is located. Specify `termGroupId` or `termGroupName` but not both.
 
 `--termGroupName [termGroupName]`
-: Name of the term group where the term set is located. Specify `termGroupId` or `termGroupName` but not both
+: Name of the term group where the term set is located. Specify `termGroupId` or `termGroupName` but not both.
 
 `--termSetId [termSetId]`
-: ID of the term set for which to retrieve terms. Specify `termSetId` or `termSetName` but not both
+: ID of the term set for which to retrieve terms. Specify `termSetId` or `termSetName` but not both.
 
 `--termSetName [termSetName]`
-: Name of the term set for which to retrieve terms. Specify `termSetId` or `termSetName` but not both
+: Name of the term set for which to retrieve terms. Specify `termSetId` or `termSetName` but not both.
 
 `--includeChildTerms`
 : If specified, child terms are loaded as well.
@@ -30,23 +33,31 @@ m365 spo term list [options]
 ## Remarks
 
 !!! important
-    To use this command you have to have permissions to access the tenant admin site.
+    To use this command without the --webUrl option you have to have permissions to access the tenant admin site.
+
+When using the `--webUrl` option you can connect to the term store with limited permissions, and do not need the SharePoint Administrator role. You need to be a site visitor or more. It allows you to list terms from the tenant term store as well as terms from the sitecollection term store.
 
 ## Examples
 
-List taxonomy terms from the term group and term set with the given name
+List taxonomy terms from the specified sitecollection, the term group and term set with the given name
+
+```sh
+m365 spo term list --webUrl https://contoso.sharepoint.com/sites/project-x --termGroupName PnPTermSets --termSetName PnP-Organizations
+```
+
+List taxonomy terms from the term group and term set with the given name.
 
 ```sh
 m365 spo term list --termGroupName PnPTermSets --termSetName PnP-Organizations
 ```
 
-List taxonomy terms from the term group and term set with the given ID
+List taxonomy terms from the term group and term set with the given ID.
 
 ```sh
 m365 spo term list --termGroupId 0e8f395e-ff58-4d45-9ff7-e331ab728beb --termSetId 0e8f395e-ff58-4d45-9ff7-e331ab728bec
 ```
 
-List taxonomy terms from the term group and term set with the given ID including child terms if any are found
+List taxonomy terms from the term group and term set with the given ID including child terms if any are found.
 
 ```sh
 m365 spo term list --termGroupId 0e8f395e-ff58-4d45-9ff7-e331ab728beb --termSetId 0e8f395e-ff58-4d45-9ff7-e331ab728bec --includeChildTerms
@@ -104,6 +115,37 @@ m365 spo term list --termGroupId 0e8f395e-ff58-4d45-9ff7-e331ab728beb --termSetI
     c387e91c-b553-4b92-886b-9af717cd73b0,Financing
     ```
 
+=== "Markdown"
+
+    ```md
+    # spo term list --termGroupName "PnPTermSets" --termSetName "PnP-Organizations"
+
+    Date: 5/8/2023
+
+    ## Financing (c387e91c-b553-4b92-886b-9af717cd73b0)
+
+    Property | Value
+    ---------|-------
+    \_ObjectType\_ | SP.Taxonomy.Term
+    \_ObjectIdentity\_ | b6d6b0a0-50c8-2000-41be-bd745120140b\|fec14c62-7c3b-481b-851b-c80d7802b224:te:aCf0Cz4D9UOS7+b/OlUY5XrNqUp10tpPhLK4MIXc7g/qydiOUnAdTKTXucEL/+pvpnFcKyvXqEmjv9gGNthbRA==
+    CreatedDate | 2021-07-07T09:42:02.283Z
+    Id | c387e91c-b553-4b92-886b-9af717cd73b0
+    LastModifiedDate | 2021-07-07T09:42:02.283Z
+    Name | Financing
+    IsAvailableForTagging | true
+    Owner | NT Service\SPTimerV4
+    Description |
+    IsDeprecated | false
+    IsKeyword | false
+    IsPinned | false
+    IsPinnedRoot | false
+    IsReused | false
+    IsRoot | true
+    IsSourceTerm | true
+    PathOfTerm | Financing
+    TermsCount | 0
+    ```
+
 ### `includeChildTerms` response
 
 When we make use of the option `includeChildTerms` the response will differ. 
@@ -180,3 +222,33 @@ When we make use of the option `includeChildTerms` the response will differ.
     c387e91c-b553-4b92-886b-9af717cd73b0,Financing,079b9c7f-9f49-421b-b1e9-83b908e0d9d4
     ```
 
+=== "Markdown"
+
+    ```md
+    # spo term list --termGroupName "PnPTermSets" --termSetName "PnP-Organizations" --includeChildTerms "true"
+
+    Date: 5/8/2023
+
+    ## Financing (c387e91c-b553-4b92-886b-9af717cd73b0)
+
+    Property | Value
+    ---------|-------
+    \_ObjectType\_ | SP.Taxonomy.Term
+    \_ObjectIdentity\_ | b6d6b0a0-50c8-2000-41be-bd745120140b\|fec14c62-7c3b-481b-851b-c80d7802b224:te:aCf0Cz4D9UOS7+b/OlUY5XrNqUp10tpPhLK4MIXc7g/qydiOUnAdTKTXucEL/+pvpnFcKyvXqEmjv9gGNthbRA==
+    CreatedDate | 2021-07-07T09:42:02.283Z
+    Id | c387e91c-b553-4b92-886b-9af717cd73b0
+    LastModifiedDate | 2021-07-07T09:42:02.283Z
+    Name | Financing
+    IsAvailableForTagging | true
+    Owner | NT Service\SPTimerV4
+    Description |
+    IsDeprecated | false
+    IsKeyword | false
+    IsPinned | false
+    IsPinnedRoot | false
+    IsReused | false
+    IsRoot | true
+    IsSourceTerm | true
+    PathOfTerm | Financing
+    TermsCount | 0
+    ```

package/docs/docs/cmd/spo/term/term-set-add.md

@@ -11,22 +11,25 @@ m365 spo term set add [options]
 ## Options
 
 `-n, --name <name>`
-: Name of the term set to add
+: Name of the term set to add.
+
+`-u, --webUrl [webUrl]`
+: If specified, allows you to add a term set to the tenant term store as well as the sitecollection specific term store. Defaults to the tenant admin site.
 
 `--termGroupId [termGroupId]`
-: ID of the term group in which to create the term set. Specify `termGroupId` or `termGroupName` but not both
+: ID of the term group in which to create the term set. Specify `termGroupId` or `termGroupName` but not both.
 
 `--termGroupName [termGroupName]`
-: Name of the term group in which to create the term set. Specify `termGroupId` or `termGroupName` but not both
+: Name of the term group in which to create the term set. Specify `termGroupId` or `termGroupName` but not both.
 
 `-i, --id [id]`
-: ID of the term set to add
+: ID of the term set to add.
 
 `-d, --description [description]`
-: Description of the term set to add
+: Description of the term set to add.
 
 `--customProperties [customProperties]`
-: JSON string with key-value pairs representing custom properties to set on the term set
+: JSON string with key-value pairs representing custom properties to set on the term set.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -36,30 +39,111 @@ m365 spo term set add [options]
     When using the `--customProperties` option it's possible to enter a JSON string. In PowerShell 5 to 7.2 [specific escaping rules](./../../../user-guide/using-cli.md#escaping-double-quotes-in-powershell) apply due to an issue. Remember that you can also use [file tokens](./../../../user-guide/using-cli.md#passing-complex-content-into-cli-options) instead.
 
 !!! important
-    To use this command you have to have permissions to access the tenant admin site.
+    To use this command without the `--webUrl` option you have to have permissions to access the tenant admin site.
+
+When using the `--webUrl` option you can connect to the term store with limited permissions, and do not need the SharePoint Administrator role. You need to be a site visitor or more. It allows you to add a term set to a term group in the tenant term store if you are listed as a term store administrator. It allows you to add a term set to a term group in the sitecollection term store if you are a site owner.
 
 ## Examples
 
-Add taxonomy term set to the term group specified by ID
+Add taxonomy term set to the term group specified by ID.
 
 ```sh
 m365 spo term set add --name PnP-Organizations --termGroupId 0e8f395e-ff58-4d45-9ff7-e331ab728beb
 ```
 
-Add taxonomy term set to the term group specified by name. Create the term set with the specified ID
+Add taxonomy term set to the specified sitecollection's term group specified by ID.
+
+```sh
+m365 spo term set add --name PnP-Organizations --termGroupId 0e8f395e-ff58-4d45-9ff7-e331ab728beb --webUrl https://contoso.sharepoint.com/sites/project-x
+```
+
+Add taxonomy term set to the term group specified by name. Create the term set with the specified ID.
 
 ```sh
 m365 spo term set add --name PnP-Organizations --termGroupName PnPTermSets --id aa70ede6-83d1-466d-8d95-30d29e9bbd7c
 ```
 
-Add taxonomy term set and set its description
+Add taxonomy term set and set its description.
 
 ```sh
 m365 spo term set add --name PnP-Organizations --termGroupId 0e8f395e-ff58-4d45-9ff7-e331ab728beb --description 'Contains a list of organizations'
 ```
 
-Add taxonomy term set and set its custom properties
+Add taxonomy term set and set its custom properties.
 
 ```sh
 m365 spo term set add --name PnP-Organizations --termGroupId 0e8f395e-ff58-4d45-9ff7-e331ab728beb --customProperties '{"Property":"Value"}'
 ```
+
+## Response
+
+### Standard response
+
+=== "JSON"
+
+    ```json
+    {
+      "CreatedDate": "2023-05-14T10:28:31.041Z",
+      "Id": "c28cfcd2-0705-4b7b-b8e6-ba2fb107e5ec",
+      "LastModifiedDate": "2023-05-14T10:28:31.041Z",
+      "Name": "PnP-Organizations",
+      "CustomProperties": {},
+      "CustomSortOrder": null,
+      "IsAvailableForTagging": true,
+      "Owner": "i:0#.f|membership|john.doe@contoso.com",
+      "Contact": "",
+      "Description": "",
+      "IsOpenForTermCreation": false,
+      "Names": {
+        "1033": "PnP-Organizations"
+      },
+      "Stakeholders": []
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    Contact              :
+    CreatedDate          : 2023-05-14T10:30:41.018Z
+    CustomProperties     : {}
+    CustomSortOrder      : null
+    Description          :
+    Id                   : 41102744-9f7b-448b-a265-3bbe3db5c064
+    IsAvailableForTagging: true
+    IsOpenForTermCreation: false
+    LastModifiedDate     : 2023-05-14T10:30:41.018Z
+    Name                 : PnP-Organizations
+    Names                : {"1033":"PnP-Organizations"}
+    Owner                : i:0#.f|membership|john.doe@contoso.com
+    Stakeholders         : []
+    ```
+
+=== "CSV"
+
+    ```csv
+    CreatedDate,Id,LastModifiedDate,Name,IsAvailableForTagging,Owner,Contact,Description,IsOpenForTermCreation
+    2023-05-14T10:31:11.299Z,8f212d7d-eeb3-454b-811a-01b38fea56e1,2023-05-14T10:31:11.299Z,PnP-Organizations,1,i:0#.f|membership|john.doe@contoso.com,,,
+    ```
+
+=== "Markdown"
+
+    ```md
+    # spo term set add --name "PnP-Organizations" --termGroupId "0e8f395e-ff58-4d45-9ff7-e331ab728beb"
+
+    Date: 5/14/2023
+
+    ## PnP-Organizations (73824553-d254-44ef-ac0f-61926b65e925)
+
+    Property | Value
+    ---------|-------
+    CreatedDate | 2023-05-14T10:31:42.422Z
+    Id | 73824553-d254-44ef-ac0f-61926b65e925
+    LastModifiedDate | 2023-05-14T10:31:42.422Z
+    Name | PnP-Organizations
+    IsAvailableForTagging | true
+    Owner | i:0#.f\|membership\|john.doe@contoso.com
+    Contact |
+    Description |
+    IsOpenForTermCreation | false
+    ```

package/docs/docs/cmd/spo/term/term-set-get.md

@@ -10,35 +10,119 @@ m365 spo term set get [options]
 
 ## Options
 
+`-u, --webUrl [webUrl]`
+: If specified, allows you to get a term set from the tenant term store as well as the sitecollection specific term store. Defaults to the tenant admin site.
+
 `-i, --id [id]`
-: ID of the term set to retrieve. Specify `name` or `id` but not both
+: ID of the term set to retrieve. Specify `name` or `id` but not both.
 
 `-n, --name [name]`
-: Name of the term set to retrieve. Specify `name` or `id` but not both
+: Name of the term set to retrieve. Specify `name` or `id` but not both.
 
 `--termGroupId [termGroupId]`
-: ID of the term group to which the term set belongs. Specify `termGroupId` or `termGroupName` but not both
+: ID of the term group to which the term set belongs. Specify `termGroupId` or `termGroupName` but not both.
 
 `--termGroupName [termGroupName]`
-: Name of the term group to which the term set belongs. Specify `termGroupId` or `termGroupName` but not both
+: Name of the term group to which the term set belongs. Specify `termGroupId` or `termGroupName` but not both.
 
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
 
 !!! important
-    To use this command you have to have permissions to access the tenant admin site.
+    To use this command without the --webUrl option you have to have permissions to access the tenant admin site.
+
+When using the `--webUrl` option you can connect to the term store with limited permissions, and do not need the SharePoint Administrator role. You need to be a site visitor or more. It allows you to get a term set from the tenant term store as well as a term set from the sitecollection term store.
 
 ## Examples
 
-Get information about a taxonomy term set using its ID
+Get information about a taxonomy term set using its ID.
 
 ```sh
 m365 spo term set get --id 0e8f395e-ff58-4d45-9ff7-e331ab728beb --termGroupName PnPTermSets
 ```
 
-Get information about a taxonomy term set using its name
+Get information about a taxonomy term set using its name.
 
 ```sh
-m365 spo term set get --name PnPTermSets --termGroupId 0e8f395e-ff58-4d45-9ff7-e331ab728beb
+m365 spo term set get --name PnP-Organizations --termGroupId 0a099ee9-e231-4ae9-a5b6-d7f94a0d241d
 ```
+
+Get information about a taxonomy term set using its ID from the specified sitecollection.
+
+```sh
+m365 spo term set get --id 0e8f395e-ff58-4d45-9ff7-e331ab728beb --termGroupName PnPTermSets --webUrl https://contoso.sharepoint.com/sites/project-x
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "CreatedDate": "2019-09-03T06:41:32.110Z",
+      "Id": "0e8f395e-ff58-4d45-9ff7-e331ab728beb",
+      "LastModifiedDate": "2019-09-03T06:41:32.260Z",
+      "Name": "PnP-Organizations",
+      "CustomProperties": {
+        "SearchCenterNavVer": "15"
+      },
+      "CustomSortOrder": null,
+      "IsAvailableForTagging": true,
+      "Owner": "",
+      "Contact": "",
+      "Description": "",
+      "IsOpenForTermCreation": true,
+      "Names": {
+        "1033": "PnP-Organizations"
+      },
+      "Stakeholders": []
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    Contact              :
+    CreatedDate          : 2019-09-03T06:41:32.110Z
+    CustomProperties     : {"SearchCenterNavVer":"15"}
+    CustomSortOrder      : null
+    Description          :
+    Id                   : 0e8f395e-ff58-4d45-9ff7-e331ab728beb
+    IsAvailableForTagging: true
+    IsOpenForTermCreation: true
+    LastModifiedDate     : 2019-09-03T06:41:32.260Z
+    Name                 : PnP-Organizations
+    Names                : {"1033":"PnP-Organizations"}
+    Owner                :
+    Stakeholders         : []
+    ```
+
+=== "CSV"
+
+    ```csv
+    CreatedDate,Id,LastModifiedDate,Name,IsAvailableForTagging,Owner,Contact,Description,IsOpenForTermCreation
+    2019-09-03T06:41:32.110Z,0e8f395e-ff58-4d45-9ff7-e331ab728beb,2019-09-03T06:41:32.260Z,PnP-Organizations,1,,,,1
+    ```
+
+=== "Markdown"
+
+    ```md
+    # spo term set get --name "PnP-Organizations" --termGroupName "PnPTermSets"
+
+    Date: 5/9/2023
+
+    ## PnP-Organizations (0e8f395e-ff58-4d45-9ff7-e331ab728beb)
+
+    Property | Value
+    ---------|-------
+    CreatedDate | 2019-09-03T06:41:32.110Z
+    Id | 0e8f395e-ff58-4d45-9ff7-e331ab728beb
+    LastModifiedDate | 2019-09-03T06:41:32.260Z
+    Name | PnP-Organizations
+    IsAvailableForTagging | true
+    Owner |
+    Contact |
+    Description |
+    IsOpenForTermCreation | true
+    ```

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

@@ -10,29 +10,109 @@ m365 spo term set list [options]
 
 ## Options
 
+`-u, --webUrl [webUrl]`
+: If specified, allows you to list term sets from the tenant term store as well as the sitecollection specific term store. Defaults to the tenant admin site.
+
 `--termGroupId [termGroupId]`
-: ID of the term group from which to retrieve term sets. Specify `termGroupName` or `termGroupId` but not both
+: ID of the term group from which to retrieve term sets. Specify `termGroupName` or `termGroupId` but not both.
 
 `--termGroupName [termGroupName]`
-: Name of the term group from which to retrieve term sets. Specify `termGroupName` or `termGroupId` but not both
+: Name of the term group from which to retrieve term sets. Specify `termGroupName` or `termGroupId` but not both.
 
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
 
 !!! important
-    To use this command you have to have permissions to access the tenant admin site.
+    To use this command without the --webUrl option you have to have permissions to access the tenant admin site.
+
+When using the `--webUrl` option you can connect to the term store with limited permissions, and do not need the SharePoint Administrator role. You need to be a site visitor or more. It allows you to list term sets from the tenant term store as well as term sets from the sitecollection term store.
 
 ## Examples
 
-List taxonomy term sets from the term group with the given name
+List taxonomy term sets from the term group with the given name.
 
 ```sh
 m365 spo term set list --termGroupName PnPTermSets
 ```
 
-List taxonomy term sets from the term group with the given ID
+List taxonomy term sets from the term group with the given ID.
 
 ```sh
 m365 spo term set list --termGroupId 0e8f395e-ff58-4d45-9ff7-e331ab728beb
 ```
+
+List taxonomy term sets from the specified sitecollection, from the term group with the given name.
+
+```sh
+m365 spo term set list --termGroupName PnPTermSets --webUrl https://contoso.sharepoint.com/sites/project-x
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "_ObjectType_": "SP.Taxonomy.TermSet",
+        "_ObjectIdentity_": "676eb2a0-80e7-2000-3976-610eb3f5a91e|fec14c62-7c3b-481b-851b-c80d7802b224:se:aCf0Cz4D9UOS7+b/OlUY5XrNqUp10tpPhLK4MIXc7g/qydiOUnAdTKTXucEL/+pv",
+        "CreatedDate": "2019-09-03T06:41:32.110Z",
+        "Id": "8ed8c9ea-7052-4c1d-a4d7-b9c10bffea6f",
+        "LastModifiedDate": "2019-09-03T06:41:32.260Z",
+        "Name": "Department",
+        "CustomProperties": {
+          "SearchCenterNavVer": "15"
+        },
+        "CustomSortOrder": null,
+        "IsAvailableForTagging": true,
+        "Owner": "",
+        "Contact": "",
+        "Description": "",
+        "IsOpenForTermCreation": true,
+        "Names": {
+          "1033": "Department"
+        },
+        "Stakeholders": []
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    Id                                    Name
+    ------------------------------------  ----------
+    8ed8c9ea-7052-4c1d-a4d7-b9c10bffea6f  Department
+    ```
+
+=== "CSV"
+
+    ```csv
+    _ObjectType_,_ObjectIdentity_,CreatedDate,Id,LastModifiedDate,Name,IsAvailableForTagging,Owner,Contact,Description,IsOpenForTermCreation
+    SP.Taxonomy.TermSet,7c6eb2a0-20fe-2000-47f1-69774ac909f5|fec14c62-7c3b-481b-851b-c80d7802b224:se:aCf0Cz4D9UOS7+b/OlUY5XrNqUp10tpPhLK4MIXc7g/qydiOUnAdTKTXucEL/+pv,2019-09-03T06:41:32.110Z,8ed8c9ea-7052-4c1d-a4d7-b9c10bffea6f,2019-09-03T06:41:32.260Z,Department,1,,,,1
+    ```
+
+=== "Markdown"
+
+    ```md
+    # spo term set list --termGroupName "PnPTermSets"
+
+    Date: 5/13/2023
+
+    ## Department (8ed8c9ea-7052-4c1d-a4d7-b9c10bffea6f)
+
+    Property | Value
+    ---------|-------
+    \_ObjectType\_ | SP.Taxonomy.TermSet
+    \_ObjectIdentity\_ | 826eb2a0-405f-2000-41be-bfe56d4cdc73\|fec14c62-7c3b-481b-851b-c80d7802b224:se:aCf0Cz4D9UOS7+b/OlUY5XrNqUp10tpPhLK4MIXc7g/qydiOUnAdTKTXucEL/+pv
+    CreatedDate | 2019-09-03T06:41:32.110Z
+    Id | 8ed8c9ea-7052-4c1d-a4d7-b9c10bffea6f
+    LastModifiedDate | 2019-09-03T06:41:32.260Z
+    Name | Department
+    IsAvailableForTagging | true
+    Owner |
+    Contact |
+    Description |
+    IsOpenForTermCreation | true
+    ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "6.8.0-beta.a10f6e4",
+  "version": "6.8.0-beta.c74eb4b",
   "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
   "license": "MIT",
   "main": "./dist/api.js",