Partager via


Type de ressource directorySetting

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Les paramètres d’annuaire définissent les configurations qui peuvent être utilisées pour personnaliser les restrictions et le comportement autorisé à l’échelle du locataire et spécifiques à 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, toutes les entités 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 directorySettingTemplates. Lorsque le même paramètre est défini à l’échelle du locataire et à un groupe spécifique, le paramètre au niveau de l’entité 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 /v1.0 version de cette ressource est nommée groupSetting.

Méthodes

Méthode Type renvoyé Description
List collectiondirectorySetting Liste des paramètres de tous les objets de paramètre.
Create directorySetting Créez un objet de paramètre basé sur un directorySettingTemplate.
Obtenir directorySetting Lisez les propriétés d’un objet de paramètre spécifique.
Mettre à jour directorySetting Mettre à jour un objet de paramètre. Seules les valeurs settingValues peuvent être modifiées dans une mise à jour.
Supprimer Aucun Supprimez un objet de paramètre.

Propriétés

Propriété Type Description
displayName string Nom d’affichage de ce groupe de paramètres, qui provient du modèle associé. En lecture seule.
id chaîne Identificateur unique pour ces paramètres. En lecture seule.
templateId chaîne Identificateur unique du modèle utilisé pour créer ce groupe de paramètres. En lecture seule.
values collection settingValue Collection de paires nom-valeur correspondant aux propriétés name et defaultValue dans l’objet directorySettingTemplates 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"}]
}