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

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

@@ -10,17 +10,85 @@ m365 spo term group list [options]
 
 ## Options
 
+`-u, --webUrl [webUrl]`
+: If specified, allows you to list term groups from the tenant term store as well as the sitecollection specific term store. Defaults to the tenant admin site.
+
 --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 Adminstrator role. You need to be a site visitor or more. It allows you to list term groups from the tenant term store as well as term groups from the sitecollection term store.
 
 ## Examples
 
-List taxonomy term groups
+List taxonomy term groups.
 
 ```sh
 m365 spo term group list
 ```
+
+List taxonomy term groups from the specified sitecollection.
+
+```sh
+m365 spo term group list --webUrl https://contoso.sharepoint.com/sites/project-x
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "_ObjectType_": "SP.Taxonomy.TermGroup",
+        "_ObjectIdentity_": "5522b1a0-b01a-2000-4160-d04eee2e977f|fec14c62-7c3b-481b-851b-c80d7802b224:gr:aCf0Cz4D9UOS7+b/OlUY5XrNqUp10tpPhLK4MIXc7g8=",
+        "CreatedDate": "2019-09-03T06:41:32.070Z",
+        "Id": "4aa9cd7a-d275-4fda-84b2-b83085dcee0f",
+        "LastModifiedDate": "2019-09-03T06:41:32.070Z",
+        "Name": "People",
+        "Description": "",
+        "IsSiteCollectionGroup": false,
+        "IsSystemGroup": false
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    Id                                    Name
+    ------------------------------------  -----------------------------------------------------------
+    4aa9cd7a-d275-4fda-84b2-b83085dcee0f  People
+    ```
+
+=== "CSV"
+
+    ```csv
+      _ObjectType_,_ObjectIdentity_,CreatedDate,Id,LastModifiedDate,Name,Description,IsSiteCollectionGroup,IsSystemGroup
+      SP.Taxonomy.TermGroup,7522b1a0-804d-2000-41be-bba084eae72f|fec14c62-7c3b-481b-851b-c80d7802b224:gr:aCf0Cz4D9UOS7+b/OlUY5XrNqUp10tpPhLK4MIXc7g8=,2019-09-03T06:41:32.070Z,4aa9cd7a-d275-4fda-84b2-b83085dcee0f,2019-09-03T06:41:32.070Z,People,,,
+    ```
+
+=== "Markdown"
+
+    ```md
+    # spo term group list
+
+    Date: 5/9/2023
+
+    ## People (4aa9cd7a-d275-4fda-84b2-b83085dcee0f)
+
+    Property | Value
+    ---------|-------
+    \_ObjectType\_ | SP.Taxonomy.TermGroup
+    \_ObjectIdentity\_ | 8c22b1a0-200f-2000-3976-694ba2bf8a01\|fec14c62-7c3b-481b-851b-c80d7802b224:gr:aCf0Cz4D9UOS7+b/OlUY5XrNqUp10tpPhLK4MIXc7g8=
+    CreatedDate | 2019-09-03T06:41:32.070Z
+    Id | 4aa9cd7a-d275-4fda-84b2-b83085dcee0f
+    LastModifiedDate | 2019-09-03T06:41:32.070Z
+    Name | People
+    Description |
+    IsSiteCollectionGroup | false
+    IsSystemGroup | false
+    ```

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 Adminstrator 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-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 Adminstrator 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/package.json

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