recommendationBase リソースの種類

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

推奨リソースの種類のプロパティを公開する抽象型。

メソッド

なし。

プロパティ

プロパティ	種類	説明
actionSteps	actionStep コレクション	推奨事項を完了するために実行するアクションの一覧。
利点	String	推奨事項を完了するとメリットが得られる理由の説明。 Microsoft Entra 管理センターに表示される推奨事項の [値] セクションに対応します。
category	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 は、推奨事項がテナント全体に影響することを示します。 その他の使用可能な値には、 がapplications含まれますusers。
insights	String	推奨事項がディレクトリに一意に適用される理由について説明します。 Microsoft Entra 管理センターに表示される推奨事項の [説明] セクションに対応します。
lastCheckedDateTime	DateTimeOffset	推奨事項がディレクトリに適用されると見なされた最新の日付と時刻。
lastModifiedBy	String	推奨事項の状態を最後に更新したユーザーの名前。
lastModifiedDateTime	DateTimeOffset	推奨事項の状態が最後に更新された日時。
maxScore	倍精度浮動小数点数	達成可能なポイントの最大数。 カテゴリが に設定identitySecureScoreされている推奨事項にのみ適用されます。
postponeUntilDateTime	DateTimeOffset	延期された推奨事項の状態が再び表示されるactive将来の日付と時刻。
priority	recommendationPriority	推奨事項が完了する時間の秘密度を示します。 Microsoft はこの値を自動で割り当てます。 使用可能な値: low、medium、high。
recommendationType	recommendationType	推奨事項を識別するためのフレンドリな短縮名。 使用できる値は、adfsAppsMigrationenableProvisioningenablePHSenableDesktopSSO、switchFromPerUserMFA、tenantMFA、、thirdPartyApps、appRoleAssignmentsUsersappRoleAssignmentsGroupsoverprivilegedAppsservicePrincipalKeyExpiryapplicationCredentialExpirystaleAppCredsstaleAppsadminMFAV2useMyAppsturnOffPerUserMFAverifyAppPublisheruserRiskPolicyprivateLinkForAADmanagedIdentityselfServicePasswordResetaadGraphDeprecationApplicationroleOverlapmfaRegistrationV2integratedAppspwagePolicyNewblockLegacyAuthenticationpasswordHashSyncuseAuthenticatorApponeAdminsigninRiskPolicyownerlessAppsadalToMsalMigrationinactiveGuestslongLivedCredentialsaadConnectDeprecatedunknownFutureValue、 aadGraphDeprecationServicePrincipalmfaServerDeprecationです。 要求ヘッダーをPrefer: include-unknown-enum-members使用して、この進化可能な列挙型で次の値を取得する必要があることに注意してください。 longLivedCredentialsaadConnectDeprecatedadalToMsalMigrationownerlessAppsinactiveGuestsaadGraphDeprecationApplicationaadGraphDeprecationServicePrincipalmfaServerDeprecation
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"
}