@pnp/cli-microsoft365 6.8.0-beta.9f8a015 → 6.8.0-beta.ce342e4

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

@@ -10,23 +10,26 @@ m365 spo term get [options]
 
 ## Options
 
+`-u, --webUrl [webUrl]`
+: If specified, allows you to get a term 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 to retrieve. Specify `name` or `id` but not both
+: ID of the term to retrieve. Specify `name` or `id` but not both.
 
 `-n, --name [name]`
-: Name of the term to retrieve. Specify `name` or `id` but not both
+: Name of the term 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.
 
 `--termSetId [termSetId]`
-: ID of the term set to which the term belongs. Specify `termSetId` or `termSetName` but not both
+: ID of the term set to which the term belongs. Specify `termSetId` or `termSetName` but not both.
 
 `--termSetName [termSetName]`
-: Name of the term set to which the term belongs. Specify `termSetId` or `termSetName` but not both
+: Name of the term set to which the term belongs. Specify `termSetId` or `termSetName` but not both.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -35,24 +38,122 @@ m365 spo term get [options]
 When retrieving term by its ID, it's sufficient to specify just the ID. When retrieving it by its name however, you need to specify the parent term group and term set using either their names or IDs.
 
 !!! 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 from the tenant term store as well as a term from the sitecollection term store.
+
 ## Examples
 
-Get information about a taxonomy term using its ID
+Get information about a taxonomy term using its ID from the specified sitecollection.
+
+```sh
+m365 spo term get --webUrl https://contoso.sharepoint.com/sites/project-x --id 0e8f395e-ff58-4d45-9ff7-e331ab728beb
+```
+
+Get information about a taxonomy term using its ID.
 
 ```sh
 m365 spo term get --id 0e8f395e-ff58-4d45-9ff7-e331ab728beb
 ```
 
-Get information about a taxonomy term using its name, retrieving the parent term group and term set using their names
+Get information about a taxonomy term using its name, retrieving the parent term group and term set using their names.
 
 ```sh
 m365 spo term get --name IT --termGroupName People --termSetName Department
 ```
 
-Get information about a taxonomy term using its name, retrieving the parent term group and term set using their IDs
+Get information about a taxonomy term using its name, retrieving the parent term group and term set using their IDs.
 
 ```sh
 m365 spo term get --name IT --termGroupId 5c928151-c140-4d48-aab9-54da901c7fef --termSetId 8ed8c9ea-7052-4c1d-a4d7-b9c10bffea6f
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "CreatedDate": "2021-07-07T09:42:02.283Z",
+      "Id": "2b5c71a6-d72b-49a8-a3bf-d80636d85b44",
+      "LastModifiedDate": "2021-07-07T09:42:02.283Z",
+      "Name": "IT",
+      "CustomProperties": {},
+      "CustomSortOrder": null,
+      "IsAvailableForTagging": true,
+      "Owner": "NT Service\\SPTimerV4",
+      "Description": "",
+      "IsDeprecated": false,
+      "IsKeyword": false,
+      "IsPinned": false,
+      "IsPinnedRoot": false,
+      "IsReused": false,
+      "IsRoot": true,
+      "IsSourceTerm": true,
+      "LocalCustomProperties": {},
+      "MergedTermIds": [],
+      "PathOfTerm": "IT",
+      "TermsCount": 1
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    CreatedDate          : 2021-07-07T09:42:02.283Z
+    CustomProperties     : {}
+    CustomSortOrder      : null
+    Description          :
+    Id                   : 2b5c71a6-d72b-49a8-a3bf-d80636d85b44
+    IsAvailableForTagging: true
+    IsDeprecated         : false
+    IsKeyword            : false
+    IsPinned             : false
+    IsPinnedRoot         : false
+    IsReused             : false
+    IsRoot               : true
+    IsSourceTerm         : true
+    LastModifiedDate     : 2021-07-07T09:42:02.283Z
+    LocalCustomProperties: {}
+    MergedTermIds        : []
+    Name                 : IT
+    Owner                : NT Service\SPTimerV4
+    PathOfTerm           : IT
+    TermsCount           : 1
+    ```
+
+=== "CSV"
+
+    ```csv
+    CreatedDate,Id,LastModifiedDate,Name,IsAvailableForTagging,Owner,Description,IsDeprecated,IsKeyword,IsPinned,IsPinnedRoot,IsReused,IsRoot,IsSourceTerm,PathOfTerm,TermsCount
+    2021-07-07T09:42:02.283Z,2b5c71a6-d72b-49a8-a3bf-d80636d85b44,2021-07-07T09:42:02.283Z,IT,1,NT Service\SPTimerV4,,,,,,,1,1,IT,1
+    ```
+
+=== "Markdown"
+
+    ```md
+    # spo term get --termGroupName "People" --termSetName "Department" --name "IT"
+
+    Date: 5/8/2023
+
+    ## IT (2b5c71a6-d72b-49a8-a3bf-d80636d85b44)
+
+    Property | Value
+    ---------|-------
+    CreatedDate | 2021-07-07T09:42:02.283Z
+    Id | 2b5c71a6-d72b-49a8-a3bf-d80636d85b44
+    LastModifiedDate | 2021-07-07T09:42:02.283Z
+    Name | IT
+    IsAvailableForTagging | true
+    Owner | NT Service\SPTimerV4
+    Description |
+    IsDeprecated | false
+    IsKeyword | false
+    IsPinned | false
+    IsPinnedRoot | false
+    IsReused | false
+    IsRoot | true
+    IsSourceTerm | true
+    PathOfTerm | IT
+    TermsCount | 1
+    ```

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.9f8a015",
+  "version": "6.8.0-beta.ce342e4",
   "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
   "license": "MIT",
   "main": "./dist/api.js",