Freigeben über

Empfehlungsressourcentyp

  • Artikel

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
Mandantensicherheitsbewertung abrufen 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 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. Verwenden Sie den Prefer: include-unknown-enum-members Anforderungsheader, um die folgenden Werte in dieser verteilbaren Enumeration abzurufen: longLivedCredentials , aadConnectDeprecated , adalToMsalMigration , ownerlessApps , inactiveGuests , aadGraphDeprecationApplication , aadGraphDeprecationServicePrincipal , , . mfaServerDeprecation 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 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 veranschaulicht 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"
}