Skip to content

aad groupsetting add

Creates a group setting


aad groupsetting add [options]


Option Description
--help output usage information
-i, --templateId <templateId> The ID of the group setting template to use to create the group setting
--query [query] JMESPath query string. See for more information and examples
-o, --output [output] Output type. json,text. Default text
--pretty Prettifies json output
--verbose Runs command with verbose logging
--debug 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

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