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 Microsoft Entra ID bewährte Methode oder Verbesserungsaktion 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 wird 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 die status eines Empfehlungsobjekts als postponed ein angegebenes Datum und eine angegebene Uhrzeit.
Dismiss	recommendation	Markieren Sie die status eines Empfehlungsobjekts als .dismissed
Complete	recommendation	Markieren Sie die status eines Empfehlungsobjekts als .completedByUser
Reaktivieren	recommendation	Markieren Sie die 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.
Vorteile	Zeichenfolge	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	Zeichenfolge	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	Zeichenfolge	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	Zeichenfolge	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	Zeichenfolge	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	Zeichenfolge	Der Name des Benutzers, der die status der Empfehlung zuletzt aktualisiert hat. Geerbt von recommendationBase.
lastModifiedDateTime	DateTimeOffset	Das Datum und die Uhrzeit, zu der die 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 die status einer verschobenen Empfehlung erneut sindactive. 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 außerdem, dass Sie den Prefer: include-unknown-enum-members Anforderungsheader verwenden müssen, um die folgenden Werte in dieser verteilbaren Enumeration abzurufen: longLivedCredentials, aadConnectDeprecated, adalToMsalMigration, ownerlessApps, inactiveGuests. Geerbt von recommendationBase. Derzeit sind nur acht Typen 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	Zeichenfolge	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 die status der Empfehlung basierend auf der Benutzer- oder Systemaktion an. Mögliche Werte sind: active, completedBySystem, completedByUser, dismissed, postponed, unknownFutureValue. Standardmäßig wird die 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"
}