Ressourcentyp der Empfehlung

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 von Microsoft empfohlene bewährte Methode oder Verbesserungsmaßnahme für Microsoft Entra ID für Ihren Microsoft Entra ID-Mandanten dar.

Der Microsoft Entra Empfehlungsdienst wird täglich ausgeführt, um Ihren Mandanten anhand der vordefinierten Bedingungen für jede Empfehlung zu überprüfen. Wenn der Dienst erkennt, dass eine Empfehlung auf Ihren Mandanten zutrifft, wird das entsprechende Empfehlungsobjekt generiert und sein Status auf aktiv gesetzt.

Weitere Informationen finden Sie unter Was sind die Empfehlungen von Microsoft Entra?.

Erbt von recommendationBase.

Methoden

Methode Rückgabetyp Beschreibung
List Sammlung von Empfehlungen Rufen Sie eine Liste der Empfehlungsobjekte und deren Eigenschaften ab.
Get recommendation Lesen der Eigenschaften und Beziehungen eines Empfehlungsobjekts .
Verschieben recommendation Markieren Sie den Status eines Empfehlungsobjekts zu postponed einem bestimmten Datum und einer angegebenen 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
Als geplant markieren recommendation Markieren Sie den Status eines Empfehlungsobjekts als .planned
Risiko akzeptieren recommendation Markieren Sie den Status eines Empfehlungsobjekts als .riskAccepted
Wenden Sie eine alternative Risikominderung an recommendation Markieren Sie den Status eines Empfehlungsobjekts als .alternateMitigation
Tag hinzufügen recommendationTag Hinzufügen eines benutzerdefinierten Tags zu einer Empfehlung.
Tag entfernen recommendation Entfernen einer benutzerdefinierten Kategorie aus einer Empfehlung.
Mandantensicherheitsbewertung abrufen tenantSecureScore-Sammlung Abrufen historischer Secure Score-Daten für Ihren Mandanten.

Eigenschaften

Eigenschaft Typ Beschreibung
actionSteps actionStep-Sammlung Liste der Aktionen, die ausgeführt werden können, um eine Empfehlung abzuschließen. Geerbt von recommendationBase.
Vorteile Zeichenfolge Eine Erläuterung, warum das Ausfüllen der Empfehlung für Sie von Vorteil ist. Entspricht dem Wertabschnitt einer Empfehlung, der im Microsoft Entra Admin Center angezeigt wird. Geerbt von recommendationBase.
category recommendationCategory Gibt die Kategorie intelligenter Anleitungen an, unter die die Empfehlung fällt. Mögliche Werte sind: identityBestPractice, identitySecureScore, unknownFutureValue, mdiSecureScore. Verwenden Sie den Prefer: include-unknown-enum-members Anforderungsheader, um die folgenden Werte aus dieser entwicklungsfähigen Aufzählung zu erhalten: mdiSecureScore. Geerbt von recommendationBase.

Unterstützt $filter(eq).
categoryGroup recommendationCategoryGroup Die Business-Taxonomiegruppe, zu der die Empfehlung gehört; verwendet zum Organisieren von Empfehlungen im Microsoft Entra Admin Center. Mögliche Werte sind: strengthenAuthentication, detectAndRespondToThreats, enforceLeastPrivilege, governAppsCredentialsAndAgents, hardenInfrastructure, defenderForIdentity, unknownFutureValue. Geerbt von recommendationBase. Schreibgeschützt.

Unterstützt $filter(eq).
completedBySystemDateTime DateTimeOffset Das Datum und die Uhrzeit, zu der der Empfehlungsdienst überprüft hat, ob die Empfehlung vollständig behoben wurde, und seinen Status auf gesetzt hatcompletedBySystem. Gibt null an, ob die Empfehlung vom System nicht abgeschlossen wurde. Geerbt von recommendationBase.
completedByUserDateTime DateTimeOffset Das Datum und die Uhrzeit, zu der die Empfehlung vom Benutzer für den aktuellen Überprüfungszyklus als abgeschlossen markiert wurde. Gibt an, ob die Empfehlung von einem Benutzer im aktuellen Zyklus null nicht abgeschlossen wurde. Geerbt von recommendationBase.
createdDateTime DateTimeOffset Das Datum und die Uhrzeit, zu der die Empfehlung als auf Ihr Verzeichnis anwendbar erkannt wurde. Geerbt von recommendationBase.
currentScore Gleitkommawert mit doppelter Genauigkeit Die Anzahl von Punkten, 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.
failedReviewDateTime DateTimeOffset Das Datum und die Uhrzeit, zu der der Empfehlungsdienst zuletzt überprüft hat, dass eine oder mehrere betroffene Ressourcen, die der Benutzer als abgeschlossen markiert hat, weiterhin betroffen sind, und sie in verschoben werden needsMoreAction. Schließt sich gegenseitig mit remediatedDateTime aus. Gibt null an, wenn die Überprüfung bei keiner vom Benutzer überprüften Ressource derzeit fehlschlägt. Geerbt von recommendationBase.
featureAreas recommendationFeatureAreas-Sammlung 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 von 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 Zukünftiges Datum und Uhrzeit, zu dem eine Empfehlung abgeschlossen werden soll. Geerbt von recommendationBase.
impactType Zeichenfolge Gibt den Wirkungsbereich einer Empfehlung an. tenantLevel gibt an, dass sich die Empfehlung auf den gesamten Mandanten auswirkt. Andere mögliche Werte sind users: apps. Geerbt von recommendationBase.
Einblicke Zeichenfolge Beschreibt, warum eine Empfehlung speziell für Ihr Verzeichnis gilt. Entspricht dem Beschreibungsabschnitt einer Empfehlung, der im Microsoft Entra Admin Center angezeigt wird. Geerbt von recommendationBase.
lastCheckedDateTime DateTimeOffset Das Datum und die Uhrzeit, zu der eine Empfehlung für Ihr Verzeichnis als anwendbar erachtet wurde. Geerbt von recommendationBase.
lastModifiedBy Zeichenfolge Name des Benutzers, der den Status der Empfehlung zuletzt aktualisiert hat. Geerbt von recommendationBase.
lastModifiedDateTime DateTimeOffset Datum und Uhrzeit der letzte Aktualisierung des Status einer Empfehlung. 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.
needsMoreActionResourceCount Int32 Die Anzahl der betroffenen Ressourcen, die der Benutzer als abgeschlossen markiert hat und die der Empfehlungsdienst anschließend überprüft hat, sind weiterhin betroffen (verschoben in needsMoreAction). Dieser Wert ist genau dann größer als Null, wenn failedReviewDateTime eingestellt ist. ist null , wenn die Empfehlung nicht am Überprüfungslebenszyklus beteiligt ist. Geerbt von recommendationBase.
nistClassifications nistClassification-Sammlung Die NIST Cybersecurity Framework (CSF) 2.0-Kategorien, denen die Empfehlung zugeordnet ist. Geerbt von recommendationBase. Schreibgeschützt.
postponeUntilDateTime DateTimeOffset Zukünftiges Datum und Uhrzeit, wann der Status einer zurückgestellten Empfehlung wieder giltactive. Geerbt von recommendationBase.
priority recommendationPriority Gibt die Zeitempfindlichkeit für das Abschließen einer Empfehlung an. Microsoft automatisch weist diesen Wert zu. Mögliche Werte sind: low, medium, high, critical, unknownFutureValue. Geerbt von recommendationBase. Schreibgeschützt.

Unterstützt $filter(eq).
recommendationType recommendationType Anzeigekurzname zur Identifizierung der Empfehlung. Die möglichen Werte sind: adfsAppsMigration, enableDesktopSSO, enablePHS, enableProvisioning, switchFromPerUserMFA, tenantMFAthirdPartyAppsturnOffPerUserMFAuseAuthenticatorAppuseMyAppsstaleAppsstaleAppCredsapplicationCredentialExpiryservicePrincipalKeyExpiryadminMFAV2blockLegacyAuthenticationintegratedAppsmfaRegistrationV2pwagePolicyNewpasswordHashSynconeAdminroleOverlapselfServicePasswordResetsigninRiskPolicyuserRiskPolicyverifyAppPublisherprivateLinkForAADappRoleAssignmentsGroupsappRoleAssignmentsUsersmanagedIdentityoverprivilegedAppsunknownFutureValuelongLivedCredentialsaadConnectDeprecatedadalToMsalMigrationownerlessAppsinactiveGuestsaadGraphDeprecationApplicationaadGraphDeprecationServicePrincipalmfaServerDeprecation Verwenden Sie den Prefer: include-unknown-enum-members Anforderungsheader, um die folgenden Elemente in dieser entwicklungsfähigen Aufzählung abzurufen: longLivedCredentials , aadConnectDeprecated , adalToMsalMigration , ownerlessAppsmfaServerDeprecationinactiveGuestsaadGraphDeprecationApplicationaadGraphDeprecationServicePrincipal . Geerbt von recommendationBase.

Derzeit ist nur eine begrenzte Anzahl verfügbar. Weitere Informationen finden Sie unter Arten von Empfehlungen. Unterstützt $filter(eq).
releaseType releaseType Der aktuelle Releasetyp der Empfehlung. Die möglichen Werte sind: preview, generallyAvailable, unknownFutureValue. Geerbt von recommendationBase.
remediatedDateTime DateTimeOffset Das Datum und die Uhrzeit, zu der der Empfehlungsservice überprüft hat, ob die betroffenen Ressourcen, die der Benutzer als abgeschlossen markiert hat, wiederhergestellt wurden, was bedeutet, dass die vom Benutzer überprüften Ressourcen erreicht wurden completedBySystem. Wird durch failedReviewDateTime ersetzt, wenn eine überprüfte Ressource anschließend die Überprüfung nicht besteht. Gibt null an, ob das System eine benutzergesteuerte Korrektur im aktuellen Zyklus nicht überprüft hat. Geerbt von recommendationBase.
remediationImpact Zeichenfolge Beschreibung der Auswirkungen der Korrektur 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 einer Benutzer- oder Systemaktion an. Die möglichen Werte sind: active, completedBySystem, completedByUser, dismissed, postponed, unknownFutureValuealternateMitigationriskAcceptedplannedthirdPartyneedsMoreAction. Verwenden Sie den Prefer: include-unknown-enum-members Anforderungsheader, um die folgenden Werte aus dieser evolvierbaren Aufzählung zu erhalten: riskAccepted , thirdParty , planned , alternateMitigation , needsMoreAction. Standardmäßig wird der Status einer Empfehlung auf active den Zeitpunkt festgelegt, zu dem die Empfehlung zum ersten Mal generiert wird. Der Status wird gesetzt completedBySystem , wenn unser Dienst erkennt, dass eine zuvor aktive Empfehlung nicht mehr zutrifft. Geerbt von recommendationBase.

Unterstützt $filter(eq).
statusModifiedDateTime DateTimeOffset Das Datum und die Uhrzeit, zu der sich der Status der Empfehlung zuletzt geändert hat, dismissedz. B. von active "Bis completedByUser, , postponedoder ".needsMoreAction Im Gegensatz zu lastModifiedDateTime wird dieser Wert nicht aktualisiert, wenn sich nur die Erkenntnisdaten der Empfehlung ändern, während der Status gleich bleibt. Wird so lange gedauertnull, bis sich der Status der Empfehlung zum ersten Mal ändert. Geerbt von recommendationBase.

Beziehungen

Beziehung Typ Beschreibung
impactedResources impactedResource collection Die Liste der Verzeichnisobjekte, die der Empfehlung zugeordnet sind. Geerbt von recommendationBase.
tags recommendationTag-Sammlung Die benutzerdefinierten Freiformbezeichnungen, die auf die Empfehlung angewendet werden. Die Sammlung ist nicht direkt beschreibbar; Tags werden über die Aktionen addTag und removeTag erstellt und entfernt. 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",
  "categoryGroup": "String",
  "completedBySystemDateTime": "String (timestamp)",
  "completedByUserDateTime": "String (timestamp)",
  "createdDateTime": "String (timestamp)",
  "currentScore": "Double",
  "displayName": "String",
  "failedReviewDateTime": "String (timestamp)",
  "featureAreas": [
    "String"
  ],
  "impactType": "String",
  "impactStartDateTime": "String (timestamp)",
  "insights": "String",
  "lastCheckedDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "lastModifiedBy": "String",
  "maxScore": "Double",
  "needsMoreActionResourceCount": "Int32",
  "nistClassifications": [
    {
      "@odata.type": "microsoft.graph.nistClassification"
    }
  ],
  "postponeUntilDateTime": "String (timestamp)",
  "priority": "String",
  "remediatedDateTime": "String (timestamp)",
  "status": "String",
  "statusModifiedDateTime": "String (timestamp)",
  "remediationImpact": "String",
  "recommendationType": "String"
}
  • Zuletzt aktualisiert um