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.

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

Métodos

Ninguno.

Propiedades

Propiedad Tipo Descripción
actionSteps actionStep (colección) Lista de acciones que se van a realizar para completar una recomendación.
Ventajas 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 Microsoft Entra.
categoría recommendationCategory Indica la categoría de guía inteligente en la que se encuentra la recomendación. Los valores posibles son: identityBestPractice, identitySecureScore, unknownFutureValue.
createdDateTime DateTimeOffset Fecha y hora en que se detectó la recomendación como aplicable al directorio.
currentScore Doble Número de puntos que ha alcanzado el inquilino. Solo se aplica a las recomendaciones con la categoría establecida en identitySecureScore.
displayName Cadena Título de la recomendación.
featureAreas recommendationFeatureAreas (colección) Característica de directorio con la que está relacionada la recomendación .
id Cadena Identificador único del objeto de recomendación generado para el inquilino. Se trata de una concatenación del identificador de inquilino y un alias asignado Microsoft Entra ID para la recomendación. Por ejemplo: 7918d4b5-0442-4a97-be2d-36f9f9962ece_Microsoft.Identity.IAM.Insights.ThirdPartyApps
impactStartDateTime DateTimeOffset Fecha y hora futuras en que se debe completar una recomendación .
impactType Cadena Indica el ámbito de impacto de una recomendación. Tenant level indica que la recomendación afecta a todo el inquilino. Otros valores posibles son users, applications.
insights Cadena Describe por qué una recomendación se aplica de forma única al directorio. Corresponde a la sección Descripción de una recomendación que se muestra en el Centro de administración Microsoft Entra.
lastCheckedDateTime DateTimeOffset La fecha y hora más recientes en que se consideró que una recomendación se aplicaba a su directorio.
lastModifiedBy Cadena Nombre del usuario que actualizó por última vez el estado de la recomendación.
lastModifiedDateTime DateTimeOffset Fecha y hora en que se actualizó por última vez el estado de una recomendación .
maxScore Doble Número máximo de puntos alcanzables. Solo se aplica a las recomendaciones con la categoría establecida en identitySecureScore.
postponeUntilDateTime DateTimeOffset Fecha y hora futuras en que el estado de una recomendación pospó será active de nuevo.
priority recommendationPriority Indica la confidencialidad de tiempo para que se complete una recomendación . Microsoft asigna automáticamente este valor. Los valores posibles son: low, medium, high.
recommendationType recommendationType Nombre corto descriptivo para identificar la recomendación. Los valores posibles son: adfsAppsMigration, enableDesktopSSO, , enablePHS, enableProvisioning, tenantMFAswitchFromPerUserMFA, thirdPartyApps, turnOffPerUserMFA, useAuthenticatorApp, , staleAppsuseMyApps, staleAppCredsmfaServerDeprecationaadGraphDeprecationServicePrincipalintegratedAppsaadGraphDeprecationApplicationblockLegacyAuthenticationinactiveGuestsmfaRegistrationV2adminMFAV2managedIdentitypwagePolicyNewoverprivilegedAppspasswordHashSyncunknownFutureValueadalToMsalMigrationappRoleAssignmentsUsersownerlessAppsaadConnectDeprecatedlongLivedCredentialsappRoleAssignmentsGroupsprivateLinkForAADverifyAppPublisheruserRiskPolicyselfServicePasswordResetoneAdminsigninRiskPolicyapplicationCredentialExpiryservicePrincipalKeyExpiryroleOverlap. Además, tenga en cuenta que debe usar el Prefer: include-unknown-enum-members encabezado de solicitud para obtener los siguientes valores en esta enumeración evolvable: longLivedCredentials, aadConnectDeprecated, adalToMsalMigration, , ownerlessApps, inactiveGuests.
releaseType releaseType El tipo de versión actual de la recomendación. Los valores posibles son: preview, generallyAvailable, unknownFutureValue.
remediationImpact Cadena Descripción del impacto en los usuarios de la corrección. 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, microsoftEntraIdP2, microsoftEntraIdGovernance, microsoftEntraWorkloadId y unknownFutureValue.
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, dismissed, postponed, unknownFutureValue. De forma predeterminada, el estado de una recomendación se establece en active la primera vez que se genera la recomendación. El estado se establece completedBySystem en cuando nuestro servicio detecta que ya no se aplica una recomendación que estaba activa anteriormente.

Relaciones

Relación Tipo Descripción
impactedResources colección impactedResource Lista de objetos de directorio asociados a la recomendación.

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