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 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"
}