次の方法で共有

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 は、推奨事項がテナント全体に影響することを示します。 その他の使用可能な値には、 users、 applicationsが含まれます。
insights String 推奨事項がディレクトリに一意に適用される理由について説明します。 Microsoft Entra 管理センターに示されている推奨事項の [説明] セクションに対応します。
lastCheckedDateTime DateTimeOffset 推奨事項がディレクトリに適用されると見なされた最新の日付と時刻。
lastModifiedBy String 推奨事項の状態を最後に更新したユーザーの名前。
lastModifiedDateTime DateTimeOffset 推奨事項の状態が最後に更新された日時。
maxScore 倍精度浮動小数点数 達成可能なポイントの最大数。 カテゴリが identitySecureScore に設定されている推奨事項にのみ適用されます。
postponeUntilDateTime DateTimeOffset 延期された推奨事項の状態が再びactiveされる将来の日付と時刻。
priority recommendationPriority 推奨事項が完了する時間の秘密度を示します。 Microsoft はこの値を自動で割り当てます。 使用可能な値: low、medium、high。
recommendationType recommendationType 推奨事項を識別するためのフレンドリな短縮名。 使用できる値は、 adfsAppsMigration、 enableDesktopSSO、 enablePHS、 enableProvisioning、 switchFromPerUserMFA、 tenantMFA、 thirdPartyApps、 turnOffPerUserMFA、 useAuthenticatorApp、 useMyApps、 staleApps、 staleAppCreds、 applicationCredentialExpiry、 servicePrincipalKeyExpiry、 adminMFAV2、 blockLegacyAuthentication、 integratedApps、 mfaRegistrationV2、 pwagePolicyNew、 passwordHashSync、 oneAdmin、 roleOverlap、 selfServicePasswordReset、 signinRiskPolicy、 userRiskPolicy、 verifyAppPublisher、 privateLinkForAAD、 appRoleAssignmentsGroups、 appRoleAssignmentsUsers、 managedIdentity、 overprivilegedApps、 unknownFutureValue、 longLivedCredentials、 aadConnectDeprecated、 adalToMsalMigration、 ownerlessApps、 inactiveGuests、 aadGraphDeprecationApplication、 aadGraphDeprecationServicePrincipal、 mfaServerDeprecation。 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"
}