type de ressource de recommandation

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 Microsoft Entra ID meilleure pratique ou action d’amélioration recommandée par Microsoft pour votre locataire Microsoft Entra.

Le service de recommandation Microsoft Entra s’exécute quotidiennement pour case activée votre locataire à des 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 status est défini sur actif.

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

Hérite de recommendationBase.

Méthodes

Méthode	Type de retour	Description
Lister les recommandations	collection de recommandations	Obtenez la liste des objets de recommandation et leurs propriétés.
Obtenir la recommandation	Action d'amélioration	Lire les propriétés et les relations d’un objet de recommandation .
Reporter	Action d'amélioration	Marquez le status d’un objet de recommandation comme postponed à une date et une heure spécifiées.
Dismiss	Action d'amélioration	Marquez le status d’un objet de recommandation comme dismissed.
Complete	Action d'amélioration	Marquez le status d’un objet de recommandation comme completedByUser.
Réactiver	Action d'amélioration	Marquez le status d’un objet de recommandation comme active.
Obtenir tenantSecureScores	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é Microsoft Entra ID 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 la dernière status de la recommandation. Hérité de recommendationBase.
lastModifiedDateTime	DateTimeOffset	Date et heure de la dernière mise à jour du status 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 la status 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 également 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, adalToMsalMigration, ownerlessApps, inactiveGuests. Hérité de recommendationBase. Actuellement, seuls huit types sont disponibles. 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 la status 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, la status d’une recommandation est définie 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"
}