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、adalToMsalMigrationownerlessApps、inactiveGuests。
releaseType	releaseType	建议的当前发布类型。 可能的值包括 preview、generallyAvailable、unknownFutureValue。
remediationImpact	String	描述修正对用户的影响。 仅适用于类别设置为 identitySecureScore的建议。
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",
  "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"
}