Skip to main content

entra groupsetting add

Creates a group setting

Usage​

m365 entra groupsetting add [options]

Alias​

m365 aad groupsetting add [options]

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 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​

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

Examples​

Configure classification for modern SharePoint sites

m365 entra groupsetting add --templateId 62375ab9-6b52-47ed-826b-58e47e0e304b --UsageGuidelinesUrl https://contoso.sharepoint.com/sites/compliance --ClassificationList 'HBI, MBI, LBI, GDPR' --DefaultClassification MBI

Response​

{
  "id": "c01f5e50-aabf-4851-983b-dd7d59b8f07c",
  "displayName": null,
  "templateId": "62375ab9-6b52-47ed-826b-58e47e0e304b",
  "values": [
    {
      "name": "UsageGuidelinesUrl",
      "value": "https://contoso.sharepoint.com/sites/compliance"
    },
    {
      "name": "ClassificationList",
      "value": "HBI, MBI, LBI, GDPR"
    },
    {
      "name": "DefaultClassification",
      "value": "MBI"
    },
    {
      "name": "NewUnifiedGroupWritebackDefault",
      "value": "true"
    },
    {
      "name": "EnableMIPLabels",
      "value": "false"
    },
    {
      "name": "CustomBlockedWordsList",
      "value": ""
    },
    {
      "name": "EnableMSStandardBlockedWords",
      "value": "false"
    },
    {
      "name": "ClassificationDescriptions",
      "value": ""
    },
    {
      "name": "PrefixSuffixNamingRequirement",
      "value": ""
    },
    {
      "name": "AllowGuestsToBeGroupOwner",
      "value": "false"
    },
    {
      "name": "AllowGuestsToAccessGroups",
      "value": "true"
    },
    {
      "name": "GuestUsageGuidelinesUrl",
      "value": ""
    },
    {
      "name": "GroupCreationAllowedGroupId",
      "value": ""
    },
    {
      "name": "AllowToAddGuests",
      "value": "true"
    },
    {
      "name": "EnableGroupCreation",
      "value": "true"
    }
  ]
}
CTRL + M