Freigeben über


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"
}