推奨事項リソースの種類
名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
Microsoft Entra テナントに対して Microsoft によって推奨されるMicrosoft Entra IDベスト プラクティスまたは改善アクションを表します。
Microsoft Entraレコメンデーション サービスは、推奨事項ごとに定義済みの条件に対してテナントをチェックするために毎日実行されます。 推奨事項がテナントに適用されていることがサービスによって検出された場合、対応する推奨事項オブジェクトが生成され、その状態がアクティブに設定されます。
詳細については、「Microsoft Entra推奨事項とは」を参照してください。
recommendationBase から継承します。
メソッド
| メソッド | 戻り値の種類 | 説明 |
|---|---|---|
| List | レコメンデーション コレクション | 推奨事項オブジェクトとそのプロパティの一覧を取得します。 |
| Get | 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 | テナント用に生成された 推奨事項 オブジェクトの一意識別子。 これは、テナント ID と推奨事項のMicrosoft Entra ID割り当てられたニックネームを連結したものです。 たとえば、「 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 |
推奨事項が完了する時間の秘密度を示します。 Microsoft はこの値を自動で割り当てます。 使用可能な値: low、medium、high。
recommendationBase から継承されます。 読み取り専用です。 $filter(eq) をサポートします。 |
| 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。
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"
}