Neuerungen in Microsoft Graph
Microsoft Graph bietet ein einheitliches Programmierbarkeitsmodell, mit dem Sie auf Daten in Microsoft 365, Windows und Enterprise Mobility + Security zugreifen können. Dieser Artikel enthält Informationen zu den Neuerungen in Microsoft Graph-APIs, Dokumentation, SDKs und mehr.
Ausführlichere Updates auf API-Ebene finden Sie im Änderungsprotokoll von Microsoft Graph-API.
Ausführliche Informationen zu früheren Updates für Microsoft Graph finden Sie unter Microsoft Graph-Verlauf der Neuerungen.
Wichtig
Features in der Vorschauversion status können ohne vorherige Ankündigung geändert werden und werden möglicherweise nicht auf allgemein verfügbare (GA) status heraufgestuft. Verwenden Sie keine Vorschaufeatures in Produktions-Apps.
November 2024: Neu und allgemein verfügbar
Sicherheit | Identitäten
Mit der Defender for Identity-Sensorverwaltungs-API können Sie detaillierte Berichte zu den Sensoren in Ihrem Arbeitsbereich erstellen und Informationen wie Servername, Sensorversion, Typ, Zustand und Integrität status bereitstellen. Außerdem können Sie Sensoreinstellungen verwalten, z. B. Beschreibungen hinzufügen, verzögerte Updates aktivieren oder deaktivieren und den Domänencontroller angeben, mit dem der Sensor eine Verbindung herstellt, um die Entra-ID abzufragen. Weitere Informationen finden Sie unter Sensor.
Teamarbeit und Kommunikation | Anrufe und Onlinebesprechungen
Verwenden Sie die administrativeUnitInfos-Eigenschaft für Teilnehmer und Organisator , um die IDs einer oder mehrerer Verwaltungseinheiten für einen Anrufteilnehmer abzurufen.
November 2024: Neu nur in der Vorschau
Geräte- und App-Verwaltung | Cloud-PC
- Neue Endpunkte hinzugefügt, die Anwendungsberechtigungen in den folgenden Methoden der cloudPC-Ressource unterstützen:
- Verwenden Sie die eigenschaft reservePercentage in der [cloudPcProvisioningPolicy: apply]-Methode, um den Prozentsatz der Cloud-PCs anzugeben, die für freigegebene Frontline-Szenarien verfügbar bleiben sollen.
Geräte- und App-Verwaltung | Geräteupdates
- Stellen Sie ein Hotpatch-Qualitätsupdate mithilfe von Windows Autopatch bereit.
- Verwenden Sie die isHotpatchUpdate-Eigenschaft für productRevision , um zu ermitteln, ob der Inhalt hotpatchfähig ist.
- Verwenden Sie die isHotpatchEnabled-Eigenschaft für userExperienceSettings , um zu ermitteln, ob das Update als Hotpatch angeboten wird.
Identität und Zugriff | Netzwerkzugriff
Auflisten, Erstellen, Abrufen, Aktualisieren und Löschen von fqdnFilteringRule - und webCategoryFilteringRule-Ressourcen , die abgeleitete Filterrule-Typen sind.
Berichte | Identitäts- und Zugriffsberichte
Verwenden Sie die sessionId-Eigenschaft für signIn , um den Bezeichner der Sitzung abzurufen, die während einer Anmeldung generiert wurde.
Sicherheit | Ermittelte Cloud-Apps
Die neue API für Microsoft Defender für Cloud-Apps in Microsoft Graph bietet eine effiziente und zuverlässige Möglichkeit zum Abfragen von Informationen zu ermittelten Apps, sodass Sie die Risiken im Zusammenhang mit den ermittelten Apps einfacher analysieren können. Verwenden Sie die folgenden Ressourcen und deren Methoden, um Daten und Erkenntnisse über das ökosystem ermittelte SaaS-Apps zu erhalten:
- cloudAppDiscoveryReport
- discoveredCloudAppDetail
- discoveredCloudAppInfo
- discoveredCloudAppUser
- discoveredCloudAppIPAddress
- discoveredCloudAppDevice
- endpointDiscoveredCloudAppDetail
Teamarbeit und Kommunikation | KI-Interaktionen
Verwenden Sie die getAllEnterpriseInteractions-Methode, um Microsoft 365 Copilot Interaktionsdaten abzurufen, einschließlich Benutzeraufforderungen zu Copilot- und Copilot-Antworten.
Teamarbeit und Kommunikation | Anrufe und Onlinebesprechungen
- Verknüpfen Sie externe Ereignisinformationen mit einem virtualEventTownhall oder virtualEventWebinar , indem Sie eine externalEventId festlegen.
- Verwenden Sie externalEventInformation für virtualEventTownhall und virtualEventWebinar , um die externen Ereignisinformationen eines virtuellen Ereignisses zu identifizieren.
- Verwenden Sie die allowedLobbyAdmitters-Eigenschaft in onlineMeeting , um die Benutzer abzurufen oder festzulegen, die die Zulassung aus dem Wartebereich zulassen können.
- Verwenden Sie die allowedLobbyAdmitters-Eigenschaft in onlineMeeting , um die Benutzer abzurufen oder festzulegen, die die Zulassung aus dem Wartebereich zulassen können.
- Ruft ab oder legt fest, ob Benutzer von Microsoft 365 Copilot in Teams Besprechungen Antworten auf stimmungsbezogene Eingabeaufforderungen erhalten können.
Oktober 2024: Neu und allgemein verfügbar
Sicherungsspeicher
Die Endpunkte der folgenden Methoden wurden aktualisiert:
- DriveProtectionUnits auflisten
- Auflisten von mailboxProtectionUnits
- Auflisten von siteProtectionUnits
Benachrichtigungen ändern
Der Abfrageparameter wurde als Wert der Ressourceneigenschaft in der Abonnementressource aktiviert$notifyOnUserSpecificProperties
. Sie können den parameter notifyOnUserSpecificProperties verwenden, wenn Sie Benachrichtigungen in einem bestimmten Chat abonnieren.
Identität und Zugriff | Verzeichnisverwaltung
- Ruft die Stammdomäne einer Unterdomäne ab.
- Es wurden Empfehlungen zur Verwendung einheitlicher RBAC-APIs in unifiedRoleDefinition anstelle von directoryRole und directoryRoleTemplate hinzugefügt.
- Verwenden Sie die membershipRule-Eigenschaft für administrativeUnit , um die dynamische Mitgliedschaftsregel für eine Verwaltungseinheit abzurufen oder festzulegen.
- Verwenden Sie die membershipRuleProcessingState-Eigenschaft für administrativeUnit , um anzugeben, ob die dynamische Mitgliedschaftsregel aktiv verarbeitet wird.
- Verwenden Sie die membershipType-Eigenschaft für administrativeUnit , um den Mitgliedschaftstyp für eine Verwaltungseinheit abzurufen oder festzulegen.
Sicherheit | eDiscovery
- Das Löschen von Exchange-Postfachelementen in der ediscoverySearch: purgeData-Methode aktiviert.
- Das Element wurde aus der purgeType-Enumeration zugunsten des
permanentlyDelete
Elements gelöschtpermanentlyDeleted
. - Exportieren sie Ergebnisse und einen Bericht aus einer ediscoverySearch.
- Gesetzliche Haltebereiche sind Haltebereiche, die an einen eDiscovery-Fall gebunden sind. Weitere Informationen zu einer Aufbewahrungsrichtlinie für juristische Zwecke und den unterstützten Methoden finden Sie unter ediscoveryHoldPolicy.
Teamarbeit und Kommunikation | Apps
Verwenden Sie die clientAppId-Eigenschaft in teamsAppAuthorization, um die Registrierungs-ID der Microsoft Entra App-ID abzurufen, die einer App im Microsoft Teams-App-Katalog zugeordnet ist.
Teamarbeit und Kommunikation | Anrufe und Onlinebesprechungen
Verwenden Sie die isDeltaRosterEnabled-Eigenschaft für incomingCallOptions und outgoingCallOptions , um anzugeben, ob die Deltaliste für einen Anruf aktiviert ist.
Teamarbeit und Kommunikation | Messaging
- Die chatMessage: delta-Methode wurde aktualisiert, um einen neuen Endpunkt zu verwenden, der die Liste der Deltanachrichten aus allen Chats abruft, an denen ein Benutzer beteiligt ist, einschließlich Einzelchats, Gruppenchats und Besprechungschats.
- Verwenden Sie die eigenschaft reactionContentUrl für chatMessageReaction , um die URL des gehosteten Inhalts für eine benutzerdefinierte Reaktion in einer chatMessage darzustellen.
- Verwenden Sie das
<customemoji></customemoji>
Tag für die inhaltseigenschaft der itemBody-Ressource , um benutzerdefinierte Emojis im Nachrichtentext in einer chatMessage darzustellen. - Verwenden Sie die displayName-Eigenschaft für chatMessageReaction , um den Reaktionsnamen in einer chatMessage darzustellen.
Oktober 2024: Neu nur in der Vorschau
Sicherungsspeicher
Neue Endpunkte zum Massenhinzufügen von Schutzeinheiten zu einer Schutzrichtlinie hinzugefügt:
Die Endpunkte der folgenden Methoden wurden aktualisiert:
- DriveProtectionUnits auflisten
- Auflisten von mailboxProtectionUnits
- Auflisten von siteProtectionUnits
Geräte- und App-Verwaltung | Cloudlizenzierung
- Verwenden Sie die neue Cloudlizenzierungsentität usageRight , die für Client- und Workloadlizenzüberprüfungen konzipiert ist, mit Beziehungen, die so strukturiert sind, dass sie vom Benutzer oder der Gruppe zu usageRight fließen. Diese neue Entität unterstützt die folgenden Vorgänge:
- Verwenden Sie die cloudLicensing-Eigenschaft für eine Gruppe oder einen Benutzer , um deren Beziehungen zu Cloudlizenzressourcen abzurufen.
Geräte- und App-Verwaltung | Cloud-PC
- Der Abfrageparameter für die methode cloudPC: getProvisionedCloudPCs wurde aktiviert
$select
. - Verwenden Sie die notificationSetting-Eigenschaft für cloudPcUserSetting , um die Cloud-PC-Benachrichtigungsaufforderungen für einen Cloud-PC-Benutzer zu definieren.
- Das Element in der
cloudPcFrontlineBufferUsageScenario
alertRuleTemplate-Enumeration wurde aktiviert. - Die Member und
frontlineBufferUsageThreshold
in derfrontlineBufferUsageDuration
ruleCondition-Enumeration wurden aktiviert.
Identität und Zugriff | Verzeichnisverwaltung
Rufen Sie das uxSetting ab, das den Zugriff auf Microsoft Entra Admin Center nur auf Administratoren beschränkt, oder aktualisieren Sie es.
Identität und Zugriff | Identität und Anmeldung
Aktiviert suspiciousAPITraffic
als unterstützter Wert für die riskEventType-Eigenschaft in der servicePrincipalRiskDetection-Ressource . Sie können diesen Wert abrufen, wenn Sie entweder die APIs list servicePrincipalRiskDetections oder Get servicePrincipalRiskDetection verwenden.
Berichte | Identitäts- und Zugriffsberichte
Mit den APIs für Microsoft Entra Integritätsüberwachung können Sie anomale Verwendungsmuster in unternehmenskritischen Identitätsszenarien für Ihren Mandanten erkennen und Warnungsbenachrichtigungen empfangen. Verwenden Sie die Vorgänge der Ressourcen alert und alertConfiguration , um Warnungen und Warnungskonfigurationen abzurufen und zu aktualisieren. Weitere Informationen finden Sie im entsprechenden Änderungsprotokollabschnitt.
Sicherheit | eDiscovery
- Das Löschen von Exchange-Postfachelementen in der ediscoverySearch: purgeData-Methode aktiviert.
- Das Element wurde aus der purgeType-Enumeration zugunsten des
permanentlyDelete
Elements gelöschtpermanentlyDeleted
.
Websites und Listen
Die Endpunkte der folgenden Methoden wurden aktualisiert:
Teamarbeit und Kommunikation | Anrufe und Onlinebesprechungen
- Verwenden Sie die eigenschaft externalRegistrationInformation für virtualEventRegistration , um die externen Informationen für eine virtuelle Ereignisregistrierung abzurufen oder festzulegen.
- Verwenden Sie die folgenden neuen Methoden für virtuelle Ereignisse vom Typ virtualEventTownhall :
- Listet alle virtuellen Event-Rathäuser auf, die in einem Mandanten erstellt wurden.
- Rufen Sie die virtuellen Event-Rathäuser ab, in denen ein angegebener Benutzer ein Organisator oder Co-Organisator ist.
- Rufen Sie die virtuellen Event-Rathäuser ab, in denen der angemeldete Benutzer ein Organisator oder Co-Organisator ist.
Teamarbeit und Kommunikation | Messaging
- Die chatMessage: delta-Methode wurde aktualisiert, um einen neuen Endpunkt zu verwenden, der die Liste der Deltanachrichten aus allen Chats abruft, an denen ein Benutzer beteiligt ist, einschließlich Einzelchats, Gruppenchats und Besprechungschats.
- Rufen Sie eine Chatnachricht ab, die eine weitergeleitete Nachricht als Anlage enthält.
- Entfernen mehrerer Mitglieder aus einem Team in einer einzigen Anforderung.
Benutzer
Die folgenden lokalen synchronisierten Eigenschaften des Benutzerressourcentyps, die in Microsoft Graph schreibgeschützt waren, wurden so geändert, dass sie über Microsoft Graph aktualisiert werden können:
- onPremisesDistinguishedName
- onPremisesDomainName
- onPremisesSamAccountName
- onPremisesSecurityIdentifier
- onPremisesUserPrincipalName
Mitwirken an Microsoft Graph
Gibt es Szenarien, die von Microsoft Graph unterstützt werden sollen?
Über das Microsoft Graph-Feedbackportal können Sie neue Features vorschlagen und abstimmen. Einige neue Funktionen sind aus beliebten Anfragen der Entwicklercommunity entstanden. Das Microsoft Graph-Team wertet die Kundenanforderungen regelmäßig aus und veröffentlicht neue Features für die Beta-Endpunkte (
https://graph.microsoft.com/beta
) und v1.0 (https://graph.microsoft.com/v1.0
).Nehmen Sie am wöchentlichen Communityanruf der Microsoft 365-Plattform teil, und werden Sie ein aktives Mitglied der Microsoft Graph-Community. Den vollständigen Kalender der Entwickleranrufe finden Sie auf der Microsoft 365- und Power Platform-Communityseite.
Nehmen Sie an unserem Forschungspanel teil, um Ihren Beitrag zu unseren Entwicklererfahrungen zu liefern.