Type de ressource groupSetting

Espace de noms: microsoft.graph

Les paramètres de groupe définissent les configurations qui peuvent être utilisées pour personnaliser les restrictions et le comportement autorisé à l’échelle du locataire et de l’objet. Pour obtenir des exemples, vous pouvez bloquer les listes de mots pour les noms d’affichage des groupes ou définir si les invités sont autorisés à être propriétaires de groupes.

Par défaut, tous les groupes héritent des valeurs par défaut prédéfinies. Pour modifier les paramètres par défaut, vous devez créer un objet settings à l’aide de groupSettingTemplates. Lorsque le même paramètre est défini à l’échelle du locataire et à un groupe spécifique, le paramètre au niveau du groupe remplace le paramètre à l’échelle du locataire. Par exemple, le paramètre à l’échelle du locataire peut autoriser les membres existants des groupes à inviter des invités ; mais un paramètre de groupe individuel peut remplacer et ne pas autoriser l’opération.

Les paramètres spécifiques aux groupes s’appliquent uniquement aux groupes Microsoft 365.

Conseil

La /beta version de cette ressource est nommée directorySetting.

Méthodes

Méthode Type renvoyé Description
List Collection de groupSettings Liste des paramètres de tous les objets de paramètre.
Create groupSetting Créez un objet de paramètre basé sur un groupSettingTemplate.
Obtenir groupSetting Lisez les propriétés d’un objet de paramètre spécifique.
Mettre à jour groupSetting Mettez à jour l’objet de paramètre.
Supprimer Aucun Supprimez un objet de paramètre.

Propriétés

Propriété Type Description
displayName Chaîne Nom d’affichage de ce groupe de paramètres, qui provient du modèle associé.
id Chaîne Identificateur unique pour ces paramètres. En lecture seule.
templateId Chaîne Identificateur unique de l’objet groupSettingTemplates au niveau du locataire qui a été personnalisé pour cet objet de paramètres au niveau du groupe. En lecture seule.
values collection settingValue Collection de paires nom-valeur correspondant aux propriétés name et defaultValue dans l’objet groupSettingTemplates référencé.

Relations

Aucun.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "displayName": "String",
  "id": "String (identifier)",
  "templateId": "String",
  "values": [{ "@odata.type": "microsoft.graph.settingValue" }]
}