recommendationBase 资源类型
命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
公开 建议 资源类型的属性的抽象类型。
方法
无。
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| actionSteps | actionStep 集合 | 完成 建议要执行的操作列表。 |
| 好处 | String | 解释为什么 完成建议 会让你受益。 对应于Microsoft Entra 管理中心中显示的建议 的“值 ”部分。 |
| “类别” | recommendationCategory | 指示建议所属的智能指南类别。 可能的值包括 identityBestPractice、identitySecureScore、unknownFutureValue。 |
| createdDateTime | DateTimeOffset | 检测到 建议 适用于目录的日期和时间。 |
| currentScore | 双精度 | 租户获得的积分数。 仅适用于类别设置为 identitySecureScore的建议。 |
| displayName | String | 建议的标题。 |
| featureAreas | recommendationFeatureAreas 集合 | 与建议相关的目录功能。 |
| id | String | 为租户生成的 建议 对象的唯一标识符。 这是租户 ID 和建议Microsoft Entra ID 分配的昵称串联。 例如，7918d4b5-0442-4a97-be2d-36f9f9962ece_Microsoft.Identity.IAM.Insights.ThirdPartyApps |
| impactStartDateTime | DateTimeOffset | 应完成 建议 的未来日期和时间。 |
| impactType | String | 指示建议的影响范围。
Tenant level 指示建议会影响整个租户。 其他可能的值包括 users、 applications。 |
| insights | String | 描述为什么建议唯一适用于目录。 对应于Microsoft Entra 管理中心中显示的建议 的“说明 ”部分。 |
| lastCheckedDateTime | DateTimeOffset | 建议被视为适用于目录的最近日期和时间。 |
| lastModifiedBy | String | 上次更新建议状态的用户的名称。 |
| lastModifiedDateTime | DateTimeOffset | 上次更新建议状态的日期和时间。 |
| maxScore | 双精度 | 可获取的最大积分数。 仅适用于类别设置为 identitySecureScore的建议。 |
| postponeUntilDateTime | DateTimeOffset | 将再次显示推迟的建议active状态的未来日期和时间。 |
| priority | recommendationPriority | 指示完成 建议 的时间敏感度。 Microsoft自动分配此值。 可能的值包括 low、medium、high。 |
| recommendationType | recommendationType | 用于标识 建议的友好短名称。 可能的值包括：adfsAppsMigration、、enablePHSswitchFromPerUserMFAthirdPartyAppsenableProvisioningtenantMFAenableDesktopSSOuseAuthenticatorAppturnOffPerUserMFA、selfServicePasswordResetsigninRiskPolicyuserRiskPolicyroleOverlapverifyAppPublisherprivateLinkForAADpasswordHashSyncadalToMsalMigrationpwagePolicyNewaadConnectDeprecatedunknownFutureValueoverprivilegedAppsmanagedIdentityappRoleAssignmentsUsersuseMyAppsstaleAppCredsblockLegacyAuthenticationstaleAppsservicePrincipalKeyExpiryintegratedAppsappRoleAssignmentsGroupslongLivedCredentialsoneAdminmfaRegistrationV2applicationCredentialExpiryadminMFAV2、ownerlessApps、 。 inactiveGuestsaadGraphDeprecationApplicationaadGraphDeprecationServicePrincipalmfaServerDeprecation 请注意，必须使用Prefer: include-unknown-enum-members请求标头来获取以下值 (在此可演变枚举中的) ： longLivedCredentials 、、 aadConnectDeprecated 、 adalToMsalMigration 、 ownerlessAppsinactiveGuests 、 aadGraphDeprecationApplication 、 aadGraphDeprecationServicePrincipal 、 。 mfaServerDeprecation |
| releaseType | releaseType | 建议的当前发布类型。 可能的值包括 preview、generallyAvailable、unknownFutureValue。 |
| remediationImpact | String | 描述修正对用户的影响。 仅适用于类别设置为 identitySecureScore的建议。 |
| requiredLicenses | requiredLicenses | 查看建议所需的许可证。 可取值包括：notApplicable、microsoftEntraIdFree、microsoftEntraIdP1、microsoftEntraIdP2、microsoftEntraIdGovernance、microsoftEntraWorkloadId、unknownFutureValue。 |
| status | recommendationStatus | 根据用户或系统操作指示 建议 的状态。 可能的值包括 active、completedBySystem、completedByUser、dismissed、postponed、unknownFutureValue。 默认情况下，首次生成建议时，建议 的状态 设置为 active 。 当我们的服务检测到以前处于活动状态的建议不再适用时，状态设置为 completedBySystem 。 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| impactedResources | impactedResource 集合 | 与 建议关联的目录对象列表。 |
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"@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"
}