tipo de recurso recommendationBase

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Un tipo abstracto que expone las propiedades del tipo de recurso de recomendación .

Métodos

Ninguno.

Propiedades

Propiedad Tipo Description
actionSteps Recopilación de pasos de acción Lista de acciones que se deben realizar para completar una recomendación.
Beneficios Cadena Una explicación de por qué completar la recomendación le beneficiará. Corresponde a la sección Valor de una recomendación que se muestra en el Centro de administración de Microsoft Entra.
categoría categoría de recomendación Indica la categoría de instrucciones inteligentes en la que se encuentra la recomendación. Los valores posibles son: identityBestPractice, identitySecureScore, unknownFutureValue y mdiSecureScore Use el encabezado de Prefer: include-unknown-enum-members solicitud para obtener los siguientes valores de esta enumeración evolutiva: mdiSecureScore.
categoryGroup recommendationCategoryGroup El grupo de taxonomía empresarial al que pertenece la recomendación se usa para organizar las recomendaciones en el Centro de administración de Microsoft Entra. Los valores posibles son: strengthenAuthentication, detectAndRespondToThreats, enforceLeastPrivilege, governAppsCredentialsAndAgents, hardenInfrastructure, defenderForIdentity y unknownFutureValue. Solo lectura. Admite $filter (eq).
completedBySystemDateTime DateTimeOffset La fecha y hora en que el servicio de recomendaciones comprobó que la recomendación se había corregido por completo y estableció su estado en completedBySystem. Es null si el sistema no ha completado la recomendación. Admite $filter.
completedByUserDateTime DateTimeOffset La fecha y hora en que la recomendación se marcó como completada por el usuario para el ciclo de revisión actual, incluido cuando el valor se actualiza de todos los recursos afectados marcados como completados por el usuario. Es null si un usuario no ha completado la recomendación en el ciclo actual. Admite $filter.
createdDateTime DateTimeOffset La fecha y hora en que se detectó la recomendación como aplicable a su directorio.
puntuación actual Doble El número de puntos que ha obtenido el inquilino. Solo se aplica a las recomendaciones con la categoría establecida en identitySecureScore.
displayName Cadena El título de la recomendación.
failedReviewDateTime DateTimeOffset La fecha y hora en que el servicio de recomendaciones comprobó por última vez que uno o más recursos afectados que el usuario marcó como completados siguen afectados, moviéndolos a needsMoreAction. Se borra cuando se corrigen los recursos revisados, por lo que es mutuamente excluyente con remediatedDateTime. Es null cuando ningún recurso revisado por el usuario está fallando actualmente en la comprobación. Admite $filter.
featureAreas colección recommendationFeatureAreas La característica de directorio con la que está relacionada la recomendación .
id Cadena El identificador único del objeto de recomendación generado para el inquilino. Se trata de una concatenación de su id. de inquilino y un apodo asignado por el id. de Microsoft Entra ID para la recomendación. Por ejemplo: 7918d4b5-0442-4a97-be2d-36f9f9962ece_Microsoft.Identity.IAM.Insights.ThirdPartyApps
impactStartDateTime DateTimeOffset La fecha y hora futuras en que se debe completar una recomendación .
impactType Cadena Indica el alcance del impacto de una recomendación. tenantLevel Indica que la recomendación afecta a todo el inquilino. Otros valores posibles incluyen users, apps.
insights Cadena Describe por qué una recomendación se aplica de forma exclusiva a su directorio. Corresponde a la sección Descripción de una recomendación que se muestra en el Centro de administración de Microsoft Entra.
lastCheckedDateTime DateTimeOffset La fecha y hora más recientes en que una recomendación se consideró aplicable a su directorio.
lastModifiedBy Cadena Nombre del usuario que actualizó por última vez el estado de la recomendación.
lastModifiedDateTime DateTimeOffset La fecha y hora en que se actualizó por última vez el estado de una recomendación .
puntuación máxima Doble El número máximo de puntos que se pueden obtener. Solo se aplica a las recomendaciones con la categoría establecida en identitySecureScore.
needsMoreActionResourceCount Int32 El número de recursos afectados que el usuario marcó como completados y que el servicio de recomendaciones verificó posteriormente siguen afectados (movidos a needsMoreAction). Este valor es mayor que cero exactamente cuando se establece failedReviewDateTime . Es null cuando la recomendación no participa en el ciclo de vida de la revisión.
nistClasificaciones Colección nistClassification Las categorías del Marco de ciberseguridad del NIST (CSF) 2.0 a las que se asigna la recomendación . Solo lectura.
postponeUntilDateTime DateTimeOffset La fecha y hora futuras en que volverá a existir active el estado de una recomendación aplazada.
priority recommendationPriority Indica el tiempo necesario para que se complete una recomendación . Microsoft asigna automáticamente este valor. Los valores posibles son: low, medium, high, critical, unknownFutureValue.
recommendationType recommendationType Nombre corto descriptivo para identificar la recomendación. Los valores posibles son: adfsAppsMigration, enableDesktopSSO, enablePHSenableProvisioningswitchFromPerUserMFAtenantMFAthirdPartyAppsturnOffPerUserMFAuseAuthenticatorAppuseMyAppsstaleAppsstaleAppCredsapplicationCredentialExpiryservicePrincipalKeyExpiryadminMFAV2blockLegacyAuthenticationintegratedAppsmfaRegistrationV2pwagePolicyNewpasswordHashSynconeAdminroleOverlapselfServicePasswordResetsigninRiskPolicyuserRiskPolicyverifyAppPublisherprivateLinkForAADappRoleAssignmentsGroupsappRoleAssignmentsUsersmanagedIdentityoverprivilegedAppsunknownFutureValuelongLivedCredentialsaadConnectDeprecatedadalToMsalMigrationownerlessAppsinactiveGuestsaadGraphDeprecationApplicationaadGraphDeprecationServicePrincipalmfaServerDeprecation Use el encabezado de solicitud Prefer: include-unknown-enum-members para obtener los siguientes miembros en esta enumeración evolutiva: longLivedCredentials , aadConnectDeprecated , adalToMsalMigration , ownerlessAppsaadGraphDeprecationServicePrincipalinactiveGuestsaadGraphDeprecationApplicationmfaServerDeprecation, .
releaseType releaseType El tipo de versión actual de la recomendación. Los valores posibles son: preview, generallyAvailable, unknownFutureValue.
remediatedDateTime DateTimeOffset La fecha y hora en que el servicio de recomendaciones verificó que los recursos afectados que el usuario marcó como completados se han corregido, es decir, que los recursos revisados por el usuario alcanzaron completedBySystem. Se reemplaza por failedReviewDateTime si un recurso revisado posteriormente no se comprueba. Es null si el sistema no ha verificado una corrección controlada por el usuario en el ciclo actual. Admite $filter.
remediationImpact Cadena Descripción del impacto de la corrección en los usuarios. Solo se aplica a las recomendaciones con la categoría establecida en identitySecureScore.
requiredLicenses requiredLicenses Las licencias necesarias para ver la recomendación. Los valores posibles son: notApplicable, microsoftEntraIdFree, microsoftEntraIdP1, microsoftEntraIdP2microsoftEntraIdGovernance, microsoftEntraWorkloadId, unknownFutureValue, aatp, , microsoftEntraSuite, . Use el encabezado de Prefer: include-unknown-enum-members solicitud para obtener los siguientes valores de esta enumeración evolutiva: aatp, microsoftEntraSuite.
status recommendationStatus Indica el estado de la recomendación en función de la acción del usuario o del sistema. Los valores posibles son: active, completedBySystem, completedByUser, dismissedriskAcceptedthirdPartyunknownFutureValuepostponed, , planned, alternateMitigationneedsMoreAction, . Use el encabezado de solicitud Prefer: include-unknown-enum-members para obtener los siguientes valores de esta enumeración evolutiva: riskAccepted , thirdParty , planned , alternateMitigation , , needsMoreAction. De forma predeterminada, el estado de una recomendación se establece en el active momento en que se genera por primera vez. El estado se establece en completedBySystem cuando nuestro servicio detecta que una recomendación que estaba activa anteriormente ya no se aplica.
statusModifiedDateTime DateTimeOffset La fecha y hora en que el estado de la recomendación cambió por última vez, por ejemplo, de active a completedByUser, dismissed, postponedo needsMoreAction. A diferencia de lastModifiedDateTime, este valor no se actualiza cuando solo cambian los datos de información de la recomendación mientras el estado permanece igual. es null hasta que el estado de la recomendación cambia por primera vez. Admite $filter.

Relaciones

Relación Tipo Description
ImpactedResources Colección de recursos impactedResource Lista de objetos de directorio asociados a la recomendación.
tags recommendationTag collection Etiquetas de forma libre definidas por el usuario aplicadas a la recomendación. La colección no es directamente grabable; Las etiquetas se crean y quitan a través de las acciones addTag y removeTag .

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

{
  "@odata.type": "#microsoft.graph.recommendationBase",
  "id": "String (identifier)",
  "actionSteps": [
    {
      "@odata.type": "microsoft.graph.actionStep"
    }
  ],
  "benefits": "String",
  "category": "String",
  "categoryGroup": "String",
  "completedBySystemDateTime": "String (timestamp)",
  "completedByUserDateTime": "String (timestamp)",
  "createdDateTime": "String (timestamp)",
  "currentScore": "Double",
  "displayName": "String",
  "failedReviewDateTime": "String (timestamp)",
  "featureAreas": [
    "String"
  ],
  "releaseType": "String",
  "requiredLicenses": "String",
  "impactType": "String",
  "impactStartDateTime": "String (timestamp)",
  "insights": "String",
  "lastCheckedDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "lastModifiedBy": "String",
  "maxScore": "Double",
  "needsMoreActionResourceCount": "Int32",
  "nistClassifications": [
    {
      "@odata.type": "microsoft.graph.nistClassification"
    }
  ],
  "postponeUntilDateTime": "String (timestamp)",
  "priority": "String",
  "remediatedDateTime": "String (timestamp)",
  "status": "String",
  "statusModifiedDateTime": "String (timestamp)",
  "remediationImpact": "String",
  "recommendationType": "String"
}
  • Last updated on