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. Die möglichen Werte sind: identityBestPractice , identitySecureScore , unknownFutureValue . |
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.
Tenant level gibt an, dass sich die Empfehlung auf den gesamten Mandanten auswirkt. Weitere mögliche Werte sind , users applications . |
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 , , enableProvisioning enablePHS , , tenantMFA useAuthenticatorApp managedIdentity useMyApps overprivilegedApps staleApps mfaServerDeprecation applicationCredentialExpiry aadGraphDeprecationServicePrincipal servicePrincipalKeyExpiry aadGraphDeprecationApplication staleAppCreds inactiveGuests adminMFAV2 turnOffPerUserMFA privateLinkForAAD blockLegacyAuthentication appRoleAssignmentsGroups integratedApps appRoleAssignmentsUsers adalToMsalMigration verifyAppPublisher ownerlessApps aadConnectDeprecated longLivedCredentials unknownFutureValue userRiskPolicy signinRiskPolicy selfServicePasswordReset roleOverlap passwordHashSync mfaRegistrationV2 oneAdmin switchFromPerUserMFA thirdPartyApps pwagePolicyNew . 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 |
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 sind: notApplicable , microsoftEntraIdFree , microsoftEntraIdP1 , microsoftEntraIdP2 , microsoftEntraIdGovernance , microsoftEntraWorkloadId , unknownFutureValue . |
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. |
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"
}