type de ressource de recommandation

  • Article

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 .

Représente une bonne pratique ou une action d’amélioration de l’ID Microsoft Entra recommandée par Microsoft pour votre locataire Microsoft Entra.

Le service de recommandation Microsoft Entra s’exécute quotidiennement pour vérifier votre locataire par rapport aux conditions prédéfinies pour chaque recommandation. Si le service détecte qu’une recommandation s’applique à votre locataire, l’objet de recommandation correspondant est généré et son état est défini sur actif.

Pour plus d’informations, consultez Qu’est-ce que les recommandations Microsoft Entra ?.

Hérite de recommendationBase.

Méthodes

Méthode Type de retour Description
List collection de recommandations Obtenez la liste des objets de recommandation et leurs propriétés.
Obtenir Action d'amélioration Lire les propriétés et les relations d’un objet de recommandation .
Reporter Action d'amélioration Marquez l’état d’un objet de recommandation par postponed rapport à une date et une heure spécifiées.
Dismiss Action d'amélioration Marquez l’état d’un objet de recommandation comme dismissed.
Complete Action d'amélioration Marquez l’état d’un objet de recommandation comme completedByUser.
Réactiver Action d'amélioration Marquez l’état d’un objet de recommandation comme active.
Obtenir le degré de sécurisation du locataire collection tenantSecureScore Obtenez des données historiques de niveau de sécurité pour votre locataire.

Propriétés

Propriété Type Description
actionSteps collection actionStep Liste des actions à entreprendre pour terminer une recommandation. Hérité de recommendationBase.
Avantages Chaîne Une explication de la raison pour laquelle la réalisation de la recommandation vous sera bénéfique. Correspond à la section Valeur d’une recommandation affichée dans le Centre d’administration Microsoft Entra. Hérité de recommendationBase.
category recommendationCategory Indique la catégorie d’aide intelligente sous laquelle se trouve la recommandation. Les valeurs possibles sont identityBestPractice, identitySecureScore, unknownFutureValue. Hérité de recommendationBase.

Prend en charge $filter(eq).
createdDateTime DateTimeOffset Date et heure auxquelles la recommandation a été détectée comme applicable à votre annuaire. Hérité de recommendationBase.
currentScore Double Nombre de points atteints par le locataire. S’applique uniquement aux recommandations avec la catégorie définie sur identitySecureScore. Hérité de recommendationBase.
displayName Chaîne Titre de la recommandation. Hérité de recommendationBase.
featureAreas collection recommendationFeatureAreas Fonctionnalité d’annuaire à laquelle la recommandation est liée. Hérité de recommendationBase.

Prend en charge $filter(eq).
id Chaîne Identificateur unique de l’objet de recommandation généré pour votre locataire. Il s’agit d’une concaténation de votre ID de locataire et d’un surnom attribué par l’ID Microsoft Entra pour la recommandation. Par exemple : 7918d4b5-0442-4a97-be2d-36f9f9962ece_Microsoft.Identity.IAM.Insights.ThirdPartyApps. Hérité de recommendationBase.
impactStartDateTime DateTimeOffset Date et heure futures auxquelles une recommandation doit être effectuée. Hérité de recommendationBase.
impactType Chaîne Indique l’étendue de l’impact d’une recommandation. Tenant level indique que la recommandation a un impact sur l’ensemble du locataire. Les autres valeurs possibles sont users, applications. Hérité de recommendationBase.
Connaissances Chaîne Décrit pourquoi une recommandation s’applique de manière unique à votre annuaire. Correspond à la section Description d’une recommandation affichée dans le Centre d’administration Microsoft Entra. Hérité de recommendationBase.
lastCheckedDateTime DateTimeOffset Date et heure les plus récentes auxquelles une recommandation a été jugée applicable à votre annuaire. Hérité de recommendationBase.
lastModifiedBy Chaîne Nom de l’utilisateur qui a mis à jour l’état de la recommandation pour la dernière fois. Hérité de recommendationBase.
lastModifiedDateTime DateTimeOffset Date et heure de la dernière mise à jour de l’état d’une recommandation . Hérité de recommendationBase.
maxScore Double Nombre maximal de points pouvant être atteints. S’applique uniquement aux recommandations avec la catégorie définie sur identitySecureScore. Hérité de recommendationBase.
postponeUntilDateTime DateTimeOffset Date et heure futures auxquelles l’état d’une recommandation différée sera active à nouveau. Hérité de recommendationBase.
priorité recommendationPriority Indique la sensibilité temporelle pour qu’une recommandation soit exécutée. Microsoft attribue automatiquement cette valeur. Les valeurs possibles sont low, medium, high. Hérité de recommendationBase. En lecture seule.

Prend en charge $filter(eq).
recommendationType recommendationType Nom court convivial pour identifier la recommandation. Les valeurs possibles sont : adfsAppsMigration, enableDesktopSSO, enablePHS, enableProvisioningverifyAppPublisheraadGraphDeprecationServicePrincipaluserRiskPolicyadalToMsalMigrationaadGraphDeprecationApplicationinactiveGuestsownerlessAppslongLivedCredentialsaadConnectDeprecatedunknownFutureValuemanagedIdentityoverprivilegedAppsappRoleAssignmentsUsersprivateLinkForAADappRoleAssignmentsGroupssigninRiskPolicyroleOverlapselfServicePasswordResetoneAdminpwagePolicyNewpasswordHashSyncmfaRegistrationV2integratedAppsblockLegacyAuthenticationadminMFAV2servicePrincipalKeyExpiryswitchFromPerUserMFAapplicationCredentialExpirystaleAppCredstenantMFAuseMyAppsthirdPartyAppsturnOffPerUserMFAuseAuthenticatorAppstaleApps. mfaServerDeprecation Notez que vous devez utiliser l’en-tête Prefer: include-unknown-enum-members de requête pour obtenir la ou les valeurs suivantes dans cette énumération évolutive : longLivedCredentials , aadConnectDeprecated , adalToMsalMigrationownerlessApps , inactiveGuests , aadGraphDeprecationApplication , , , aadGraphDeprecationServicePrincipal , mfaServerDeprecation. Hérité de recommendationBase.

Actuellement, seul un nombre limité est disponible. Pour plus d’informations, consultez Types de recommandations. Prend en charge $filter(eq).
releaseType releaseType Type de publication actuel de la recommandation. Les valeurs possibles sont preview, generallyAvailable, unknownFutureValue. Hérité de recommendationBase.
remediationImpact Chaîne Description de l’impact sur les utilisateurs de la correction. S’applique uniquement aux recommandations avec la catégorie définie sur identitySecureScore. Hérité de recommendationBase.
status recommendationStatus Indique l’état de la recommandation en fonction de l’action de l’utilisateur ou du système. Les valeurs possibles sont active, completedBySystem, completedByUser, dismissed, postponed, unknownFutureValue. Par défaut, l’état d’une recommandation est défini sur active lors de la première génération de la recommandation. L’état est défini sur completedBySystem lorsque notre service détecte qu’une recommandation précédemment active ne s’applique plus. Hérité de recommendationBase.

Prend en charge $filter(eq).

Relations

Relation Type Description
impactedResources collection impactedResource Liste des objets d’annuaire associés à la recommandation. Hérité de recommendationBase.

Représentation JSON

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

{
  "@odata.type": "#microsoft.graph.recommendation",
  "id": "String (identifier)",
  "actionSteps": [
    {
      "@odata.type": "microsoft.graph.actionStep"
    }
  ],
  "benefits": "String",
  "category": "String",
  "createdDateTime": "String (timestamp)",
  "currentScore": "Double",
  "displayName": "String",
  "featureAreas": [
    "String"
  ],
  "impactType": "String",
  "impactStartDateTime": "String (timestamp)",
  "insights": "String",
  "lastCheckedDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "lastModifiedBy": "String",
  "maxScore": "Double",
  "postponeUntilDateTime": "String (timestamp)",
  "priority": "String",
  "status": "String",
  "remediationImpact": "String",
  "recommendationType": "String"
}