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


тип ресурса рекомендации

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

Важно!

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

Представляет рекомендацию или действие по улучшению идентификатора Microsoft Entra, рекомендуемое корпорацией Майкрософт для клиента Microsoft Entra.

Служба рекомендаций Microsoft Entra работает ежедневно, чтобы проверить клиент на соответствие предопределенным условиям для каждой рекомендации. Если служба обнаруживает, что рекомендация применяется к вашему клиенту, создается соответствующий объект рекомендации, а его состояние устанавливается в активное.

Дополнительные сведения см. в статье Рекомендации Microsoft Entra.

Наследует от recommendationBase.

Методы

Метод Тип возвращаемых данных Описание
Список коллекция рекомендаций Получение списка объектов рекомендаций и их свойств.
Получение recommendation Чтение свойств и связей объекта рекомендации .
Отложить recommendation Пометьте состояние объекта рекомендации как postponed указанные дату и время.
Dismiss recommendation Пометьте состояние объекта рекомендации как dismissed.
Завершение recommendation Пометьте состояние объекта рекомендации как completedByUser.
Повторная активация recommendation Пометьте состояние объекта рекомендации как active.
Получение оценки безопасности клиента коллекция tenantSecureScore Получение исторических данных оценки безопасности для клиента.

Свойства

Свойство Тип Описание
actionSteps коллекция actionStep Список действий, выполняемых для выполнения рекомендации. Наследуется от recommendationBase.
Преимущества String Объяснение того, почему выполнение рекомендации принесет вам пользу. Соответствует разделу Значение рекомендации, показанной в Центре администрирования Microsoft Entra. Наследуется от recommendationBase.
category recommendationCategory Указывает категорию интеллектуального руководства, к которому относится рекомендация. Допустимые значения: identityBestPractice, identitySecureScore, unknownFutureValue. Наследуется от recommendationBase.

Поддерживает $filter(eq).
createdDateTime DateTimeOffset Дата и время обнаружения рекомендации в соответствии с вашим каталогом. Наследуется от recommendationBase.
currentScore Двойное с плавающей точкой Количество баллов, достигнутое клиентом. Применяется только к рекомендациям с категорией , для нее задано значение identitySecureScore. Наследуется от recommendationBase.
displayName String Заголовок рекомендации. Наследуется от recommendationBase.
featureAreas коллекция recommendationFeatureAreas Компонент каталога, с которым связана рекомендация . Наследуется от recommendationBase.

Поддерживает $filter(eq).
id String Уникальный идентификатор объекта рекомендации , созданного для клиента. Это объединение идентификатора клиента и псевдонима, присвоенного идентификатором Microsoft Entra для рекомендации. Например, 7918d4b5-0442-4a97-be2d-36f9f9962ece_Microsoft.Identity.IAM.Insights.ThirdPartyApps. Наследуется от recommendationBase.
impactStartDateTime DateTimeOffset Дата и время выполнения рекомендации в будущем. Наследуется от recommendationBase.
impactType String Указывает область влияния рекомендации. Tenant level указывает, что рекомендация влияет на весь клиент. Другие возможные значения: users, applications. Наследуется от recommendationBase.
insights String Описывает, почему рекомендация однозначно применяется к вашему каталогу. Соответствует разделу Описание рекомендации, показанной в Центре администрирования Microsoft Entra. Наследуется от recommendationBase.
lastCheckedDateTime DateTimeOffset Последняя дата и время, когда рекомендация считается применимой к вашему каталогу. Наследуется от recommendationBase.
lastModifiedBy String Имя пользователя, который в последний раз обновлял состояниерекомендации. Наследуется от recommendationBase.
lastModifiedDateTime DateTimeOffset Дата и время последнего обновления состояниярекомендации . Наследуется от recommendationBase.
maxScore Двойное с плавающей точкой Максимальное достижимое количество баллов. Применяется только к рекомендациям с категорией , для нее задано значение identitySecureScore. Наследуется от recommendationBase.
postponeUntilDateTime DateTimeOffset Будущая дата и время повторного выполнения отложенной рекомендацииactive. Наследуется от recommendationBase.
priority recommendationPriority Указывает чувствительность времени для выполнения рекомендации . Корпорация Майкрософт автоматически присваивает это значение. Допустимые значения: low, medium, high. Наследуется от recommendationBase. Только для чтения.

Поддерживает $filter(eq).
recommendationType recommendationType Понятное короткое имя для определения рекомендации. Возможные значения: adfsAppsMigration, , enableDesktopSSOenablePHS, , enableProvisioning, switchFromPerUserMFAtenantMFA, , thirdPartyAppsappRoleAssignmentsUsersoverprivilegedAppspwagePolicyNewappRoleAssignmentsGroupsintegratedAppsmanagedIdentitysigninRiskPolicyadminMFAV2servicePrincipalKeyExpiryapplicationCredentialExpiryroleOverlapmfaRegistrationV2staleAppCredsblockLegacyAuthenticationpasswordHashSyncverifyAppPublisherprivateLinkForAADuserRiskPolicyselfServicePasswordResetoneAdminstaleAppsuseMyAppsuseAuthenticatorAppturnOffPerUserMFA, unknownFutureValue, longLivedCredentials, , . aadConnectDeprecatedadalToMsalMigrationownerlessAppsinactiveGuestsaadGraphDeprecationApplicationaadGraphDeprecationServicePrincipalmfaServerDeprecation Обратите внимание, что необходимо использовать Prefer: include-unknown-enum-members заголовок запроса для получения следующих значений в этом развиваемом перечислении: longLivedCredentials , aadConnectDeprecated , adalToMsalMigration , ownerlessApps , inactiveGuests , aadGraphDeprecationApplication , aadGraphDeprecationServicePrincipal . mfaServerDeprecation Наследуется от recommendationBase.

В настоящее время доступно только ограниченное число. Дополнительные сведения см. в разделе Типы рекомендаций. Поддерживает $filter(eq).
releaseType releaseType Текущий тип выпуска рекомендации. Допустимые значения: preview, generallyAvailable, unknownFutureValue. Наследуется от recommendationBase.
remediationImpact String Описание влияния исправления на пользователей. Применяется только к рекомендациям с категорией , для нее задано значение identitySecureScore. Наследуется от recommendationBase.
status recommendationStatus Указывает состояние рекомендации на основе действия пользователя или системы. Допустимые значения: active, completedBySystem, completedByUser, dismissed, postponed, unknownFutureValue. По умолчанию состояние рекомендации устанавливается в значение 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"
}