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 . |
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.
Tenant level indique que la recommandation a un impact sur l’ensemble du locataire. Les autres valeurs possibles sont users , applications . |
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 , enableProvisioning verifyAppPublisher aadGraphDeprecationServicePrincipal userRiskPolicy adalToMsalMigration aadGraphDeprecationApplication inactiveGuests ownerlessApps longLivedCredentials aadConnectDeprecated unknownFutureValue managedIdentity overprivilegedApps appRoleAssignmentsUsers privateLinkForAAD appRoleAssignmentsGroups signinRiskPolicy roleOverlap selfServicePasswordReset oneAdmin pwagePolicyNew passwordHashSync mfaRegistrationV2 integratedApps blockLegacyAuthentication adminMFAV2 servicePrincipalKeyExpiry switchFromPerUserMFA applicationCredentialExpiry staleAppCreds tenantMFA useMyApps thirdPartyApps turnOffPerUserMFA useAuthenticatorApp staleApps . 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 , aadGraphDeprecationServicePrincipal aadGraphDeprecationApplication mfaServerDeprecation . |
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 . |
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"
}