Skip to main content

aad groupsetting add

Creates a group setting


m365 aad groupsetting add [options]


-i, --templateId <templateId>

The ID of the group setting template to use to create the group setting

-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 full.

--query [query]

JMESPath query string. See for more information and examples.

-o, --output [output]

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


Runs command with verbose logging.


Runs command with debug logging.


To create a group setting, you have to specify the ID of the group setting template that should be used to create the setting. You can retrieve the ID of the template using the aad groupsettingtemplate list command.

To specify values for the different properties specified in the group setting template, include additional options that match the property in the group setting template. For example --ClassificationList 'HBI, MBI, LBI, GDPR' will set the list of classifications to use on modern SharePoint sites.

Each group setting template specifies default value for each property. If you don't specify a value for the particular property yourself, the default value from the group setting template will be used. To find out which properties are available for the particular group setting template, use the aad groupsettingtemplate get command.

If the specified templateId doesn't reference a valid group setting template, you will get a Resource 'xyz' does not exist or one of its queried reference-property objects are not present. error.

If you try to add a group setting using a template, for which a setting already exists, you will get a A conflicting object with one or more of the specified property values is present in the directory. error.


Configure classification for modern SharePoint sites

m365 aad groupsetting add --templateId 62375ab9-6b52-47ed-826b-58e47e0e304b --UsageGuidelinesUrl --ClassificationList 'HBI, MBI, LBI, GDPR' --DefaultClassification MBI