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 String 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 indiqué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, mdiSecureScore. Utilisez l’en-tête Prefer: include-unknown-enum-members de requête pour obtenir les valeurs suivantes de cette énumération évolutive : mdiSecureScore.
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 String Titre de la recommandation.
featureAreas collection recommendationFeatureAreas Fonctionnalité d’annuaire à laquelle la recommandation est liée.
id String 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 String Indique l’étendue de l’impact d’une recommandation. tenantLevel indique que la recommandation a un impact sur l’ensemble du locataire. Les autres valeurs possibles sont users, apps.
Connaissances String 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 String 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 Utilisez l’en-tête Prefer: include-unknown-enum-members de requête pour obtenir les membres suivants dans cette énumération évolutive : longLivedCredentials , aadConnectDeprecated , adalToMsalMigrationownerlessApps , , inactiveGuests , aadGraphDeprecationApplication , aadGraphDeprecationServicePrincipalmfaServerDeprecation.
releaseType releaseType Type de publication actuel de la recommandation. Les valeurs possibles sont preview, generallyAvailable, unknownFutureValue.
remediationImpact String 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, , . aatp Utilisez l’en-tête Prefer: include-unknown-enum-members de requête pour obtenir les valeurs suivantes de cette énumération évolutive : aatp.
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, riskAccepted, thirdParty, planned, alternateMitigation. Utilisez l’en-tête Prefer: include-unknown-enum-members de requête pour obtenir les valeurs suivantes à partir de cette énumération évolutive : riskAccepted , thirdParty , planned , alternateMitigation. 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"
}
  • Last updated on