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 |
|---|---|---|
| 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 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 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 | 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. 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 | String | 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 | 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. Hérité de recommendationBase. |
| impactStartDateTime | DateTimeOffset | Date et heure futures auxquelles une recommandation doit être effectuée. Hérité de recommendationBase. |
| impactType | String | 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 | 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. 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 | String | 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 Utilisez 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 , aadGraphDeprecationServicePrincipalaadGraphDeprecationApplicationmfaServerDeprecation. 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 | String | 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"
}