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 | Description |
---|---|---|
actionSteps | actionStep (colección) | Lista de acciones que se van a 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 | 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 por el identificador de Microsoft Entra 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 de 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 , tenantMFA switchFromPerUserMFA , thirdPartyApps , turnOffPerUserMFA , useAuthenticatorApp , , staleApps useMyApps , staleAppCreds mfaServerDeprecation aadGraphDeprecationServicePrincipal integratedApps aadGraphDeprecationApplication blockLegacyAuthentication inactiveGuests mfaRegistrationV2 adminMFAV2 managedIdentity pwagePolicyNew overprivilegedApps passwordHashSync unknownFutureValue adalToMsalMigration appRoleAssignmentsUsers ownerlessApps aadConnectDeprecated longLivedCredentials appRoleAssignmentsGroups privateLinkForAAD verifyAppPublisher userRiskPolicy selfServicePasswordReset oneAdmin signinRiskPolicy applicationCredentialExpiry servicePrincipalKeyExpiry roleOverlap . 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 , aadGraphDeprecationApplication , , aadGraphDeprecationServicePrincipal mfaServerDeprecation . |
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 | Description |
---|---|---|
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"
}