Partager via


Type de ressource recommendationBase

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 .

Type abstrait qui expose les propriétés du type de ressource de recommandation .

Méthodes

Aucun.

Propriétés

Propriété Type Description
actionSteps collection actionStep Liste des actions à entreprendre pour terminer une recommandation.
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.
category recommendationCategory Indique la catégorie d’aide intelligente sous laquelle se trouve la recommandation. Les valeurs possibles sont identityBestPractice, identitySecureScore, unknownFutureValue.
createdDateTime DateTimeOffset Date et heure auxquelles la recommandation a été détectée comme applicable à votre annuaire.
currentScore Double Nombre de points atteints par le locataire. S’applique uniquement aux recommandations avec la catégorie définie sur identitySecureScore.
displayName Chaîne Titre de la recommandation.
featureAreas collection recommendationFeatureAreas Fonctionnalité d’annuaire à laquelle la recommandation est liée.
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
impactStartDateTime DateTimeOffset Date et heure futures auxquelles une recommandation doit être effectuée.
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.
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.
lastCheckedDateTime DateTimeOffset Date et heure les plus récentes auxquelles une recommandation a été jugée applicable à votre annuaire.
lastModifiedBy Chaîne Nom de l’utilisateur qui a mis à jour la dernière status de la recommandation.
lastModifiedDateTime DateTimeOffset Date et heure de la dernière mise à jour du status d’une recommandation.
maxScore Double Nombre maximal de points pouvant être atteints. S’applique uniquement aux recommandations avec la catégorie définie sur identitySecureScore.
postponeUntilDateTime DateTimeOffset Date et heure futures auxquelles la status d’une recommandation différée sera active à nouveau.
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.
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.
releaseType releaseType Type de publication actuel de la recommandation. Les valeurs possibles sont preview, generallyAvailable, unknownFutureValue.
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.
requiredLicenses requiredLicenses Licences requises pour afficher la recommandation. Les valeurs possibles sont notApplicable, microsoftEntraIdFree, microsoftEntraIdP1, microsoftEntraIdP2, microsoftEntraIdGovernance, microsoftEntraWorkloadId, unknownFutureValue.
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.

Relations

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

Représentation JSON

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

{
  "@odata.type": "#microsoft.graph.recommendationBase",
  "id": "String (identifier)",
  "actionSteps": [
    {
      "@odata.type": "microsoft.graph.actionStep"
    }
  ],
  "benefits": "String",
  "category": "String",
  "createdDateTime": "String (timestamp)",
  "currentScore": "Double",
  "displayName": "String",
  "featureAreas": [
    "String"
  ],
  "releaseType": "String",
  "requiredLicenses": "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"
}