Freigeben über

recommendationBase-Ressourcentyp

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 Empfehlungsressourcentyp verfügbar macht.

Methoden

Keine.

Eigenschaften

Eigenschaft Typ Beschreibung
actionSteps actionStep-Sammlung Liste der Aktionen, die ausgeführt werden müssen, um eine Empfehlung abzuschließen.
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.
category recommendationCategory Gibt die Kategorie der intelligenten Anleitung an, unter die die Empfehlung fällt. Mögliche Werte sind: identityBestPractice, identitySecureScore, unknownFutureValue, mdiSecureScore. Verwenden Sie den Anforderungsheader Prefer: include-unknown-enum-members , um die folgenden Werte aus dieser verteilbaren Enumeration abzurufen: mdiSecureScore.
createdDateTime DateTimeOffset Das Datum und die Uhrzeit, zu dem die Empfehlung als für Ihr Verzeichnis zutreffend erkannt wurde.
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.
displayName Zeichenfolge Der Titel der Empfehlung.
featureAreas recommendationFeatureAreas-Auflistung 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 Microsoft Entra ID zugewiesenen Spitznamens für die Empfehlung. Beispiel: 7918d4b5-0442-4a97-be2d-36f9f9962ece_Microsoft.Identity.IAM.Insights.ThirdPartyApps
impactStartDateTime DateTimeOffset Das zukünftige Datum und die 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. Weitere mögliche Werte sind , usersapps.
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.
lastCheckedDateTime DateTimeOffset Das letzte Datum und die Letzte Uhrzeit, zu der eine Empfehlung für Ihr Verzeichnis gilt.
lastModifiedBy Zeichenfolge Der Name des Benutzers, der die status der Empfehlung zuletzt aktualisiert hat.
lastModifiedDateTime DateTimeOffset Das Datum und die Uhrzeit, zu der die status einer Empfehlung zuletzt aktualisiert wurde.
maxScore Gleitkommawert mit doppelter Genauigkeit Die maximal erreichbare Anzahl von Punkten. Gilt nur für Empfehlungen , bei denen die Kategorie auf festgelegt ist identitySecureScore.
postponeUntilDateTime DateTimeOffset Das zukünftige Datum und die Uhrzeit, zu dem die status einer verschobenen Empfehlung erneut sindactive.
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.
recommendationType recommendationType Benutzerfreundlicher Kurzname, um die Empfehlung zu identifizieren. Die möglichen Werte sind: adfsAppsMigration, enableDesktopSSO, , enableProvisioningenablePHS, , tenantMFAuseAuthenticatorAppmanagedIdentityuseMyAppsoverprivilegedAppsstaleAppsmfaServerDeprecationapplicationCredentialExpiryaadGraphDeprecationServicePrincipalservicePrincipalKeyExpiryaadGraphDeprecationApplicationstaleAppCredsinactiveGuestsadminMFAV2turnOffPerUserMFAprivateLinkForAADblockLegacyAuthenticationappRoleAssignmentsGroupsintegratedAppsappRoleAssignmentsUsersadalToMsalMigrationverifyAppPublisherownerlessAppsaadConnectDeprecatedlongLivedCredentialsunknownFutureValueuserRiskPolicysigninRiskPolicyselfServicePasswordResetroleOverlappasswordHashSyncmfaRegistrationV2oneAdminswitchFromPerUserMFAthirdPartyAppspwagePolicyNew. Verwenden Sie den Anforderungsheader Prefer: include-unknown-enum-members , um die folgenden Member in dieser verteilbaren Enumeration abzurufen: longLivedCredentials , aadConnectDeprecated , adalToMsalMigration , ownerlessApps , inactiveGuests , aadGraphDeprecationApplication , aadGraphDeprecationServicePrincipal , mfaServerDeprecation.
releaseType releaseType Der aktuelle Releasetyp der Empfehlung. Die möglichen Werte sind: preview, generallyAvailable, unknownFutureValue.
remediationImpact Zeichenfolge Beschreibung der Auswirkungen der Wartung auf die Benutzer. Gilt nur für Empfehlungen , bei denen die Kategorie auf festgelegt ist identitySecureScore.
requiredLizenzen requiredLizenzen Die erforderlichen Lizenzen zum Anzeigen der Empfehlung. Mögliche Werte: notApplicable, microsoftEntraIdFree, , microsoftEntraIdP1microsoftEntraIdP2, microsoftEntraIdGovernance, microsoftEntraWorkloadId, unknownFutureValue, , . aatp Verwenden Sie den Anforderungsheader Prefer: include-unknown-enum-members , um die folgenden Werte aus dieser verteilbaren Enumeration abzurufen: aatp.
status recommendationStatus Gibt die status der Empfehlung basierend auf der Benutzer- oder Systemaktion an. Mögliche Werte sind: active, completedBySystem, completedByUser, dismissed, postponed, unknownFutureValue, riskAccepted, thirdParty, planned, alternateMitigation. Verwenden Sie den Anforderungsheader Prefer: include-unknown-enum-members , um die folgenden Werte aus dieser verwertbaren Enumeration abzurufen: riskAccepted , thirdParty , planned , alternateMitigation. 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.

Beziehungen

Beziehung Typ Beschreibung
impactedResources impactedResource-Sammlung Die Liste der Verzeichnisobjekte, die der Empfehlung zugeordnet sind.

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",
  "createdDateTime": "String (timestamp)",
  "currentScore": "Double",
  "displayName": "String",
  "featureAreas": [
    "String"
  ],
  "releaseType": "String",
  "requiredLicenses": "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"
}
  • Last updated on