Visão geral das configurações de grupo

As configurações de grupo, também conhecidas como configurações de diretório no beta, são uma coleção de configurações que permitem gerenciar comportamentos para objetos específicos do Microsoft Entra, como grupos do Microsoft 365. Essas configurações podem ser aplicadas em todo o locatário ou a objetos específicos, permitindo que você controle vários aspectos da funcionalidade do grupo.

Neste artigo, exploramos os diferentes tipos de configurações de grupo e nos aprofundamos nas configurações aplicáveis aos grupos do Microsoft 365

Tipos de configurações de grupo

As configurações de grupo são organizadas em modelos, cada um contendo uma coleção de configurações individuais. Esses modelos são somente leitura e definem os comportamentos permitidos para objetos específicos do Microsoft Entra. Os seguintes grupos de modelos de configuração estão disponíveis:

Os modelos de configuração estão disponíveis por meio do tipo de recurso groupSettingTemplates e v1.0 do tipo de recurso directorySettingTemplates em beta.

Inicialmente, o Microsoft Entra ID atribui a configuração padrão ao locatário e não há nenhum objeto de configuração. Para alterar as configurações padrão, você deve criar um novo objeto de configurações a partir de um modelo de configurações.

Nos modelos de configuração, você pode definir configurações para todo o locatário ou configurações para objetos individuais. Use o tipo v1.0 de recurso groupSettings ou o tipobeta de recurso directorySetting e suas APIs associadas.

Para grupos, as configurações estão disponíveis para grupos do Microsoft 365 e grupos de segurança de nuvem. Não há suporte para grupos de segurança e listas de distribuição habilitados para email.

Group.Unified

Este objeto especifica as configurações de grupo do Microsoft 365 para seu locatário.

Salvo indicação em contrário, esses recursos exigem uma licença do Microsoft Entra ID P1.

Group.Unified.Guest

As configurações nesse objeto especificam se os convidados podem ser adicionados a todos ou a grupos específicos do Microsoft 365 no locatário. Somente uma configuração está disponível nesta coleção.

Group.Security

Especifica configurações para grupos de segurança de nuvem no nível do locatário ou para grupos específicos. Para obter mais informações sobre rótulos de confidencialidade para grupos de segurança, consulte Rótulos de confidencialidade para grupos do Microsoft 365 e grupos de segurança de nuvem.

Group.Security.Policies

Especifica configurações para grupos de segurança de nuvem.

Como gerenciar uma configuração de grupo

Para gerenciar uma configuração de grupo:

1. Primeiro, recupere os detalhes do modelo de configuração de grupo que você deseja usar usando a API List groupSettings.
2. Crie a configuração de grupo: use o modelo recuperado para criar uma nova configuração de grupo: Create groupSetting (v1.0) ou Create directorySetting (beta).
3. Atualize a configuração do grupo: Se necessário, atualize a configuração do grupo com valores específicos.

Exemplo: configurar um prefixo para nomes de grupo do Microsoft 365

Etapa 1: Recuperar a configuração da configuração de grupo PrefixSuffixNamingRequirement

Você deve recuperar todas as configurações de grupo porque a API não dá suporte à filtragem. A PrefixSuffixNamingRequirement configuração de grupo está contida no Group.Unified modelo.

Solicitação

GET https://graph.microsoft.com/v1.0/groupSettingTemplates

// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.GroupSettingTemplates.GetAsync();

// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
groupSettingTemplates, err := graphClient.GroupSettingTemplates().Get(context.Background(), nil)

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

GroupSettingTemplateCollectionResponse result = graphClient.groupSettingTemplates().get();

const options = {
	authProvider,
};

const client = Client.init(options);

let groupSettingTemplates = await client.api('/groupSettingTemplates')
	.get();

<?php
use Microsoft\Graph\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$result = $graphServiceClient->groupSettingTemplates()->get()->wait();

Import-Module Microsoft.Graph.Groups

Get-MgGroupSettingTemplateGroupSettingTemplate

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.group_setting_templates.get()

Resposta

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#groupSettingTemplates",
    "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET groupSettingTemplates?$select=description,displayName",
    "value": [
        {
            "id": "62375ab9-6b52-47ed-826b-58e47e0e304b",
            "deletedDateTime": null,
            "displayName": "Group.Unified",
            "description": "\n        Setting templates define the different settings that can be used for the associated ObjectSettings. This template defines\n        settings that can be used for Unified Groups.\n      ",
            "values": [
                {
                    "name": "PrefixSuffixNamingRequirement",
                    "type": "System.String",
                    "defaultValue": "",
                    "description": "A structured string describing how a Unified Group displayName and mailNickname should be structured. Please refer to docs to discover how to structure a valid requirement."
                }
            ]
        }
    ]
}

Etapa 2: Criar a política de prefixo de grupo para todo o locatário

Solicitação

A solicitação a seguir especifica apenas a PrefixSuffixNamingRequirement configuração. A solicitação cria a configuração de grupo e atribui valores padrão a outras configurações no Group.Unified modelo.

POST https://graph.microsoft.com/v1.0/groupSettings

{
    "templateId": "62375ab9-6b52-47ed-826b-58e47e0e304b",
    "values": [
        {
            "name": "PrefixSuffixNamingRequirement",
            "value": "[Contoso-][GroupName]"
        }
    ]
}

// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.GroupSettingTemplates.GetAsync();

// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
groupSettingTemplates, err := graphClient.GroupSettingTemplates().Get(context.Background(), nil)

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

GroupSettingTemplateCollectionResponse result = graphClient.groupSettingTemplates().get();

const options = {
	authProvider,
};

const client = Client.init(options);

let groupSettingTemplates = await client.api('/groupSettingTemplates')
	.get();

<?php
use Microsoft\Graph\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$result = $graphServiceClient->groupSettingTemplates()->get()->wait();

Import-Module Microsoft.Graph.Groups

Get-MgGroupSettingTemplateGroupSettingTemplate

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.group_setting_templates.get()

Resposta

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

HTTP/1.1 201 Created
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#groupSettings/$entity",
    "id": "98208f14-04ff-4a4e-9a67-3dcb5fa6fd6f",
    "displayName": null,
    "templateId": "62375ab9-6b52-47ed-826b-58e47e0e304b",
    "values": [
        {
            "name": "PrefixSuffixNamingRequirement",
            "value": "[Contoso-][GroupName]"
        }
    ]
}

Conteúdo relacionado

• groupSettingTemplate tipo de recurso
• groupSettings tipo de recurso