建议资源类型

命名空间:microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。

表示 Microsoft 针对Microsoft Entra租户建议的Microsoft Entra ID最佳做法或改进操作。

Microsoft Entra建议服务每天运行,以针对每个建议的预定义条件检查租户。 如果服务检测到建议适用于租户,则会生成相应的建议对象,并将其状态设置为活动。

有关详细信息,请参阅什么是Microsoft Entra建议?

继承自 recommendationBase

方法

方法 返回类型 说明
列出建议 建议 集合 获取 建议 对象及其属性的列表。
获取建议 recommendation 读取 建议 对象的属性和关系。
推迟 recommendation 建议 对象的 postponed 状态标记为指定的日期和时间。
Dismiss recommendation 建议 对象的状态标记为 dismissed
Complete recommendation 建议 对象的状态标记为 completedByUser
重新激活 recommendation 建议 对象的状态标记为 active
获取 tenantSecureScores tenantSecureScore 集合 获取租户的历史安全功能分数数据。

属性

属性 类型 说明
actionSteps actionStep 集合 完成 建议要执行的操作列表。 继承自 recommendationBase
好处 String 解释为什么 完成建议 会让你受益。 对应于Microsoft Entra 管理中心中显示的建议的“值”部分。 继承自 recommendationBase
“类别” recommendationCategory 指示建议所属的智能指南类别。 可能的值包括 identityBestPracticeidentitySecureScoreunknownFutureValue。 继承自 recommendationBase

支持 $filter (eq) 。
createdDateTime DateTimeOffset 检测到 建议 适用于目录的日期和时间。 继承自 recommendationBase
currentScore 双精度 租户获得的积分数。 仅适用于类别设置为 identitySecureScore的建议。 继承自 recommendationBase
displayName String 建议的标题。 继承自 recommendationBase
featureAreas recommendationFeatureAreas 集合 与建议相关的目录功能。 继承自 recommendationBase

支持 $filter (eq) 。
id String 为租户生成的 建议 对象的唯一标识符。 这是租户 ID 和建议Microsoft Entra ID分配的昵称的串联。 例如,7918d4b5-0442-4a97-be2d-36f9f9962ece_Microsoft.Identity.IAM.Insights.ThirdPartyApps。 继承自 recommendationBase
impactStartDateTime DateTimeOffset 应完成 建议 的未来日期和时间。 继承自 recommendationBase
impactType String 指示建议的影响范围。 Tenant level 指示建议会影响整个租户。 其他可能的值包括 usersapplications。 继承自 recommendationBase
insights String 描述为什么建议唯一适用于目录。 对应于Microsoft Entra 管理中心中显示的建议的“说明”部分。 继承自 recommendationBase
lastCheckedDateTime DateTimeOffset 建议被视为适用于目录的最近日期和时间。 继承自 recommendationBase
lastModifiedBy String 上次更新建议状态的用户的名称。 继承自 recommendationBase
lastModifiedDateTime DateTimeOffset 上次更新建议状态的日期和时间。 继承自 recommendationBase
maxScore 双精度 可获取的最大积分数。 仅适用于类别设置为 identitySecureScore的建议。 继承自 recommendationBase
postponeUntilDateTime DateTimeOffset 将再次显示推迟的建议active状态的未来日期和时间。 继承自 recommendationBase
priority recommendationPriority 指示完成 建议 的时间敏感度。 Microsoft 自动分配此值。 可能的值包括 lowmediumhigh。 继承自 recommendationBase。 此为只读属性。

支持 $filter (eq) 。
recommendationType recommendationType 用于标识 建议的友好短名称。 可能的值包括:adfsAppsMigration、、enablePHSswitchFromPerUserMFAthirdPartyAppsenableProvisioningtenantMFAenableDesktopSSOuseAuthenticatorAppturnOffPerUserMFAselfServicePasswordResetsigninRiskPolicyuserRiskPolicyroleOverlapverifyAppPublisherprivateLinkForAADpasswordHashSyncadalToMsalMigrationpwagePolicyNewaadConnectDeprecatedunknownFutureValueoverprivilegedAppsmanagedIdentityappRoleAssignmentsUsersuseMyAppsstaleAppCredsblockLegacyAuthenticationstaleAppsservicePrincipalKeyExpiryintegratedAppsappRoleAssignmentsGroupslongLivedCredentialsoneAdminmfaRegistrationV2applicationCredentialExpiryadminMFAV2ownerlessApps、 。 inactiveGuestsaadGraphDeprecationApplicationaadGraphDeprecationServicePrincipalmfaServerDeprecation 此外,请注意,必须使用Prefer: include-unknown-enum-members请求标头来获取以下值 (在此可演变枚举中的) :longLivedCredentials、、aadConnectDeprecatedadalToMsalMigrationownerlessAppsinactiveGuests。 继承自 recommendationBase

目前,只有八种类型可用。 有关详细信息,请参阅 建议的类型。 支持 $filter (eq) 。
releaseType releaseType 建议的当前发布类型。 可能的值包括 previewgenerallyAvailableunknownFutureValue。 继承自 recommendationBase
remediationImpact String 描述修正对用户的影响。 仅适用于类别设置为 identitySecureScore的建议。 继承自 recommendationBase
status recommendationStatus 根据用户或系统操作指示 建议 的状态。 可能的值包括 activecompletedBySystemcompletedByUserdismissedpostponedunknownFutureValue。 默认情况下,首次生成建议时,建议 的状态 设置为 active 。 当我们的服务检测到以前处于活动状态的建议不再适用时,状态设置为 completedBySystem 。 继承自 recommendationBase

支持 $filter (eq) 。

关系

关系 类型 说明
impactedResources impactedResource 集合 建议关联的目录对象列表。 继承自 recommendationBase

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

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