tipo de recurso recommendation

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.

Representa una Microsoft Entra ID acción recomendada o de mejora recomendada por Microsoft para el inquilino de Microsoft Entra.

El servicio de recomendación de Microsoft Entra se ejecuta diariamente para comprobar si el inquilino tiene condiciones predefinidas para cada recomendación. Si el servicio detecta que se aplica una recomendación al inquilino, se genera el objeto de recomendación correspondiente y su estado se establece en activo.

Para obtener más información, consulte ¿Qué es Microsoft Entra recomendaciones?.

Hereda de recommendationBase.

Métodos

Método	Tipo devuelto	Descripción
Enumerar recomendaciones	colección de recomendaciones	Obtenga una lista de los objetos de recomendación y sus propiedades.
Obtener recomendación	recommendation	Lea las propiedades y relaciones de un objeto de recomendación .
Posponer	recommendation	Marque el estado de un objeto de recomendación en función postponed de una fecha y hora especificadas.
Dismiss	recommendation	Marque el estado de un objeto de recomendación como dismissed.
Complete	recommendation	Marque el estado de un objeto de recomendación como completedByUser.
Reactivar	recommendation	Marque el estado de un objeto de recomendación como active.
Obtener tenantSecureScores	colección tenantSecureScore	Obtenga los datos históricos de Puntuación de seguridad para el inquilino.

Propiedades

Propiedad	Tipo	Descripción
actionSteps	actionStep (colección)	Lista de acciones que se van a realizar para completar una recomendación. Se hereda de recommendationBase.
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. Se hereda de recommendationBase.
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. Se hereda de recommendationBase. Admite $filter(eq).
createdDateTime	DateTimeOffset	Fecha y hora en que se detectó la recomendación como aplicable al directorio. Se hereda de recommendationBase.
currentScore	Doble	Número de puntos que ha alcanzado el inquilino. Solo se aplica a las recomendaciones con la categoría establecida en identitySecureScore. Se hereda de recommendationBase.
displayName	Cadena	Título de la recomendación. Se hereda de recommendationBase.
featureAreas	recommendationFeatureAreas (colección)	Característica de directorio con la que está relacionada la recomendación . Se hereda de recommendationBase. Admite $filter(eq).
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. Se hereda de recommendationBase.
impactStartDateTime	DateTimeOffset	Fecha y hora futuras en que se debe completar una recomendación . Se hereda de recommendationBase.
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. Se hereda de recommendationBase.
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. Se hereda de recommendationBase.
lastCheckedDateTime	DateTimeOffset	La fecha y hora más recientes en que se consideró que una recomendación se aplicaba a su directorio. Se hereda de recommendationBase.
lastModifiedBy	Cadena	Nombre del usuario que actualizó por última vez el estado de la recomendación. Se hereda de recommendationBase.
lastModifiedDateTime	DateTimeOffset	Fecha y hora en que se actualizó por última vez el estado de una recomendación . Se hereda de recommendationBase.
maxScore	Doble	Número máximo de puntos alcanzables. Solo se aplica a las recomendaciones con la categoría establecida en identitySecureScore. Se hereda de recommendationBase.
postponeUntilDateTime	DateTimeOffset	Fecha y hora futuras en que el estado de una recomendación pospó será active de nuevo. Se hereda de recommendationBase.
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. Se hereda de recommendationBase. Solo lectura. Admite $filter(eq).
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. Se hereda de recommendationBase. Actualmente, solo hay ocho tipos disponibles. Para obtener más información, vea Tipos de recomendaciones. Admite $filter(eq).
releaseType	releaseType	El tipo de versión actual de la recomendación. Los valores posibles son: preview, generallyAvailable, unknownFutureValue. Se hereda de recommendationBase.
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. Se hereda de recommendationBase.
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. Se hereda de recommendationBase. Admite $filter(eq).

Relaciones

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

Representación JSON

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

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