命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
表示Microsoft针对Microsoft Entra租户建议的Microsoft Entra ID最佳做法或改进作。
Microsoft Entra建议服务每天运行，以针对每个建议的预定义条件检查租户。 如果服务检测到建议适用于租户，则会生成相应的建议对象，并将其状态设置为活动。
有关详细信息，请参阅什么是Microsoft Entra建议？。
继承自 recommendationBase。
方法
| 方法 | 返回类型 | Description |
|---|---|---|
| List | 建议 集合 | 获取 建议 对象及其属性的列表。 |
| Get | recommendation | 读取 建议 对象的属性和关系。 |
| 推迟 | recommendation | 将 建议 对象的 postponed 状态标记为指定的日期和时间。 |
| Dismiss | recommendation | 将 建议 对象的状态标记为 dismissed。 |
| Complete | recommendation | 将 建议 对象的状态标记为 completedByUser。 |
| 重新激活 | recommendation | 将 建议 对象的状态标记为 active。 |
| 获取租户安全功能分数 | tenantSecureScore 集合 | 获取租户的历史安全功能分数数据。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| actionSteps | actionStep 集合 | 完成 建议要执行的作列表。 继承自 recommendationBase。 |
| 好处 | String | 解释为什么 完成建议 会让你受益。 对应于Microsoft Entra 管理中心中显示的建议的“值”部分。 继承自 recommendationBase。 |
| “类别” | recommendationCategory | 指示建议所属的智能指南类别。 可能的值包括 identityBestPractice、identitySecureScore、unknownFutureValue、mdiSecureScore。 使用 Prefer: include-unknown-enum-members 请求标头从此 可演变枚举中获取以下值： mdiSecureScore。 继承自 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 | 指示建议的影响范围。
tenantLevel 指示建议会影响整个租户。 其他可能的值包括 users、 apps。 继承自 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自动分配此值。 可能的值包括 low、medium、high。 继承自 recommendationBase。 只读。 支持 $filter (eq) 。 |
| recommendationType | recommendationType | 用于标识 建议的友好短名称。 可能的值包括：adfsAppsMigration、、enablePHSswitchFromPerUserMFAthirdPartyAppsenableProvisioningtenantMFAenableDesktopSSOuseAuthenticatorAppturnOffPerUserMFA、selfServicePasswordResetsigninRiskPolicyuserRiskPolicyroleOverlapverifyAppPublisherprivateLinkForAADpasswordHashSyncadalToMsalMigrationpwagePolicyNewaadConnectDeprecatedunknownFutureValueoverprivilegedAppsmanagedIdentityappRoleAssignmentsUsersuseMyAppsstaleAppCredsblockLegacyAuthenticationstaleAppsservicePrincipalKeyExpiryintegratedAppsappRoleAssignmentsGroupslongLivedCredentialsoneAdminmfaRegistrationV2applicationCredentialExpiryadminMFAV2、ownerlessApps、 。 inactiveGuestsaadGraphDeprecationApplicationaadGraphDeprecationServicePrincipalmfaServerDeprecation
Prefer: include-unknown-enum-members使用请求标头获取此可演变枚举中的以下成员： longLivedCredentials 、、 aadConnectDeprecated 、 adalToMsalMigration 、 ownerlessAppsinactiveGuests 、 aadGraphDeprecationApplication 、 aadGraphDeprecationServicePrincipal 、。 mfaServerDeprecation 继承自 recommendationBase。 目前，只有有限数量可用。 有关详细信息，请参阅 建议的类型。 支持 $filter (eq) 。 |
| releaseType | releaseType | 建议的当前发布类型。 可能的值包括 preview、generallyAvailable、unknownFutureValue。 继承自 recommendationBase。 |
| remediationImpact | String | 描述修正对用户的影响。 仅适用于类别设置为 identitySecureScore的建议。 继承自 recommendationBase。 |
| status | recommendationStatus | 根据用户或系统作指示 建议 的状态。 可取值包括：active、completedBySystem、completedByUser、dismissed、postponed、unknownFutureValue、riskAccepted、thirdParty、planned、alternateMitigation。
Prefer: include-unknown-enum-members使用请求标头从此可演变枚举中获取以下值： riskAccepted 、 thirdParty 、、 plannedalternateMitigation。 默认情况下，首次生成建议时，建议 的状态 设置为 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"
}