Skip to main content

spo term group add

Adds taxonomy term group

Usage​

m365 spo term group add [options]

Options​

-n, --name <name>

Name of the term group to add

-i, --id [id]

ID of the term group to add

-d, --description [description]

Description of the term group to add

-u, --webUrl [webUrl]

If specified, allows you to add a term group to the tenant term store as a term store administrator without the SharePoint administrator role.

-h, --help [help]

Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, response, full. Default is options.

--query [query]

JMESPath query string. See http://jmespath.org/ for more information and examples.

-o, --output [output]

Output type. json, text, csv, md, none. Default json.

--verbose

Runs command with verbose logging.

--debug

Runs command with debug logging.

Remarks​

caution

To use this command without the --webUrl option you must 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. It allows you to add a term group to the tenant term store if you are listed as a term store administrator.

This command does not create a sitecollection specific term store/group when using the --webUrl option.

Examples​

Add a new taxonomy term group with the specified name

m365 spo term group add --name PnPTermSets

Add a new taxonomy term group with the specified name and id

m365 spo term group add --name PnPTermSets --id 0e8f395e-ff58-4d45-9ff7-e331ab728beb

Add a new taxonomy term group with the specified name and description with limited permissions

m365 spo term group add --name PnPTermSets --description 'Term sets for PnP' --webUrl 'https://contoso.sharepoint.com'

Response​

{
  "Name": "PnPTermSets",
  "Id": "cafe662c-c3fa-4c83-bcb0-50b701b37164",
  "Description": "Term sets for PnP"
}
CTRL + M