Empfehlungsressourcentyp
Namespace: microsoft.graph
Wichtig
Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.
Stellt eine bewährte Methode oder Verbesserungsaktion für Microsoft Entra ID dar, die von Microsoft für Ihren Microsoft Entra-Mandanten empfohlen wird.
Der Microsoft Entra-Empfehlungsdienst wird täglich ausgeführt, um Ihren Mandanten anhand vordefinierter Bedingungen für jede Empfehlung zu überprüfen. Wenn der Dienst erkennt, dass eine Empfehlung für Ihren Mandanten gilt, wird das entsprechende Empfehlungsobjekt generiert und sein Status auf Aktiv festgelegt.
Weitere Informationen finden Sie unter Was sind Microsoft Entra-Empfehlungen?.
Erbt von recommendationBase.
Methoden
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| List | Empfehlungssammlung | Ruft eine Liste der Empfehlungsobjekte und deren Eigenschaften ab. |
| Get | recommendation | Liest die Eigenschaften und Beziehungen eines Empfehlungsobjekts . |
| Verschieben | recommendation | Markieren Sie den Status eines Empfehlungsobjekts als postponed ein angegebenes Datum und eine angegebene Uhrzeit. |
| Dismiss | recommendation | Markieren Sie den Status eines Empfehlungsobjekts als dismissed. |
| Complete | recommendation | Markieren Sie den Status eines Empfehlungsobjekts als completedByUser. |
| Reaktivieren | recommendation | Markieren Sie den Status eines Empfehlungsobjekts als active. |
| Abrufen der Mandantensicherheitsbewertung | tenantSecureScore-Sammlung | Abrufen von verlaufsbezogenen Sicherheitsbewertungsdaten für Ihren Mandanten. |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| actionSteps | actionStep-Sammlung | Liste der Aktionen, die ausgeführt werden müssen, um eine Empfehlung abzuschließen. Geerbt von recommendationBase. |
| nützt | String | Eine Erläuterung, warum das Ausfüllen der Empfehlung ihnen zugute kommt. Entspricht dem Abschnitt Wert einer Empfehlung, die im Microsoft Entra Admin Center angezeigt wird. Geerbt von recommendationBase. |
| category | recommendationCategory | Gibt die Kategorie der intelligenten Anleitung an, unter die die Empfehlung fällt. Die möglichen Werte sind: identityBestPractice, identitySecureScore, unknownFutureValue. Geerbt von recommendationBase. Unterstützt $filter(eq). |
| createdDateTime | DateTimeOffset | Das Datum und die Uhrzeit, zu dem die Empfehlung als für Ihr Verzeichnis zutreffend erkannt wurde. Geerbt von recommendationBase. |
| currentScore | Gleitkommawert mit doppelter Genauigkeit | Die Anzahl der Punkte, die der Mandant erreicht hat. Gilt nur für Empfehlungen , bei denen die Kategorie auf festgelegt ist identitySecureScore. Geerbt von recommendationBase. |
| displayName | String | Der Titel der Empfehlung. Geerbt von recommendationBase. |
| featureAreas | recommendationFeatureAreas-Auflistung | Das Verzeichnisfeature, auf das sich die Empfehlung bezieht. Geerbt von recommendationBase. Unterstützt $filter(eq). |
| id | String | Der eindeutige Bezeichner für das Empfehlungsobjekt , das für Ihren Mandanten generiert wurde. Dies ist eine Verkettung Ihrer Mandanten-ID und eines microsoft Entra ID zugewiesenen Spitznamens für die Empfehlung. Beispiel: 7918d4b5-0442-4a97-be2d-36f9f9962ece_Microsoft.Identity.IAM.Insights.ThirdPartyApps. Geerbt von recommendationBase. |
| impactStartDateTime | DateTimeOffset | Das zukünftige Datum und die Uhrzeit, zu dem eine Empfehlung abgeschlossen werden soll. Geerbt von recommendationBase. |
| impactType | String | Gibt den Wirkungsbereich einer Empfehlung an.
Tenant level gibt an, dass sich die Empfehlung auf den gesamten Mandanten auswirkt. Weitere mögliche Werte sind , usersapplications. Geerbt von recommendationBase. |
| Einblicke | String | Beschreibt, warum eine Empfehlung eindeutig für Ihr Verzeichnis gilt. Entspricht dem Abschnitt Beschreibung einer Empfehlung, die im Microsoft Entra Admin Center angezeigt wird. Geerbt von recommendationBase. |
| lastCheckedDateTime | DateTimeOffset | Das letzte Datum und die Letzte Uhrzeit, zu der eine Empfehlung für Ihr Verzeichnis gilt. Geerbt von recommendationBase. |
| lastModifiedBy | String | Name des Benutzers, der den Status der Empfehlung zuletzt aktualisiert hat. Geerbt von recommendationBase. |
| lastModifiedDateTime | DateTimeOffset | Das Datum und die Uhrzeit, zu der der Status einer Empfehlung zuletzt aktualisiert wurde. Geerbt von recommendationBase. |
| maxScore | Gleitkommawert mit doppelter Genauigkeit | Die maximal erreichbare Anzahl von Punkten. Gilt nur für Empfehlungen , bei denen die Kategorie auf festgelegt ist identitySecureScore. Geerbt von recommendationBase. |
| postponeUntilDateTime | DateTimeOffset | Das zukünftige Datum und die Uhrzeit, zu dem der Status einer verschobenen Empfehlung erneut lautet active . Geerbt von recommendationBase. |
| priority | recommendationPriority | Gibt die Zeitempfindlichkeit für die Fertigstellung einer Empfehlung an. Microsoft weist diesen Wert automatisch zu. Die möglichen Werte sind: low, medium, high. Geerbt von recommendationBase. Schreibgeschützt. Unterstützt $filter(eq). |
| recommendationType | recommendationType | Benutzerfreundlicher Kurzname, um die Empfehlung zu identifizieren. Die möglichen Werte sind: adfsAppsMigration, enableDesktopSSO, , enableProvisioningenablePHS, , tenantMFAuseAuthenticatorAppmanagedIdentityuseMyAppsoverprivilegedAppsstaleAppsmfaServerDeprecationapplicationCredentialExpiryaadGraphDeprecationServicePrincipalservicePrincipalKeyExpiryaadGraphDeprecationApplicationstaleAppCredsinactiveGuestsadminMFAV2turnOffPerUserMFAprivateLinkForAADblockLegacyAuthenticationappRoleAssignmentsGroupsintegratedAppsappRoleAssignmentsUsersadalToMsalMigrationverifyAppPublisherownerlessAppsaadConnectDeprecatedlongLivedCredentialsunknownFutureValueuserRiskPolicysigninRiskPolicyselfServicePasswordResetroleOverlappasswordHashSyncmfaRegistrationV2oneAdminswitchFromPerUserMFAthirdPartyAppspwagePolicyNew. Beachten Sie, dass Sie den Prefer: include-unknown-enum-members Anforderungsheader verwenden müssen, um die folgenden Werte in dieser verteilbaren Enumeration abzurufen: longLivedCredentials , aadConnectDeprecated , , ownerlessAppsadalToMsalMigration , inactiveGuests , aadGraphDeprecationApplication , aadGraphDeprecationServicePrincipalmfaServerDeprecation. Geerbt von recommendationBase. Derzeit ist nur eine begrenzte Anzahl verfügbar. Weitere Informationen finden Sie unter Typen von Empfehlungen. Unterstützt $filter(eq). |
| releaseType | releaseType | Der aktuelle Releasetyp der Empfehlung. Die möglichen Werte sind: preview, generallyAvailable, unknownFutureValue. Geerbt von recommendationBase. |
| remediationImpact | String | Beschreibung der Auswirkungen der Wartung auf die Benutzer. Gilt nur für Empfehlungen , bei denen die Kategorie auf festgelegt ist identitySecureScore. Geerbt von recommendationBase. |
| status | recommendationStatus | Gibt den Status der Empfehlung basierend auf der Benutzer- oder Systemaktion an. Mögliche Werte sind: active, completedBySystem, completedByUser, dismissed, postponed, unknownFutureValue. Standardmäßig wird der Status einer Empfehlung auf active festgelegt, wenn die Empfehlung zum ersten Mal generiert wird.
Der Status wird auf completedBySystem festgelegt, wenn unser Dienst erkennt, dass eine Empfehlung, die zuvor aktiv war, nicht mehr gilt. Geerbt von recommendationBase. Unterstützt $filter(eq). |
Beziehungen
| Beziehung | Typ | Beschreibung |
|---|---|---|
| impactedResources | impactedResource-Sammlung | Die Liste der Verzeichnisobjekte, die der Empfehlung zugeordnet sind. Geerbt von recommendationBase. |
JSON-Darstellung
Die folgende JSON-Darstellung zeigt den Ressourcentyp.
{
"@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"
}