Поделиться через


Тип ресурса recommendationBase

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Абстрактный тип, предоставляющий свойства для типа ресурса рекомендации .

Методы

Нет.

Свойства

Свойство Тип Описание
actionSteps коллекция actionStep Список действий, выполняемых для выполнения рекомендации.
Преимущества String Объяснение того, почему выполнение рекомендации принесет вам пользу. Соответствует разделу Значение рекомендации, показанной в Центре администрирования Microsoft Entra.
category recommendationCategory Указывает категорию интеллектуального руководства, к которому относится рекомендация. Допустимые значения: identityBestPractice, identitySecureScore, unknownFutureValue.
createdDateTime DateTimeOffset Дата и время обнаружения рекомендации в соответствии с вашим каталогом.
currentScore Двойное с плавающей точкой Количество баллов, достигнутое клиентом. Применяется только к рекомендациям с категорией , для нее задано значение identitySecureScore.
displayName String Заголовок рекомендации.
featureAreas коллекция recommendationFeatureAreas Компонент каталога, с которым связана рекомендация .
id String Уникальный идентификатор объекта рекомендации , созданного для клиента. Это объединение идентификатора клиента и псевдонима, присвоенного идентификатором Microsoft Entra для рекомендации. Пример: 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 Указывает чувствительность времени для выполнения рекомендации . Корпорация Майкрософт автоматически присваивает это значение. Допустимые значения: low, medium, high.
recommendationType recommendationType Понятное короткое имя для определения рекомендации. Возможные значения: adfsAppsMigration, , enableDesktopSSOenablePHS, , enableProvisioning, switchFromPerUserMFAtenantMFA, , thirdPartyAppsappRoleAssignmentsUsersoverprivilegedAppspwagePolicyNewappRoleAssignmentsGroupsintegratedAppsmanagedIdentitysigninRiskPolicyadminMFAV2servicePrincipalKeyExpiryapplicationCredentialExpiryroleOverlapmfaRegistrationV2staleAppCredsblockLegacyAuthenticationpasswordHashSyncverifyAppPublisherprivateLinkForAADuserRiskPolicyselfServicePasswordResetoneAdminstaleAppsuseMyAppsuseAuthenticatorAppturnOffPerUserMFA, unknownFutureValue, longLivedCredentials, , . aadConnectDeprecatedadalToMsalMigrationownerlessAppsinactiveGuestsaadGraphDeprecationApplicationaadGraphDeprecationServicePrincipalmfaServerDeprecation Обратите внимание, что необходимо использовать Prefer: include-unknown-enum-members заголовок запроса для получения следующих значений в этом развиваемом перечислении: longLivedCredentials , aadConnectDeprecated , adalToMsalMigration , ownerlessApps , inactiveGuests , 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"
}