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.
Oktober 2024: Neu und allgemein verfügbar
Sicherungsspeicher
Die Endpunkte der folgenden Methoden wurden aktualisiert:
- DriveProtectionUnits auflisten
- Auflisten von mailboxProtectionUnits
- Auflisten von siteProtectionUnits
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.
Sicherheit | eDiscovery
- Das Löschen von Exchange-Postfachelementen in der ediscoverySearch: purgeData-Methode aktiviert.
- Das Element wurde aus der purgeType-Enumeration zugunsten des
permanentlyDeleteElements gelöschtpermanentlyDeleted.
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 | 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.
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 | 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.
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
permanentlyDeleteElements gelöschtpermanentlyDeleted.
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.
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.
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.
- 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
September 2024: Neu und allgemein verfügbar
Benachrichtigungen ändern
Angekündigt, dass Shared Access Signatures (SAS) für die Authentifizierung von Event Hubs für Microsoft Graph-Änderungsbenachrichtigungen veraltet sind. Es wird empfohlen, stattdessen Microsoft Entra ID rollenbasierte Zugriffssteuerung (Role-Based Access Control, RBAC) zu verwenden. Befolgen Sie die Anleitung zum Migrieren zu RBAC.
Identität und Zugriff | Verzeichnisverwaltung
Die zuvor als veraltet gekennzeichnete Directory.Write.Restricted Berechtigung wurde aus den Geräte-, Gruppen- und Benutzerressourcen entfernt.
Sicherheit | Warnungen und Vorfälle
- Verwenden Sie die dnsDomain-Eigenschaft auf deviceEvidence , um die DNS-Domäne abzurufen, zu der ein Computer gehört.
- Verwenden Sie die hostName-Eigenschaft auf deviceEvidence , um den Hostnamen ohne das Domänensuffix abzurufen.
- Verwenden Sie die ntDomain-Eigenschaft auf deviceEvidence , um eine logische Gruppierung von Computern in einem Microsoft Windows-Netzwerk abzurufen.
Sicherheit | Identitäten
Es wurde die Möglichkeit hinzugefügt, Microsoft Defender for Identity Integritätsproblemeabzurufen, aufzulisten und zu aktualisieren, die potenzielle Probleme darstellen, die in der Defender for Identity-Konfiguration eines Kunden identifiziert wurden.
Teamarbeit und Kommunikation | Messaging
- Abrufen aller beibehaltenen Nachrichten über alle Kanäle in einem Team.
- Abrufen aller beibehaltenen Nachrichten aus allen Chats , an denen ein Benutzer beteiligt ist, einschließlich Einzelchats, Gruppenchats und Besprechungschats.
September 2024: Neu nur in der Vorschau
Anwendungen | Dienstprinzipal
Verwenden Sie die optionale Eigenschaft serviceManagementReference in der applicationTemplate: instanziieren-Methode , um die Dienststruktur-ID für einen Dienst festzulegen.
Geräte- und App-Verwaltung | Cloud-PC
- Aktiviert die
middleEastMember undmexicoals unterstützte Regionen in der cloudPcRegionGroup-Enumeration . - Die getShiftWorkCloudPcAccessState-Methode wurde aus der cloudPC-Ressource entfernt. Verwenden Sie in Zukunft die getFrontlineCloudPcAccessState-API .
- Verwenden Sie die autopilotConfiguration-Eigenschaft in cloudPcProvisioningPolicy, um die Einstellungen für Windows Autopilot abzurufen oder festzulegen, die es Windows 365 Kunden ermöglichen, dies auf Einem Cloud-PC zu erleben.
- Verwenden Sie die eigenschaft osVersionNumber für cloudPcDeviceImage - und cloudPcGalleryImage-Ressourcen , um die Betriebssystemversion eines Images abzurufen.
- Die methode retrieveSnapshots für die cloudPC-Ressource wurde eingeführt, damit Sie eine Liste aller Momentaufnahmen eines Cloud-PCs zurückgeben können.
Die folgenden Methoden wurden als veraltet gekennzeichnet:
- bulkSetReviewStatus; Verwenden Sie stattdessen die Ressource cloudPcBulkSetReviewStatus und die unterstützten APIs.
- Auflisten von Momentaufnahmen; Verwenden Sie stattdessen die ressource retrieveSnapshots und die zugehörigen unterstützten APIs.
Dateien
- Aktualisieren Sie die Papierkorbeinstellungen für einen fileStorageContainer.
- Verwenden Sie die
$skipAbfrageparameter ,$top,$orderBy,$filterundincludeAllContainerUsers, um die Antwort des Vorgangs Berechtigungen auflisten anzupassen. - Schließen Sie den gesamten Versionsverlauf ein, wenn Sie ein Laufwerkselement kopieren. Der Versionsverlauf ist bis zum Einstellungslimit der Zielversion enthalten.
Identität und Zugriff | Verzeichnisverwaltung
Verwenden Sie die passwordResetUri-Eigenschaft für internalDomainFederation , um den URI abzurufen oder festzulegen, an den Clients zum Zurücksetzen ihres Kennworts umgeleitet werden.
Identität und Zugriff | Identität und Anmeldung
- Verwenden Sie die identifierUris-Eigenschaft in den Get- und Update-Vorgängen der Ressource tenantAppManagementPolicy , um Einschränkungen für anfällige oder leicht kompromittierte Bezeichner-URI-Formate für eine Anwendung abzurufen oder festzulegen.
- Der Rückgabetyp für die applicationRestrictions-Eigenschaft der Ressource tenantAppManagementPolicy wurde von appManagementConfiguration in appManagementApplicationConfiguration aktualisiert.
- Der Rückgabetyp für die servicePrincipalRestrictions-Eigenschaft der Ressource tenantAppManagementPolicy wurde von appManagementConfiguration in appManagementServicePrincipalConfiguration aktualisiert.
- Der Rückgabetyp für die restrictions-Eigenschaft der appManagementPolicy-Ressource wurde von appManagementConfiguration in customAppManagementConfiguration aktualisiert.
Berichte | Microsoft 365-Verwendungsberichte
- Ruft die neuesten Aktivitätsdaten für aktivierte Benutzer von Microsoft 365 Copilot-Apps ab.
- Ruft die aggregierte Anzahl der aktiven und aktivierten Benutzer von Microsoft 365 Copilot für einen angegebenen Zeitraum ab.
- Rufen Sie den Trend bei der täglichen Anzahl der aktiven und aktivierten Benutzer von Microsoft 365 Copilot für einen angegebenen Zeitraum ab.
Sicherheit | Warnungen und Vorfälle
- Verwenden Sie die dnsDomain-Eigenschaft auf deviceEvidence , um die DNS-Domäne abzurufen, zu der ein Computer gehört.
- Verwenden Sie die hostName-Eigenschaft auf deviceEvidence , um den Hostnamen ohne das Domänensuffix abzurufen.
- Verwenden Sie die ntDomain-Eigenschaft auf deviceEvidence , um eine logische Gruppierung von Computern in einem Microsoft Windows-Netzwerk abzurufen.
Sicherheit | Identitäten
- Generieren Sie einen neuen Bereitstellungszugriffsschlüssel.
- Rufen Sie den bereitstellungszugriffsschlüssel ab, der einem Microsoft Defender for Identity zugeordnet ist.
- Abrufen des Sensorbereitstellungspakets URL und Version.
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.
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.