EmpfehlungBasisressourcentyp

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.

Ein abstrakter Typ, der die Eigenschaften für den Ressourcentyp "Empfehlung" verfügbar macht.

Methoden

Keine.

Eigenschaften

Eigenschaft Typ Beschreibung
actionSteps actionStep-Sammlung Liste der Aktionen, die ausgeführt werden können, um eine Empfehlung abzuschließen.
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.
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.
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. 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. Unterstützt $filter.
completedByUserDateTime DateTimeOffset Das Datum und die Uhrzeit, zu der die Empfehlung vom Benutzer für den aktuellen Überprüfungszyklus als abgeschlossen markiert wurde, einschließlich des Zeitpunkts, an dem der Wert aus allen betroffenen Ressourcen hochgerollt wird, die vom Benutzer als abgeschlossen markiert werden. Gibt an, ob die Empfehlung von einem Benutzer im aktuellen Zyklus null nicht abgeschlossen wurde. Unterstützt $filter.
createdDateTime DateTimeOffset Das Datum und die Uhrzeit, zu der die Empfehlung als auf Ihr Verzeichnis anwendbar erkannt wurde.
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.
displayName Zeichenfolge Der Titel der Empfehlung.
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. Wird gelöscht, wenn die überprüften Ressourcen wiederhergestellt werden, daher schließt es sich gegenseitig mit remediatedDateTime aus. Gibt null an, wenn die Überprüfung bei keiner vom Benutzer überprüften Ressource derzeit fehlschlägt. Unterstützt $filter.
featureAreas recommendationFeatureAreas-Sammlung Das Verzeichnisfeature, auf das sich die Empfehlung bezieht.
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
impactStartDateTime DateTimeOffset Zukünftiges Datum und Uhrzeit, zu dem eine Empfehlung abgeschlossen werden soll.
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.
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.
lastCheckedDateTime DateTimeOffset Das Datum und die Uhrzeit, zu der eine Empfehlung für Ihr Verzeichnis als anwendbar erachtet wurde.
lastModifiedBy Zeichenfolge Name des Benutzers, der den Status der Empfehlung zuletzt aktualisiert hat.
lastModifiedDateTime DateTimeOffset Datum und Uhrzeit der letzte Aktualisierung des Status einer Empfehlung.
maxScore Gleitkommawert mit doppelter Genauigkeit Die maximal erreichbare Anzahl von Punkten. Gilt nur für Empfehlungen , bei denen die Kategorie auf festgelegt ist identitySecureScore.
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.
nistClassifications nistClassification-Sammlung Die NIST Cybersecurity Framework (CSF) 2.0-Kategorien, denen die Empfehlung zugeordnet ist. Schreibgeschützt.
postponeUntilDateTime DateTimeOffset Zukünftiges Datum und Uhrzeit, wann der Status einer zurückgestellten Empfehlung wieder giltactive.
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.
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 .
releaseType releaseType Der aktuelle Releasetyp der Empfehlung. Die möglichen Werte sind: preview, generallyAvailable, unknownFutureValue.
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. Unterstützt $filter.
remediationImpact Zeichenfolge Beschreibung der Auswirkungen der Korrektur auf die Benutzer. Gilt nur für Empfehlungen , bei denen die Kategorie auf festgelegt ist identitySecureScore.
requiredLicenses requiredLicenses Die erforderlichen Lizenzen, um die Empfehlung anzuzeigen. Die möglichen Werte sind: notApplicable, microsoftEntraIdFree, microsoftEntraIdP1, microsoftEntraIdP2, microsoftEntraIdGovernancemicrosoftEntraWorkloadId, unknownFutureValue, aatp. microsoftEntraSuite Verwenden Sie den Prefer: include-unknown-enum-members Anforderungsheader, um die folgenden Werte aus dieser entwicklungsfähigen Aufzählung zu erhalten: aatp, microsoftEntraSuite.
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.
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. Unterstützt $filter.

Beziehungen

Beziehung Typ Beschreibung
impactedResources impactedResource collection Die Liste der Verzeichnisobjekte, die der Empfehlung zugeordnet sind.
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.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.recommendationBase",
  "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"
  ],
  "releaseType": "String",
  "requiredLicenses": "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