Mettre à jour 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 .
Mettez à jour les propriétés d’un objet de paramètre de répertoire spécifique.
Cette API est disponible dans les déploiements de cloud national suivants.
Service global | Gouvernement des États-Unis L4 | Us Government L5 (DOD) | Chine gérée par 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Autorisations
Les tableaux suivants indiquent l’autorisation ou les autorisations les moins privilégiées requises pour appeler cette API sur chaque type de ressource pris en charge. Suivez les bonnes pratiques pour demander des autorisations minimales. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.
Pour tous les paramètres à l’exception de l’objet Paramètres de stratégie de consentement
Type d’autorisation | Autorisations avec privilèges minimum | Autorisations privilégiées plus élevées |
---|---|---|
Déléguée (compte professionnel ou scolaire) | Directory.ReadWrite.All | Policy.ReadWrite.Authorization |
Déléguée (compte Microsoft personnel) | Non prise en charge. | Non prise en charge. |
Application | Directory.ReadWrite.All | Policy.ReadWrite.Authorization |
Pour l’objet Paramètres de stratégie de consentement
Les autorisations suivantes sont requises pour mettre à jour l’objet directorySetting « Paramètres de stratégie de consentement ».
Type d’autorisation | Autorisations avec privilèges minimum | Autorisations privilégiées plus élevées |
---|---|---|
Déléguée (compte professionnel ou scolaire) | Directory.ReadWrite.All | Policy.ReadWrite.Authorization |
Déléguée (compte Microsoft personnel) | Non prise en charge. | Non prise en charge. |
Application | Directory.ReadWrite.All | Policy.ReadWrite.Authorization |
Pour les scénarios délégués, l’utilisateur appelant a besoin d’au moins l’un des rôles Microsoft Entra suivants.
Microsoft Entra rôle | Privilèges autorisés |
---|---|
Microsoft Entra Administrateur local de l’appareil joint Lecteurs d’annuaire Lecteur général |
Lire les propriétés de base sur la définition des modèles et des paramètres |
Administrateur de groupes Rédacteurs d'annuaires |
Gérer tous les paramètres de groupe |
Administrateur de stratégie d’authentification | Mettre à jour Password Rule Settings |
Administrateur d’utilisateurs | Lire les propriétés de base sur la définition des modèles et des paramètres Définir les paramètres de mise à jour |
Requête HTTP
Mettre à jour un paramètre à l’échelle du locataire.
PATCH /settings/{directorySettingId}
Mettez à jour un paramètre spécifique au groupe.
PATCH /groups/{groupId}/settings/{directorySettingId}
En-têtes de demande facultatifs
Nom | Description |
---|---|
Autorisation | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation. |
Corps de la demande
Dans le corps de la demande, fournissez les valeurs pour les champs appropriés qui doivent être mis à jour.
Propriété | Type | Description |
---|---|---|
values | collection settingValue | Ensemble de valeurs mis à jour. REMARQUE : vous devez fournir l’ensemble de la collection. Vous ne pouvez pas mettre à jour un seul ensemble de valeurs. |
Réponse
Si elle réussit, cette méthode renvoie un code de réponse 204 No Content
.
Exemple
Demande
L’exemple suivant illustre une demande.
PATCH https://graph.microsoft.com/beta/settings/3c105fc3-2254-4861-9e2d-d59e2126f3ef
Content-type: application/json
{
"values": [
{
"name": "CustomBlockedWordsList",
"value": "Contoso"
}
]
}
Réponse
HTTP/1.1 204 No Content
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour