user-Ressourcentyp

Namespace: microsoft.graph

Stellt ein Microsoft Entra-Benutzerkonto dar. Diese Ressource ist ein offener Typ, der über die hier dokumentierten hinaus zusätzliche Eigenschaften zulässt. Erbt von directoryObject. In Version 1.0 wird standardmäßig nur eine Teilmenge der Benutzereigenschaften zurückgegeben. Um andere Eigenschaften abzurufen, müssen Sie sie in einer $select Abfrageoption angeben.

Diese Ressource unterstützt Folgendes:

Methoden

Methode Rückgabetyp Beschreibung
List Benutzersammlung Dient zum Abrufen einer Liste von Benutzerobjekten.
Create Benutzer Dient zum Erstellen eines neuen Benutzerobjekts.
Get user Liest Eigenschaften und Beziehungen des Benutzerobjekts.
Update user Aktualisiert das Benutzerobjekt.
Löschen None Löscht das Benutzerobjekt.
Delta abrufen Benutzersammlung Dient zum Abrufen inkrementeller Änderungen für Benutzer.
Kennwort ändern Keine Aktualisieren Sie Ihr eigenes Kennwort.
Dienstbereitstellung wiederholen Keine Versuchen Sie erneut, den Benutzerdienst bereitzustellen.
Anmeldesitzungen widerrufen Keine Entzieht alle Aktualisierungs- und Sitzungstoken, die für Anwendungen ausgegeben wurden, indem die Benutzereigenschaft signInSessionsValidFromDateTime auf das aktuelle Datum und die aktuelle Zeit eingestellt werden. Der Benutzer muss sich erneut bei diesen Anwendungen anmelden.
Persönliche Daten exportieren Keine Übermittelt eine von einem Unternehmensadministrator gesendete Anforderung eines Datenrichtlinienvorgangs zum Exportieren der Daten eines Organisationsbenutzers.
App-Rollenzuweisungen
List appRoleAssignment-Auflistung Rufen Sie die Apps und App-Rollen ab, die diesem Benutzer zugewiesen sind.
Add appRoleAssignment Weisen Sie diesem Benutzer eine App-Rolle zu.
Remove Keine Entfernen Sie eine App-Rollenzuweisung von diesem Benutzer.
Calendar
List calendars calender-Sammlung Ruft eine Kalenderobjektsammlung ab.
Create calendar Calendar Erstellt einen neuen Kalender durch Veröffentlichung in der Kalendersammlung.
Kalendergruppen auflisten calendarGroup-Sammlung Ruft eine CalendarGroup-Objektsammlung ab.
Kalendergruppe erstellen CalendarGroup Erstellt eine neue CalendarGroup durch Veröffentlichung in der CalendarGroups-Sammlung.
Ereignisse auflisten event-Sammlung Ruft eine Liste der event-Objekte im Postfach des Benutzers ab. Die Liste enthält einzelne Instanzen von Besprechungen und Serienmaster.
Ereignis erstellen Ereignis Erstellt ein neues Ereignis durch Veröffentlichen in der Ereignissammlung.
Besprechungszeiten suchen meetingTimeSuggestionsResult Sucht Zeiten und Orte für Besprechungen basierend auf der Teilnehmerverfügbarkeit, dem Standort oder zeitlichen Einschränkungen.
Frei-/Gebucht-Zeitplan abrufen scheduleInformation Abrufen der Informationen zur Frei/Gebucht-Verfügbarkeit für eine Sammlung von Benutzern, Verteilerlisten oder Ressourcen (Räume oder Geräte) für einen angegebenen Zeitraum.
Kalenderansicht auflisten event-Sammlung Ruft eine Ereignisobjektsammlung ab.
Erinnerungsansicht Reminder collection Gibt eine Liste von Kalendererinnerungen innerhalb der angegebenen Start- und Endzeiten zurück.
Cloud-PC
Cloud-PCs auflisten cloudPC-Sammlung Listen Sie die cloudPC-Geräte auf, die dem angemeldeten Benutzer zugeordnet sind.
Datensicherheit und Governance
Schutzbereiche für Compute policyUserScope-Sammlung Berechnen Sie die Schutzbereiche für den angemeldeten Benutzer.
Aktivität zum Erstellen von Inhalten contentActivity Erstellen Sie eine Inhaltsaktivität für den angemeldeten Benutzer.
Inhalte verarbeiten processContentResponse Verarbeiten von Inhalten anhand von Datenschutzrichtlinien im Kontext des angemeldeten Benutzers.
Gewähren delegierter Genehmigungen
Auflisten delegierter Berechtigungserteilungen oAuth2PermissionGrant-Auflistung Rufen Sie eine Liste der delegierten Berechtigungen ab, die einer Clientanwendung erteilt wurden, um den Zugriff auf eine API im Namen des Benutzers zu ermöglichen.
Verzeichnisobjekte
Abrufen nach IDs String collection Gibt die in einer Liste von IDs angegebenen Verzeichnisobjekte zurück.
Abrufen des Deltas für das Verzeichnisobjekt directoryObject collection Abrufen inkrementeller Änderungen für Verzeichnisobjekte wie Benutzer, Gruppen, Anwendungen und Dienstprinzipale. Die Filterung ist entweder nach der ID des abgeleiteten Typs oder nach dem abgeleiteten Typ selbst erforderlich. Weitere Informationen zu Deltaabfragen finden Sie unter Verwenden von Deltaabfragen zum Nachverfolgen von Änderungen in Microsoft Graph-Daten.
Mitgliedergruppen prüfen String collection Sucht nach einer Mitgliedschaft in einer Liste von Gruppen. Die Überprüfung ist transitiv.
Mitgliedergruppen abrufen String collection Gibt alle Gruppen zurück, bei denen der Benutzer Mitglied ist. Die Überprüfung ist transitiv.
Überprüfen von Mitgliederobjekten String-Sammlung Überprüfen Sie die Mitgliedschaft in einer Liste von Gruppen, Verzeichnis-Rollen oder Verwaltungsobjekten. Die Funktion ist transitiv.
Mitgliedsobjekte abrufen String-Sammlung Gibt alle Gruppen, Verwaltungseinheiten und Verzeichnisrollen zurück, in denen der Benutzer Mitglied ist. Die Überprüfung ist transitiv.
Erstellte Objekte auflisten directoryObject collection Ruft die Verzeichnisobjekte, die von dem Benutzer erstellt wurden, aus der createdObjects-Navigationseigenschaft ab.
Geräte im Besitz auflisten directoryObject collection Rufen Sie die Geräte, die der Benutzer besitzt, aus der Navigationseigenschaft ownedDevices ab.
Objekte im Besitz auflisten directoryObject collection Rufen Sie die Verzeichnisobjekte ab, die dem Benutzer gehören, aus der Navigationseigenschaft ownedObjects.
Auflisten der gelöschten Gruppen im Besitz eines Benutzers directoryObject-Sammlung Rufen Sie die Gruppen ab, die in den letzten 30 Tagen im Mandanten gelöscht wurden und die sich im Besitz eines Benutzers befinden.
Registrierte Geräte auflisten directoryObject-Sammlung Ruft die Geräte, die für den Benutzer registriert sind, aus der registeredDevices-Navigationseigenschaft ab.
Gelöschte Elemente auflisten directoryObject-Sammlung Rufen Sie die Benutzer ab, die in den letzten 30 Tagen im Mandanten gelöscht wurden.
Gelöschtes Element abrufen directoryObject-Sammlung Rufen Sie einen gelöschten Benutzer nach ID ab.
Gelöschtes Element wiederherstellen directoryObject-Sammlung Stellen Sie einen Benutzer wieder her, der in den letzten 30 Tagen im Mandanten gelöscht wurde.
Element endgültig löschen directoryObject-Sammlung Löschen Sie einen gelöschten Benutzer dauerhaft aus dem Mandanten.
Laufwerk
Get drive (Laufwerk abrufen) drive Dient zum Abrufen der Eigenschaften und der Beziehungen einer Laufwerkressource.
Untergeordnete Elemente auflisten DriveItems Gibt eine Sammlung von DriveItems im untergeordneten Verhältnis eines DriveItem zurück.
Mitarbeitererfahrung
Auflisten zugewiesener Rollen engagementRollensammlung Rufen Sie eine Liste aller Rollen ab, die einem Benutzer in Viva Engage zugewiesen sind.
Gruppen
Verknüpfte Teams auflisten team-Sammlung Ruft die Microsoft Teams-Teams aus der joinedTeams-Navigationseigenschaft auf, bei denen dieser Benutzer direktes Mitglied ist.
memberOf auflisten directoryObject collection Ruft die Gruppen, Verzeichnisrollen und administrativen Einheiten ab, bei denen der Benutzer ein direktes Mitglied ist. Dieser Vorgang ist nicht transitiv.
Auflisten transitiver Mitglieder von directoryObject-Sammlung Ruft die Gruppen, Verzeichnisrollen und administrativen Einheiten ab, bei denen der Benutzer Mitglied ist, entweder über eine direkte oder eine transitive Mitgliedschaft.
Einblicke
Trends auflisten trending-Sammlung Rufen Sie eine Liste der beliebten Dateien ab.
Abrufen von Inhaltsermittlungseinstellungen userSettings Rufen Sie die Einstellungen für die Inhaltsermittlung der Benutzer ab.
Aktualisieren der Einstellungen für die Inhaltsermittlung Keine Aktualisieren Sie die Einstellungen für die Inhaltsermittlung der Benutzer.
Liste freigegeben (veraltet) sharedInsight-Sammlung Rufen Sie eine Liste der freigegebenen Dateien ab. Diese API ist veraltet und gibt nach November 2026 keine Daten mehr zurück.
Liste verwendet (veraltet) UsedInsight-Sammlung Rufen Sie eine Liste der verwendeten Dateien ab. Diese API ist veraltet und gibt nach November 2026 keine Daten mehr zurück.
Lizenzverwaltung
Lizenz zuweisen user Hinzufügen oder Entfernen von Abonnements für den Benutzer. Sie können auch einzelne Pläne aktivieren oder deaktivieren, die einem Abonnement zugeordnet sind.
Lizenzdetails auflisten licenseDetails-Sammlung Dient zum Abrufen einer licenseDetails-Objektsammlung.
Lizenzzuweisung erneut verarbeiten user Dient zum erneuten Verarbeiten von Abonnementzuweisungen für den Benutzer.
Nachricht
Mail-Ordner auflisten mailFolder-Sammlung Ruft die E-Mail-Ordner-Sammlung unter dem Stammordner des angemeldeten Benutzers ab.
E-Mail-Ordner erstellen mailFolder Erstellt einen neuen MailFolder durch Veröffentlichung in der mailFolders-Sammlung.
Nachrichten auflisten message-Sammlung Ruft alle Nachrichten im Postfach des angemeldeten Benutzers ab.
Nachricht erstellen meldung Erstellt eine neue Nachricht durch Veröffentlichung in der Nachrichtensammlung.
Außerkraftsetzungen auflisten inferenceClassificationOverride-Sammlung Rufen Sie die Außerkraftsetzungen des Posteingangs mit Relevanz ab, die ein Benutzer konfiguriert hat, um Nachrichten von bestimmten Absendern immer auf bestimmte Weise zu klassifizieren.
Außerkraftsetzung erstellen inferenceClassificationOverride Erstellt eine Außerkraftsetzung des Posteingangs mit Relevanz für einen Absender, der durch eine SMTP-Adresse identifiziert wird.
Auflisten von Regeln messageRule-Sammlung Ruft alle messageRule-Objekte ab, die für das Postfach des Benutzers definiert sind.
Regel erstellen messageRule Erstellt ein messageRule-Objekt durch Angeben einer Gruppe von Bedingungen und Aktionen.
Nachricht senden Keine Sendet die im Anforderungstext angegebene Nachricht.
Abrufen von E-Mail-Tipps mailTips-Sammlung Geben Sie die MailTips für einen oder mehrere Empfänger als verfügbar für den angemeldeten Benutzer zurück.
Notizen auflisten Notizsammlung Rufen Sie eine Liste der Notizobjekte im Ordner "Notizen " des Benutzers ab.
Notiz erstellen Hinweis Erstellen Sie eine neue Notiz im Ordner "Notizen " des Benutzers.
Hinweise
Notizbücher auflisten Notizbuchsammlung Ruft eine Liste von Notizbuchobjekten ab.
Notizbuch erstellen Notizbuch Mit dieser API können Sie eine neue OneNote-Ressource des Typs "notebook" erstellen.
Organisationshierarchie
Manager zuweisen directoryObject Weist diesem Benutzer einen Benutzer oder einen Organisationskontakt als Manager zu.
Manager abrufen directoryObject Ruft den Benutzer oder Organisationskontakt, der Manager dieses Benutzers ist, aus der manager-Navigationseigenschaft ab.
Manager entfernen Keine Entfernen des Vorgesetzten eines Benutzers.
Mitarbeiter auflisten directoryObject collection Ruft die Benutzer und Kontakte, die an den Benutzer berichten, aus der directReports-Navigationseigenschaft ab.
Outlook-Einstellungen
Postfacheinstellungen des Benutzers abrufen mailboxSettings Ruft die Postfacheinstellungen des Benutzers ab.
Benutzerpostfacheinstellungen aktualisieren mailboxSettings Aktivieren, Konfigurieren oder Deaktivieren einer oder mehrerer Postfacheinstellungen für einen Benutzer.
Outlook-Kategorien auflisten outlookCategory-Sammlung Rufen Sie alle für den Benutzer definierten Kategorien ab.
Outlook-Kategorie erstellen outlookCategory Erstellt ein outlookCategory-Objekts in der Masterliste von Kategorien.
Abrufen unterstützter Sprachen localeInfo-Sammlung Dient zum Abrufen der Liste von Gebietsschemas und Sprachen, die für den Benutzer unterstützt werden, wie auf dem Postfachserver des Benutzers konfiguriert.
Abrufen unterstützter Zeitzonen timeZoneInformation-Sammlung Dient zum Abrufen der Liste von Zeitzonen, die für den Benutzer unterstützt werden, wie auf dem Postfachserver des Benutzers konfiguriert.
Übersetzen von Exchange-IDs convertIdResult-Sammlung Übersetzt IDs von Outlook-bezogenen Ressourcen zwischen den Formaten.
Personen
List person-Sammlung Dient zum Abrufen einer Sammlung von person-Objekten, sortiert nach ihrer Relevanz für den Benutzer.
Private Kontakte
Auflisten von Kontakten contact-Sammlung Ruft eine Kontaktsammlung aus dem Standardkontaktordner des angemeldeten Benutzers ab.
Kontakt erstellen contact Erstellt einen neuen Kontakt durch Veröffentlichung in der Kontaktsesammlung.
Kontaktordner auflisten contactFolder-Sammlung Ruft die Kontaktordnersammlung im Standardkontaktordner des angemeldeten Benutzers ab.
Kontaktordner erstellen contactFolder Erstellt einen neuen ContactFolder durch Veröffentlichung in der ContactFolders-Sammlung.
Profilfoto
Get profilePhoto Ruft das angegebene profilePhoto-Objekt oder dessen Metadaten (profilePhoto-Eigenschaften) ab.
Update Keine Aktualisiert das Foto für einen beliebigen Benutzer im Mandanten, einschließlich des angemeldeten Benutzers, der angegebenen Gruppe oder des angegebenen Kontakts.
Löschen Keine Löschen Sie das Foto für einen beliebigen Benutzer im Mandanten, einschließlich des angemeldeten Benutzers oder der angegebenen Gruppe.
Planner
Aufgaben auflisten plannerTask-Sammlung Gibt die dem Benutzer zugewiesenen plannerTasks zurück.
Sponsoren
Assign Keine Zuweisen eines Sponsors für einen Benutzer
List directoryObject collection Rufen Sie die Benutzer und Gruppen ab, die die Sponsoren dieses Benutzers sind.
SponsorOf auflisten directoryObject collection Rufen Sie die Verzeichnisobjekte ab, die dieser Benutzer sponsert.
Remove Keine Entfernen Sie den Sponsor eines Benutzers.
Teamwork
Zugeordnete Teams auflisten associatedTeamInfoAuflistung Rufen Sie die Liste der Teams in Microsoft Teams ab, denen ein Benutzer zugeordnet ist.
Für Benutzer installierte Apps auflisten userScopeTeamsAppInstallation-Sammlung Listet die Apps auf, die im persönlichen Bereich eines Benutzers installiert sind.
Ruft die installierte App für den Benutzer ab userScopeTeamsAppInstallation Listet die angegebene Anwendung auf, die im persönlichen Bereich eines Benutzers installiert ist.
App für Benutzer hinzufügen Keine Fügt (installiert) eine App im persönlichen Bereich eines Benutzers hinzu.
App für Benutzer entfernen Keine Entfernt (deinstalliert) eine App im persönlichen Bereich eines Benutzers.
Für Benutzer installierte Apps aktualisieren Keine Aktuallisiert auf die neueste Version der App, die im persönlichen Bereich eines Benutzers installiert ist.
Chat zwischen Benutzer und App erhalten Chat Listet eins-zu-eins-Chat zwischen dem Benutzer und der App auf.
Berechtigungserteilungen auflisten resourceSpecificPermissionGrant-Sammlung Listen Sie alle ressourcenspezifischen Berechtigungszuweisungen eines Benutzers auf.
Nutzungsbedingungen
Zustimmung zu einer Vereinbarung für einen Benutzer agreementAcceptance Abrufen der agreementAcceptance-Objekte eines Benutzers.
To Do-Aufgaben
Aufgaben auflisten todoTask-Sammlung Rufen Sie alle todoTask-Ressourcen in der angegebenen Liste ab.
Aufgabe erstellen todoTask Erstellen Sie in der angegebenen Aufgabenliste ein todoTask-Element.
Aufgabenlisten auflisten todoTaskList-Auflistung Rufen Sie alle Aufgabenlisten im Postfach des Benutzers ab.
Aufgabenliste erstellen todoTaskList Erstellen Sie eine To Do-Aufgabenliste im Postfach des Benutzers.
Benutzereinstellungen
Get userSettings Liest das Einstellungenobjekt für den Benutzer und die Organisation.
Update userSettings Dient zum Aktualisieren der Eigenschaften des Einstellungenobjekts.

Eigenschaften

Wichtig

Die spezifische Verwendung von $filter und des Abfrageparameters $search wird nur unterstützt, wenn Sie die Kopfzeile ConsistencyLevel verwenden, die auf eventual und $count festgelegt ist. Weitere Informationen finden Sie unter Erweiterte Abfragefunktionen für Verzeichnisobjekte.

Eigenschaft Typ Beschreibung
aboutMe String Ein Freihandform-Texteingabefeld, in dem der Benutzer sich selbst beschreiben kann. Erfordert $select zum Abrufen.
accountEnabled Boolesch true, wenn das Konto aktiviert ist; andernfalls false. Diese Eigenschaft ist erforderlich, wenn ein Benutzer erstellt wird.

Erfordert $select zum Abrufen. Unterstützt $filter (eq, ne, not und in).

Diese Immobilie unterliegt Einschränkungen für sensible Aktionen. Nur bestimmte privilegierte Administratorrollen können sie aktualisieren.
ageGroup ageGroup Legt die Altersgruppe des Benutzers fest. Zulässige Werte: null, Minor, NotAdultund Adult. Weitere Informationen finden Sie unter Definitionen von Altersgruppeneigenschaften.

Erfordert $select zum Abrufen. Unterstützt $filter (eq, ne, not und in).
assignedLicenses assignedLicense collection Die Lizenzen, die dem Benutzer zugewiesen sind, einschließlich geerbte (gruppenbasierte) Lizenzen. Diese Eigenschaft unterscheidet nicht zwischen direkt zugewiesenen und geerbten Lizenzen. Verwenden Sie die licenseAssignmentStates-Eigenschaft , um die direkt zugewiesenen und geerbten Lizenzen zu identifizieren. Lässt keine NULL-Werte zu. Erfordert $select zum Abrufen. Unterstützt $filter (eq, not, /$count eq 0, /$count ne 0).
assignedPlans assignedPlan collection Die Pläne, die dem Benutzer zugewiesen sind. Schreibgeschützt. Lässt keine NULL-Werte zu.

Erfordert $select zum Abrufen. Unterstützt $filter (eq und not).
birthday DateTimeOffset Der Geburtstag des Benutzers. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und wird immer in UTC angegeben. Zum Beispiel ist Mitternacht UTC am 1. Januar 2014 .2014-01-01T00:00:00Z

Erfordert $select zum Abrufen.
businessPhones String-Sammlung Die Telefonnummern für den Benutzer. HINWEIS: Obwohl es sich um eine Zeichenfolgensammlung handelt, kann für diese Eigenschaft nur eine Zahl festgelegt werden. Schreibgeschützt für Benutzer, die aus dem lokalen Verzeichnis synchronisiert werden.

Wird standardmäßig zurückgegeben. Unterstützt $filter (eq, not, ge, le, startsWith).

Diese Immobilie unterliegt Einschränkungen für sensible Aktionen. Nur bestimmte privilegierte Administratorrollen können sie aktualisieren.
Ort Zeichenfolge Die Stadt, in der sich der Benutzer befindet. Die maximale Länge beträgt 128 Zeichen.

Erfordert $select zum Abrufen. Unterstützt $filter (eq, ne, not, ge, le, in, startsWith und eq für null-Werte).
CompanyName String Der Name des Unternehmens, mit dem der Benutzer verbunden ist. Diese Eigenschaft kann nützlich sein, um das Unternehmen zu beschreiben, aus dem ein Gast kommt. Die Höchstlänge beträgt 64 Zeichen.

Erfordert $select zum Abrufen. Unterstützt $filter (eq, ne, not, ge, le, in, startsWith und eq für null-Werte).
consentProvidedForMinor consentProvidedForMinor Legt fest, ob die Zustimmung für Minderjährige eingeholt wurde. Zulässige Werte: null, Granted, Deniedund NotRequired. Weitere Informationen finden Sie unter Definitionen von Altersgruppeneigenschaften.

Erfordert $select zum Abrufen. Unterstützt $filter (eq, ne, not und in).
Land/Region Zeichenfolge Das Land oder die Region, in dem bzw. der sich der Benutzer befindet; beispielsweise US oder UK. Die maximale Länge beträgt 128 Zeichen.

Erfordert $select zum Abrufen. Unterstützt $filter (eq, ne, not, ge, le, in, startsWith und eq für null-Werte).
createdDateTime DateTimeOffset Das Datum und die Uhrzeit der Erstellung des Benutzers im ISO 8601-Format und UTC. Der Wert kann nicht geändert werden und wird automatisch aufgefüllt, wenn das Objekt erstellt wird. Nullwerte zulassend. Für lokale Benutzer stellt der Wert dar, wann sie zum ersten Mal in Microsoft Entra ID erstellt wurden. Die Eigenschaft gilt null für einige Benutzer, die vor Juni 2018 erstellt wurden, sowie für lokale Benutzer, die vor Juni 2018 mit Microsoft Entra ID synchronisiert wurden. Schreibgeschützt.

Erfordert $select zum Abrufen. Unterstützt $filter (eq, ne, not, ge, le, in).
creationType Zeichenfolge Gibt an, ob das Nutzerkonto mit einer der folgenden Methoden erstellt wurde:
  • Als reguläres Schul- oder Arbeitskonto (null).
  • Als externes Konto (Invitation).
  • Als lokales Konto für einen Azure Active Directory B2C-Mandanten (LocalAccount).
  • Durch Self-Service-Anmeldung eines internen Nutzers mit E-Mail-Bestätigung (EmailVerified).
  • Über die Self-Service-Registrierung eines Gastes, der sich über einen Link anmeldet, der Teil eines Benutzerflusses ist (SelfServiceSignUp).

Schreibgeschützt.
Erfordert $select zum Abrufen. Unterstützt $filter (eq, ne, not, in).
customSecurityAttributes customSecurityAttributeValue Ein offener komplexer Typ, der den Wert eines benutzerdefinierten Sicherheitsattributs enthält, das einem Verzeichnisobjekt zugewiesen ist. Lässt NULL-Werte zu.

Erfordert $select zum Abrufen. Unterstützt $filter (eq, ne, not, startsWith). Beim Filterwert wird die Groß-/Kleinschreibung beachtet.
  • Um diese Eigenschaft lesen zu können, muss der aufrufenden App die Berechtigung CustomSecAttributeAssignment.Read.All zugewiesen werden. Um diese Eigenschaft zu schreiben, muss der aufrufenden App die Berechtigung "CustomSecAttributeAssignment.ReadWrite.All" zugewiesen werden.
  • Um diese Eigenschaft in delegierten Szenarien lesen oder schreiben zu können, muss dem Administrator die Rolle des Attributzuweisungsadministrators zugewiesen werden.
    		•
    deletedDateTime DateTimeOffset Das Datum und die Zeit, zu dem der Benutzer gelöscht wurde.

    Erfordert $select zum Abrufen. Unterstützt $filter (eq, ne, not, ge, le, in).
    department Zeichenfolge Der Name der Abteilung, in der der Benutzer arbeitet. Die maximale Länge beträgt 64 Zeichen.

    Erfordert $select zum Abrufen. Unterstützt $filter (eq, ne, not , ge, le, in und eq für null-Werte).
    displayName Zeichenfolge Der Name des Benutzers, der im Adressbuch angezeigt wird. Dieser Wert ist in der Regel die Kombination aus Vorname, Mittelinitiale und Nachname des Benutzers. Diese Eigenschaft ist erforderlich, wenn ein Benutzer erstellt wird, und kann während Updates nicht gelöscht werden. Die maximale Länge beträgt 256 Zeichen.

    Wird standardmäßig zurückgegeben. Unterstützt $filter (eq, ne, not , ge, le, in, startsWith und eq für null-Werte), $orderby und $search.
    employeeHireDate DateTimeOffset Das Datum und die Uhrzeit, zu dem der Benutzer eingestellt wurde oder in einer zukünftigen Einstellung zu arbeiten beginnt.

    Erfordert $select zum Abrufen. Unterstützt $filter (eq, ne, not, ge, le, in).
    employeeLeaveDateTime DateTimeOffset Datum und Uhrzeit, wann der Benutzer die organization verlassen hat oder verlassen wird.
  • Um diese Eigenschaft lesen zu können, muss der aufrufenden App die Berechtigung User-LifeCycleInfo.Read.All zugewiesen werden. Um diese Eigenschaft zu schreiben, müssen der aufrufenden App die Berechtigungen User.Read.All und User-LifeCycleInfo.ReadWrite.All zugewiesen werden.
  • Um diese Eigenschaft in delegierten Szenarien lesen zu können, benötigt der Administrator mindestens eine der folgenden Microsoft Entra-Rollen: Administrator für Lebenszyklusworkflows (geringste Rechte), globaler Leser. Um diese Eigenschaft in delegierten Szenarien zu schreiben, benötigt der Administrator die Rolle Globaler Administrator .

    Unterstützt $filter (eq, ne, not, ge, le, in).

    Weitere Informationen finden Sie unter Konfigurieren der employeeLeaveDateTime-Eigenschaft für einen Benutzer.
    		•
    employeeId String Die Mitarbeiter-ID, die dem Benutzer von der Organisation zugewiesen wurde. Die maximale Länge beträgt 16 Zeichen.

    Erfordert $select zum Abrufen. Unterstützt $filter (eq, ne, not , ge, le, in, startsWith und eq für null-Werte).
    employeeOrgData employeeOrgData Stellt organization-Daten (z. B. Division und costCenter) dar, die einem Benutzer zugeordnet sind.

    Erfordert $select zum Abrufen. Unterstützt $filter (eq, ne, not, ge, le, in).
    employeeType Zeichenfolge Erfasst den Arbeitnehmertyp des Unternehmens. Zum Beispiel Employee, Contractor, Consultant oder Vendor. Erfordert $select zum Abrufen. Unterstützt $filter (eq, ne, not, ge, le, in, startsWith).
    externalUserState String Für einen Gast, der über die Einladungs-API zum Mandanten eingeladen wurde, stellt diese Eigenschaft den Status des eingeladenen Benutzers dar. Für eingeladene Benutzer kann der Status PendingAcceptance oder Accepted sein, und für alle anderen Benutzer kann er null sein.

    Erfordert $select zum Abrufen. Unterstützt $filter (eq, ne, not, in).
    externalUserStateChangeDateTime DateTimeOffset Zeigt den Zeitstempel für die letzte Änderung an der externalUserState-Eigenschaft an.

    Erfordert $select zum Abrufen. Unterstützt $filter (eq, ne, not, in).
    faxNumber String Die Faxnummer des Benutzers.

    Erfordert $select zum Abrufen. Unterstützt $filter (eq, ne, not , ge, le, in, startsWith und eq für null-Werte).
    givenName Zeichenfolge Der Vorname des Benutzers. Die maximale Länge beträgt 64 Zeichen.

    Wird standardmäßig zurückgegeben. Unterstützt $filter (eq, ne, not , ge, le, in, startsWith und eq für null-Werte).
    hireDate DateTimeOffset Das Einstellungsdatum des Benutzers. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und wird immer in UTC angegeben. Zum Beispiel ist Mitternacht UTC am 1. Januar 2014 .2014-01-01T00:00:00Z

    Erfordert $select zum Abrufen.
    Hinweis: Diese Eigenschaft ist spezifisch für SharePoint in Microsoft 365. Wir empfehlen die Verwendung der nativen employeeHireDate-Eigenschaft zum Festlegen und Aktualisieren von Einstellungsdatumswerten mithilfe von Microsoft Graph-APIs.
    id String Der eindeutige Bezeichner des Benutzers. Sollte als undurchsichtiger Bezeichner behandelt werden. Geerbt von directoryObject. Key. Lässt keine Nullwerte zu. Schreibgeschützt.

    Wird standardmäßig zurückgegeben. Unterstützt $filter (eq, ne, not, in).
    identities objectIdentity-Sammlung Stellt die Identitäten dar, mit denen Sie sich bei diesem Benutzerkonto anmelden können. Microsoft (auch als lokales Konto bezeichnet), Organisationen oder soziale Identitätsanbieter wie Facebook, Google und Microsoft können Identität bereitstellen und sie mit einem Benutzerkonto verknüpfen. Er kann mehrere Elemente mit demselben signInType-Wert enthalten.

    Erfordert $select zum Abrufen.

    Unterstützt $filter (eq) mit Einschränkungen.
    imAddresses String collection Die SIP-Adressen (Instant Message Voice-over IP) Session Initiation Protocol (VoIP) für den Benutzer. Schreibgeschützt.

    Erfordert $select zum Abrufen. Unterstützt $filter (eq, not, ge, le, startsWith).
    interests String collection Eine Liste für den Benutzer, um dessen Interessen zu beschreiben.

    Erfordert $select zum Abrufen.
    isManagementRestricted Boolean true wenn der Benutzer Mitglied einer Verwaltungseinheit mit eingeschränkter Verwaltung ist. Wenn nicht festgelegt, ist null der Standardwert und das Standardverhalten falsch. Schreibgeschützt.

    Um einen Benutzer zu verwalten, der Mitglied einer Verwaltungseinheit mit eingeschränkter Verwaltung ist, muss dem Administrator oder der aufrufenden App eine Microsoft Entra Rolle im Bereich der Verwaltungseinheit mit eingeschränkter Verwaltung zugewiesen werden.

    Erfordert $select zum Abrufen.
    isResourceAccount Boolean Nicht verwenden – für die zukünftige Verwendung reserviert.
    jobTitle Zeichenfolge Die Position des Benutzers. Die maximale Länge beträgt 128 Zeichen.

    Wird standardmäßig zurückgegeben. Unterstützt $filter (eq, ne, not , ge, le, in, startsWith und eq für null-Werte).
    lastPasswordChangeDateTime DateTimeOffset Der Zeitpunkt, zu dem dieser Microsoft Entra-Benutzer sein Kennwort zuletzt geändert hat oder sein Kennwort erstellt wurde, je nachdem, an welchem Datum die letzte Aktion ausgeführt wurde. Die Datums- und Uhrzeitinformationen verwenden das ISO 8601-Format und sind immer in UTC. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z.

    Erfordert $select zum Abrufen.
    legalAgeGroupClassification legalAgeGroupClassification Verwendet von Enterprise-Anwendungen, um die gesetzliche Altersgruppe des Benutzers zu bestimmen. Diese Eigenschaft ist schreibgeschützt und wird basierend auf den Eigenschaften ageGroup und consentProvidedForMinor berechnet. Zulässige Werte: null, Undefined, MinorWithOutParentalConsent, MinorWithParentalConsent, MinorNoParentalConsentRequiredNotAdult, und Adult. Weitere Informationen finden Sie unter Definitionen von Altersgruppeneigenschaften.

    Erfordert $select zum Abrufen.
    licenseAssignmentStates licenseAssignmentState-Sammlung Status der Lizenzzuweisungen für diesen Benutzer. Zeigt auch Lizenzen an, die direkt zugewiesen sind oder vom Benutzer über Gruppenmitgliedschaften geerbt werden. Schreibgeschützt.

    Erfordert $select zum Abrufen.
    mail Zeichenfolge SMTP-Adresse für den Benutzer, z. B. jeff@contoso.com. Änderungen an dieser Eigenschaft aktualisieren die proxyAddresses-Auflistung des Benutzers, um den Wert als SMTP-Adresse aufzunehmen. Diese Eigenschaft darf keine Akzentzeichen enthalten.
    HINWEIS: Für Azure AD B2C-Benutzerprofile wird davon abgeraten, diese Eigenschaft zu aktualisieren. Verwenden Sie stattdessen die Eigenschaft otherMails.

    Wird standardmäßig zurückgegeben. Unterstützt $filter (eq, ne, not, ge, le, in, startsWith, endsWith und eq für null-Werte).
    mailboxSettings mailboxSettings Einstellungen für das primäre Postfach des angemeldeten Benutzers. Sie können Einstellungen für das Senden von automatischen Antworten auf eingehende Nachrichten, das Gebietsschema und die Zeitzone abrufen oder aktualisieren.

    Erfordert $select zum Abrufen.
    mailNickname Zeichenfolge Der E-Mail-Alias für den Benutzer. Diese Eigenschaft muss beim Erstellen eines Benutzers angegeben werden. Die maximale Länge beträgt 64 Zeichen.

    Erfordert $select zum Abrufen. Unterstützt $filter (eq, ne, not, ge, le, in, startsWith und eq für null-Werte).
    mobilePhone String Die Nummer des primären Mobiltelefons für den Benutzer. Schreibgeschützt für Benutzer, die aus dem lokalen Verzeichnis synchronisiert werden. Die maximale Länge beträgt 64 Zeichen.

    Wird standardmäßig zurückgegeben. Unterstützt $filter (eq, ne, not, gele, , startsWithin, , und eq on null Werte) und $search.

    Diese Immobilie unterliegt Einschränkungen für sensible Aktionen. Nur bestimmte privilegierte Administratorrollen können sie aktualisieren.
    mySite String Die URL für die Website des Benutzers.

    Erfordert $select zum Abrufen.
    officeLocation String Der Bürostandort der Firma des Benutzers.

    Wird standardmäßig zurückgegeben. Unterstützt $filter (eq, ne, not, ge, le, in, startsWith und eq für null-Werte).
    onPremisesDistinguishedName String Enthält das lokale Active Directory distinguished name oder DN. Die Eigenschaft wird nur für Kunden ausgefüllt, die ihr lokales Verzeichnis mit Microsoft Entra ID über Microsoft Entra Connect synchronisieren. Schreibgeschützt.

    Erfordert $select zum Abrufen.
    onPremisesDomainName String Enthält lokale domainFQDN, die auch als dnsDomainName bezeichnet und aus dem lokalen Verzeichnis synchronisiert werden. Die Eigenschaft wird nur für Kunden ausgefüllt, die ihr lokales Verzeichnis mit Microsoft Entra ID über Microsoft Entra Connect synchronisieren. Schreibgeschützt.

    Erfordert $select zum Abrufen.
    onPremisesExtensionAttributes onPremisesExtensionAttributes Enthält die Erweiterungsattribute 1 bis 15 für den Benutzer. Diese Erweiterungsattribute werden auch als benutzerdefinierte Exchange-Attribute 1-15 bezeichnet. Jedes Attribut kann bis zu 1024 Zeichen speichern.
  • Für einen onPremisesSyncEnabled-Benutzer ist die Autoritätsquelle für diese Gruppe von Eigenschaften lokal und schreibgeschützt.
  • Für einen reinen Cloudbenutzer (bei dem onPremisesSyncEnabled ist false) können diese Eigenschaften während der Erstellung oder Aktualisierung eines Benutzerobjekts festgelegt werden.
  • Für einen Cloudbenutzer, der zuvor von lokales Active Directory synchronisiert wurde, sind diese Eigenschaften in Microsoft Graph schreibgeschützt, können aber vollständig über das Exchange Admin Center oder das Exchange Online V2-Modul in PowerShell verwaltet werden.

    • Erfordert $select zum Abrufen. Unterstützt $filter (eq, ne, not, in).
    onPremisesImmutableId Zeichenfolge Diese Eigenschaft wird verwendet, um ein lokales Active Directory-Benutzerkonto seinem Microsoft Entra-Benutzerobjekt zuzuordnen. Diese Eigenschaft muss beim Erstellen eines neuen Benutzerkontos im Graph angegeben werden, wenn Sie eine Verbunddomäne für die userPrincipalName (UPN)-Eigenschaft des Benutzers verwenden. HINWEIS: Die $ Zeichen und _ können nicht verwendet werden, wenn diese Eigenschaft angegeben wird.

    Erfordert $select zum Abrufen. Unterstützt $filter (eq, ne, not, ge, le, in).

    Diese Immobilie unterliegt Einschränkungen für sensible Aktionen. Nur bestimmte privilegierte Administratorrollen können sie aktualisieren.
    onPremisesLastSyncDateTime DateTimeOffset Gibt den letzten Zeitpunkt an, zu dem das Objekt mit dem lokalen Verzeichnis synchronisiert wurde. Zum Beispiel: 2013-02-16T03:04:54Z. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und wird immer in UTC angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z. Schreibgeschützt.

    Erfordert $select zum Abrufen. Unterstützt $filter (eq, ne, not, ge, le, in).
    onPremisesProvisioningErrors onPremisesProvisioningError-Sammlung Fehler bei Verwendung eines Microsoft-Synchronisierungsprodukts während der Bereitstellung.

    Erfordert $select zum Abrufen. Unterstützt $filter (eq, not, ge, le).
    onPremisesSamAccountName String Enthält lokale samAccountName, die aus dem lokalen Verzeichnis synchronisiert werden. Die Eigenschaft wird nur für Kunden ausgefüllt, die ihr lokales Verzeichnis mit Microsoft Entra ID über Microsoft Entra Connect synchronisieren. Schreibgeschützt.

    Erfordert $select zum Abrufen. Unterstützt $filter (eq, ne, not, ge, le, in, startsWith).
    onPremisesSecurityIdentifier Zeichenfolge Enthält die lokale Sicherheits-ID (SID) für den Benutzer, der von der lokalen Bereitstellung in der Cloud synchronisiert wurde. Schreibgeschützt.

    Erfordert $select zum Abrufen. Unterstützt $filter (eq auch für null-Werte).
    onPremisesSyncEnabled Boolean truewenn dieses Benutzerobjekt derzeit von einem lokalen Active Directory (AD) synchronisiert wird, andernfalls wird der Benutzer nicht synchronisiert und kann in Microsoft Entra ID verwaltet werden. Schreibgeschützt.

    Erfordert $select zum Abrufen. Unterstützt $filter (eq, ne, not, in und eq für null-Werte).
    onPremisesUserPrincipalName String Enthält lokale userPrincipalName, die aus dem lokalen Verzeichnis synchronisiert werden. Die Eigenschaft wird nur für Kunden ausgefüllt, die ihr lokales Verzeichnis mit Microsoft Entra ID über Microsoft Entra Connect synchronisieren. Schreibgeschützt.

    Erfordert $select zum Abrufen. Unterstützt $filter (eq, ne, not, ge, le, in, startsWith).
    otherMails Zeichenfolgensammlung Eine Liste anderer E-Mail-Adressen für den Benutzer; Beispiel: ["bob@contoso.com", "Robert@fabrikam.com"]. Kann bis zu 250 Werte mit jeweils 250 Zeichen speichern.
    HINWEIS: Diese Eigenschaft darf keine Akzentzeichen enthalten.

    Erfordert $select zum Abrufen. Unterstützt $filter (eq, not, ge, le, in, startsWith, endsWith, , ). /$count ne 0/$count eq 0

    Diese Immobilie unterliegt Einschränkungen für sensible Aktionen. Nur bestimmte privilegierte Administratorrollen können sie aktualisieren.
    passwordPolicies String Gibt die Kennwortrichtlinien für den Benutzer an. Dieser Wert ist eine Enumeration, deren einziger möglicher Wert DisableStrongPassword lautet. Damit können schwächere Kennwörter als in der Standardrichtlinie angegeben festgelegt werden. Auch DisablePasswordExpiration kann angegeben werden. Die beiden könnten zusammen spezifiziert werden; Beispiel: DisablePasswordExpiration, DisableStrongPassword.

    Erfordert $select zum Abrufen. Weitere Informationen zu den Standardkennwortrichtlinien finden Sie unter Microsoft Entra-Kennwortrichtlinien. Unterstützt $filter (ne, not und eq für null-Werte).
    passwordProfile passwordProfile Gibt das Kennwortprofil für den Benutzer an. Das Profil enthält das Kennwort des Benutzers. Diese Eigenschaft ist erforderlich, wenn ein Benutzer erstellt wird. Das Kennwort im Profil muss den Mindestanforderungen entsprechen, wie von der passwordPolicies-Eigenschaft angegeben. Standardmäßig ist ein sicheres Kennwort erforderlich.

    Erfordert $select zum Abrufen. Unterstützt $filter (eq, ne, not, in und eq für null-Werte).

    So aktualisieren Sie diese Eigenschaft:
  • User-PasswordProfile.ReadWrite.All ist die Berechtigung mit den geringsten Berechtigungen, um diese Eigenschaft zu aktualisieren.
  • In delegierten Szenarien ist die Administratorrolle BenutzeradministratorMicrosoft Entra die Administratorrolle mit den geringsten Berechtigungen, die unterstützt wird, um diese Eigenschaft für Benutzer ohne Administratorrechte zu aktualisieren. "Administrator für privilegierte Authentifizierung" ist die Rolle mit den geringsten Berechtigungen, die diese Eigenschaft für alle Administratoren im Mandanten aktualisieren darf. Im Allgemeinen muss der angemeldete Benutzer über eine höhere privilegierte Administratorrolle verfügen, wie unter Wer kann Kennwörter zurücksetzen angegeben.
  • In reinen App-Szenarien muss der aufrufenden App eine unterstützte Berechtigung und mindestens die Rolle Benutzeradministrator Microsoft Entra zugewiesen werden.

    Diese Eigenschaft unterliegt ebenfalls Einschränkungen für sensible Aktionen.
    		•
    pastProjects String collection Eine Liste zur Aufzählung der erledigten Projekte eines Benutzers.

    Erfordert $select zum Abrufen.
    postalCode String Die Postleitzahl für die Postanschrift des Benutzers. Die Postleitzahl ist spezifisch für das Land oder die Region des Benutzers. In den USA enthält dieses Attribut den ZIP Code. Die maximale Länge beträgt 40 Zeichen.

    Erfordert $select zum Abrufen. Unterstützt $filter (eq, ne, not, ge, le, in, startsWith und eq für null-Werte).
    preferredDataLocation String Der bevorzugte Datenspeicherort für den Benutzer. Weitere Informationen finden Sie unter OneDrive Online Multi-Geo.
    preferredLanguage String Die bevorzugte Sprache für den Benutzer. Das bevorzugte Sprachformat basiert auf RFC 4646. Der Name ist eine Kombination aus einem ISO 639-Kulturcode mit zwei Buchstaben, der mit der Sprache verknüpft ist, und einem ISO 3166-Subkulturcode mit zwei Buchstaben in Großbuchstaben, der mit dem Land oder der Region verknüpft ist. Beispiel: "en-US" oder "es-ES".

    Wird standardmäßig zurückgegeben. Unterstützt $filter (eq, ne, not, ge, le, in, startsWith und eq für null-Werte)
    preferredName String Der bevorzugte Name für den Benutzer. Nicht unterstützt. Dieses Attribut gibt eine leere Zeichenfolge zurück.

    Erfordert $select zum Abrufen.
    provisionedPlans ProvisionedPlan-Sammlung Die Pläne, die für den Benutzer bereitgestellt wurden. Schreibgeschützt. Lässt keine NULL-Werte zu.

    Erfordert $select zum Abrufen. Unterstützt $filter (eq, not, ge, le).
    proxyAddresses Zeichenfolgenauflistung Beispiel: ["SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com"]. Änderungen an der mail-Eigenschaft aktualisieren diese Sammlung, um den Wert als SMTP-Adresse aufzunehmen. Weitere Informationen finden Sie unter mail- und proxyAddresses-Eigenschaften. Die Proxyadresse mit dem Präfix SMTP (großgeschrieben) ist die primäre Proxyadresse, während die Adressen mit dem Präfix smtp die sekundären Proxyadressen sind. Für Azure AD B2C-Konten gilt für diese Eigenschaft ein Grenzwert von 10 eindeutigen Adressen. Schreibgeschützt in Microsoft Graph; Sie können diese Eigenschaft nur über das Microsoft 365 Admin Center aktualisieren. Lässt keine NULL-Werte zu.

    Erfordert $select zum Abrufen. Unterstützt $filter (eq, not, ge, le, startsWith, endsWith, /$count eq 0, /$count ne 0).
    refreshTokensValidFromDateTime DateTimeOffset Vor diesem Zeitpunkt ausgegebene Aktualisierungstoken oder Sitzungstoken (Sitzungscookies) sind ungültig. Anwendungen erhalten eine Fehlermeldung, wenn sie ein ungültiges Aktualisierungs- oder Sitzungstoken verwenden, um ein delegiertes Zugriffstoken abzurufen (für den Zugriff auf APIs wie Microsoft Graph). In diesem Fall muss die Anwendung ein neues Aktualisierungstoken abrufen, indem sie den autorisierten Endpunkt anfordert.

    Erfordert $select zum Abrufen. Schreibgeschützt.
    responsibilities String collection Eine Liste zur Aufzählung der Verantwortlichkeiten eines Benutzers.

    Erfordert $select zum Abrufen.
    serviceProvisioningErrors serviceProvisioningError-Sammlung Fehler, die von einem Verbunddienst veröffentlicht werden, die einen nicht vorübergehenden, dienstspezifischen Fehler in Bezug auf die Eigenschaften oder den Link von einem Benutzerobjekt beschreiben.

    Unterstützt $filter (eq, not, für isResolved und serviceInstance).
    schools String collection Eine Liste, in der der Benutzer die Schulen aufzählen kann, die er besucht hat.

    Erfordert $select zum Abrufen.
    securityIdentifier Zeichenfolge Sicherheits-ID (SID) der Gruppe, verwendet in Windows-Szenarios.

    Schreibgeschützt. Wird standardmäßig zurückgegeben.
    Unterstützt $select und $filter (eq, not, ge, le, startsWith).
    showInAddressList Boolesch Nicht in Microsoft Graph verwenden. Verwalten Sie diese Eigenschaft stattdessen über das Microsoft 365 Admin Center. Gibt an, ob der Benutzer in die globale Outlook-Adressliste aufgenommen werden soll. Siehe Bekanntes Problem.
    signInActivity signInActivity Abrufen des Datums der letzten Anmeldung und der Anforderungs-ID der Anmeldung für einen bestimmten Benutzer. Schreibgeschützt.

    Erfordert $select zum Abrufen. Unterstützt $filter (eq, ne, not, gele), aber keine anderen filterbaren Eigenschaften.

    Hinweis:
  • Details für diese Eigenschaft erfordern eine Microsoft Entra ID P1- oder P2-Lizenz und die Berechtigung AuditLog.Read.All.
  • Diese Eigenschaft wird für einen Benutzer, der sich nie oder zuletzt vor April 2020 angemeldet hat, nicht zurückgegeben.
    		•
    signInSessionsValidFromDateTime DateTimeOffset Vor diesem Zeitpunkt ausgegebene Aktualisierungstoken oder Sitzungstoken (Sitzungscookies) sind ungültig. Anwendungen erhalten eine Fehlermeldung, wenn sie ein ungültiges Aktualisierungs- oder Sitzungstoken verwenden, um ein delegiertes Zugriffstoken abzurufen (für den Zugriff auf APIs wie Microsoft Graph). In diesem Fall muss die Anwendung ein neues Aktualisierungstoken abrufen, indem sie den autorisierten Endpunkt anfordert. Schreibgeschützt. Verwenden Sie revokeSignInSessions zum Zurücksetzen.

    Erfordert $select zum Abrufen.
    skills String collection Eine Liste zur Aufzählung der Qualifikationen eines Benutzers.

    Erfordert $select zum Abrufen.
    state Zeichenfolge Bundesland oder Kanton in der Adresse des Benutzers. Die maximale Länge beträgt 128 Zeichen.

    Erfordert $select zum Abrufen. Unterstützt $filter (eq, ne, not, ge, le, in, startsWith und eq für null-Werte).
    streetAddress String Die Straße der Firma des Benutzers. Die maximale Länge beträgt 1.024 Zeichen.

    Erfordert $select zum Abrufen. Unterstützt $filter (eq, ne, not, ge, le, in, startsWith und eq für null-Werte).
    surname Zeichenfolge Der Nachname des Benutzers. Die maximale Länge beträgt 64 Zeichen.

    Wird standardmäßig zurückgegeben. Unterstützt $filter (eq, ne, not, ge, le, in, startsWith und eq für null-Werte).
    usageLocation String Ein aus zwei Buchstaben bestehender Ländercode (ISO-Standard 3166). Erforderlich für Benutzer, denen aufgrund gesetzlicher Anforderungen zur Überprüfung der Verfügbarkeit von Diensten in Ländern/Regionen Lizenzen zugewiesen wurden. Beispiele sind US, JP und GB. Lässt keine NULL-Werte zu.

    Erfordert $select zum Abrufen. Unterstützt $filter (eq, ne, not, ge, le, in, startsWith und eq für null-Werte).
    userPrincipalName Zeichenfolge Der User Principal Name (UPN) des Benutzers. Der UPN ist ein Anmeldename im Internetstil für den Benutzer, der auf dem Internetstandard RFC 822 basiert. Gemäß der Konvention sollte dieser Wert dem E-Mail-Namen des Benutzers zugeordnet werden. Das allgemeine Format ist alias@domain, wobei die Domäne in der Sammlung der überprüften Domänen des Mandanten vorhanden sein muss. Diese Eigenschaft ist erforderlich, wenn ein Benutzer erstellt wird. Auf die verifizierten Domänen für den Mandanten kann über die verifiedDomains -Eigenschaft von organization zugegriffen werden.
    HINWEIS: Diese Eigenschaft darf keine Akzentzeichen enthalten. Nur die folgenden Zeichen sind zulässig: A - Z, a - z, 0 - 9, ' . - _ ! # ^ ~. Eine vollständige Liste der zulässigen Zeichen finden Sie unter Richtlinien für Benutzernamen.

    Wird standardmäßig zurückgegeben. Unterstützt $filter (eq, ne, not, ge, le, in, startsWith, endsWith) und $orderby.

    Diese Immobilie unterliegt Einschränkungen für sensible Aktionen. Nur bestimmte privilegierte Administratorrollen können sie aktualisieren.
    userType Zeichenfolge Ein Zeichenfolgenwert, der zum Klassifizieren von Benutzertypen in Ihrem Verzeichnis verwendet werden kann. Die möglichen Werte sind Member und .Guest

    Erfordert $select zum Abrufen. Unterstützt $filter (eq, ne, not, in und eq für null-Werte). HINWEIS: Weitere Informationen zu den Berechtigungen für Mitglieder und Gäste finden Sie unter Was sind die Standardbenutzerberechtigungen in Microsoft Entra ID?

    Tipp

    Verzeichnis- und Schemaerweiterungen und die zugehörigen Daten müssen $select Geöffnete Erweiterungen und die zugehörigen Daten werden nur zurückgegeben bei $expand.

    mail- und proxyAddresses-Eigenschaften

    mail und proxyAddresses sind beide E-Mail-bezogene Eigenschaften. Die proxyAddresses-Eigenschaft ist eine Sammlung von Adressen, die nur für den Microsoft Exchange-Server relevant sind. Sie wird verwendet, um eine Liste von E-Mail-Adressen für einen Benutzer zu speichern, die an ein einzelnes Postfach gebunden sind. Die mail-Eigenschaft wird als E-Mail-Adresse des Benutzers für verschiedene Zwecke verwendet, einschließlich der Benutzeranmeldung, und definiert die primäre Proxyadresse.

    Sowohl mail - als auch proxyAddresses können über die GET-Benutzer-API abgerufen werden. Sie können die E-Mail über die Benutzer-API aktualisieren , aber nicht proxyAddresses über Microsoft Graph aktualisieren. Wenn die mail-Eigenschaft eines Benutzers aktualisiert wird, löst sie die Neuberechnung von proxyAddresses aus und die neu aktualisierte E-Mail-Adresse wird als primäre Proxyadresse festgelegt, außer in den folgenden Szenarien:

    1. Wenn ein Benutzer über eine Lizenz verfügt, die Microsoft Exchange enthält, müssen alle seine Proxyadressen zu einer verifizierten Domäne des Mandanten gehören. Alle, die nicht zu verifizierten Domänen gehören, werden im Hintergrund entfernt.
    2. Die E-Mail eines Benutzers ist NICHT auf die primäre Proxyadresse festgelegt, wenn der Benutzer ein Gast ist und die primäre Proxyadresse die UPN-Zeichenfolge des Gasts mit #EXT# enthält.
    3. Die E-Mail eines Benutzers wird NICHT entfernt, auch wenn er keine Proxyadressen mehr hat, wenn der Benutzer ein Gast ist.

    proxyAddresses sind für alle Verzeichnisobjekte (Benutzer, Gruppen und Organisationskontakte) eindeutig. Wenn die mail-Eigenschaft eines Benutzers mit einer der proxyAddresses eines anderen Objekts in Konflikt steht, schlägt der Versuch, die Mail zu aktualisieren, fehl, und die proxyAddresses-Eigenschaft wird ebenfalls nicht aktualisiert.

    In diesem Abschnitt wird erläutert, wie die drei Altersgruppeneigenschaften (legalAgeGroupClassification, ageGroup und consentProvidedForMinor) von Microsoft Entra-Administratoren und Unternehmensanwendungsentwicklern verwendet werden, um altersbezogene Vorschriften zu erfüllen:

    • Die Eigenschaft legalAgeGroupClassification ist schreibgeschützt. Es wird von Entwicklern von Unternehmensanwendungen verwendet, um die korrekte Behandlung eines Benutzers basierend auf seiner gesetzlichen Altersgruppe sicherzustellen. Sie wird basierend auf den Eigenschaften ageGroup und consentProvidedForMinor des Benutzers berechnet.
    • ageGroup und consentProvidedForMinor sind optionale Eigenschaften, die von Microsoft Enttra-Administratoren verwendet werden, um sicherzustellen, dass die Verwendung eines Kontos basierend auf den altersbedingten gesetzlichen Vorschriften für das Land oder die Region des Benutzers ordnungsgemäß gehandhabt wird.

    Beispiel: Cameron ist der Administrator eines Verzeichnisses für eine Grundschule in Holyport im Vereinigten Königreich. Zu Beginn des Schuljahres verwendet er die Zulassungsunterlagen, um die Zustimmung der Eltern des Minderjährigen auf der Grundlage der altersbedingten Vorschriften des Vereinigten Königreichs einzuholen. Die von den Eltern eingeholte Zustimmung erlaubt, dass das Konto des Minderjährigen von Holyport School und Microsoft-Apps verwendet wird. Cameron erstellt alle Konten, legt ageGroup auf minor und consentProvidedForMinor auf granted fest. Anwendungen, die von seinen Schülern verwendet werden, sind dann in der Lage, Funktionen zu unterdrücken, die für Minderjährige nicht geeignet sind.

    legalAgeGroupClassification-Werte

    Member Beschreibung
    null Standardwert, für den Benutzer ist keine Altersgruppe festgelegt.
    Undefined Für den Benutzer ist keine Altersgruppe festgelegt, aber consentProvidedForMinor ist entweder Granted, Denied, oder NotRequired.
    MinorWithoutParentalConsent (Reserviert für zukünftige Verwendung)
    MinorWithParentalConsent Der Benutzer gilt aufgrund der altersbedingten Bestimmungen seines Landes oder seiner Region als minderjährig, und der Administrator des Kontos hat die entsprechende Zustimmung von einem Elternteil oder Erziehungsberechtigten eingeholt.
    Erwachsene Der Benutzer gilt gemäß den altersbedingten Bestimmungen seines Landes oder seiner Region als volljährig.
    Minderjährige Der Benutzer gehört einem Land oder einer Region an, für das zusätzliche altersbezogene Vorschriften gelten, z. B. die USA, das Vereinigte Königreich, die Europäische Union oder Südkorea, und das Alter des Benutzers liegt zwischen einem Minderjährigen und einem Erwachsenenalter (wie je nach Land oder Region festgelegt). Im Allgemeinen bedeutet dies, dass Teenager als notAdult in regulierten Ländern/Regionen betrachtet werden.
    MinorNoParentalConsentRequired Der Benutzer ist ein Minderjähriger, stammt aber aus einem Land oder einer Region ohne Regelungen bezüglich des Mindestalters.

    ageGroup-Werte

    Member Beschreibung
    null Standardwert, für den Benutzer ist keine Altersgruppe festgelegt.
    Kleiner Benutzende wird als minderjährig angesehen.
    Minderjährige Der Benutzer stammt aus einem Land oder einer Region, in dem gesetzliche Vorschriften gelten, wie z. B. die USA, das Vereinigte Königreich, die Europäische Union oder Südkorea, und das Alter des Benutzers liegt über der oberen Altersgrenze des Kindes (je nach Land oder Region) und unter der unteren Altersgrenze für Erwachsene (wie je nach Land oder Region festgelegt). Grundsätzlich werden Teenager also als notAdult in regulierten Ländern/Regionen betrachtet.
    Erwachsene Der Benutzer sollte wie ein Erwachsener behandelt werden.

    consentProvidedForMinor-Werte

    Member Beschreibung
    null Standardwert, für den Benutzer ist kein consentProvidedForMinor festgelegt.
    Gewährt Es wird die Zustimmung eingeholt, dass der Benutzer über ein Konto verfügt.
    Verweigert Es wird keine Zustimmung eingeholt, damit der Benutzer über ein Konto verfügt.
    NotRequired Der Benutzer befindet sich an einem Standort, für den keine Zustimmung erforderlich ist.

    Beziehungen

    Beziehung Typ Beschreibung
    Aktivitäten userActivity-Auflistung Die Aktivitäten des Benutzers auf allen Geräten. Schreibgeschützt. Nullwerte zulassend.
    adhocCalls adhocCall-Sammlung Ad-hoc-Anrufe, die dem Benutzer zugeordnet sind. Schreibgeschützt. Nullwerte zulassend.
    agreementAcceptances agreementAcceptance-Sammlung Annahmestatus der Nutzungsbedingungen Schreibgeschützt. Lässt Nullwerte zu.
    appRoleAssignments appRoleAssignment-Auflistung Stellt die App-Rollen dar, die einem Benutzer für eine Anwendung zugewiesen werden. Unterstützt $expand.
    Authentifizierung Authentifizierung Die Authentifizierungsmethoden, die für den Benutzer unterstützt werden.
    Kalender Kalender Primärer Kalender des Benutzers. Schreibgeschützt.
    calendarGroups calendarGroup-Sammlung Die Kalendergruppen des Benutzers. Schreibgeschützt. Lässt NULL-Werte zu.
    calendars calender-Sammlung Die Kalender des Benutzers. Schreibgeschützt. Lässt NULL-Werte zu.
    calendarView event-Sammlung Die Kalenderansicht für den Kalender. Schreibgeschützt. Nullwerte zulassend.
    cloudPCs cloudPC-Sammlung Die Cloud-PCs des Benutzers. Schreibgeschützt. Lässt NULL-Werte zu.
    contactFolders contactFolder-Sammlung Die Kontakteordner des Benutzers. Schreibgeschützt. Lässt NULL-Werte zu.
    contacts contact-Sammlung Die Kontakte des Benutzers. Schreibgeschützt. Lässt NULL-Werte zu.
    createdObjects directoryObject collection Verzeichnisobjekte, die der Benutzer erstellt hat. Schreibgeschützt. Nullwerte zulassend.
    dataSecurityAndGovernance userDataSecurityAndGovernance Die Datensicherheits- und Governanceeinstellungen für den Benutzer. Schreibgeschützt. Lässt NULL-Werte zu.
    directReports directoryObject collection Die Benutzer und Kontakte, die an den Benutzer berichten. (Die Benutzer und Kontakte, deren manager-Eigenschaft auf diesen Benutzer festgelegt ist.) Schreibgeschützt. Lässt NULL-Werte zu. Unterstützt $expand.
    Laufwerk drive OneDrive eines Benutzers. Schreibgeschützt.
    drives drive-Sammlung Eine Sammlung von Laufwerken, die für diesen Benutzer verfügbar sind. Schreibgeschützt.
    events event-Sammlung Die Ereignisse des Benutzers. Standardmäßig werden Ereignisse unter dem Standard-Kalender angezeigt. Schreibgeschützt. Lässt Nullwerte zu.
    Erweiterungen extension-Sammlung Die Sammlung der für den Benutzer definierten offenen Erweiterungen. Schreibgeschützt. Unterstützt $expand. Nullwerte zulassend.
    inferenceClassification inferenceClassification Relevanzklassifizierung der Nachrichten des Benutzers basierend auf expliziten Bezeichnungen, die die abgeleitete Relevanz oder Wichtigkeit außer Kraft setzen.
    Einblicke itemInsights Stellt Beziehungen zwischen einem Benutzer und Elementen wie OneDrive für Geschäfts-, Schul- oder Unidokumente dar, die mithilfe erweiterter Analyse- und Machine Learning-Techniken berechnet werden. Schreibgeschützt. Nullwerte zulassend.
    licenseDetails licenseDetails-Sammlung Eine Sammlung von Lizenzinformationen dieses Benutzers. Schreibgeschützt.
    mailFolders mailFolder-Sammlung Die E-Mail-Ordner des Benutzers. Schreibgeschützt. Lässt NULL-Werte zu.
    manager directoryObject Der Benutzer oder Kontakt, der Vorgesetzter dieses Benutzers ist. Schreibgeschützt. Unterstützt $expand.
    memberOf directoryObject collection Die Gruppen und Verzeichnisrollen, bei denen der Benutzer Mitglied ist. Schreibgeschützt. Nullwerte zulassend. Unterstützt $expand.
    Nachrichten message-Sammlung Die Nachrichten in einem Postfach oder Ordner. Schreibgeschützt. Lässt Nullwerte zu.
    notes Notizsammlung Die Notizen im Ordner "Notizen " des Benutzers. Schreibgeschützt. Nullwerte zulassend.
    onenote onenote Schreibgeschützt.
    onlineMeetings onlineMeeting-Sammlung Informationen zu einer Besprechung, einschließlich der für die Teilnahme an einer Besprechung verwendeten URL, der Teilnehmerliste und der Beschreibung.
    outlook outlookUser Schreibgeschützt.
    ownedDevices directoryObject collection Geräte, die der Benutzer besitzt. Schreibgeschützt. Nullwerte zulassend. Unterstützt $expand und $filter (/$count eq 0, /$count ne 0, /$count eq 1, /$count ne 1).
    ownedObjects directoryObject collection Verzeichnisobjekte, die der Benutzer besitzt. Schreibgeschützt. Nullwerte zulassend. Unterstützt $expand, geschachtelt in $expand, und $filter (/$count eq 0, /$count ne 0, /$count eq 1, /$count ne 1$select ).
    Kontakte person-Sammlung Personen, die für den Benutzer relevant sind. Schreibgeschützt. Nullwerte zulassend.
    permissionGrants resourceSpecificPermissionGrant-Sammlung Listen Sie alle ressourcenspezifischen Berechtigungszuweisungen eines Benutzers auf.
    photo profilePhoto Das Profilfoto des Benutzers. Schreibgeschützt.
    Fotos profilePhoto-Sammlung Die Sammlung von Profilfotos des Benutzers in verschiedenen Größen. Schreibgeschützt.
    planner plannerUser Einstiegspunkt der Planner-Ressource, die möglicherweise für einen Benutzer vorhanden ist. Schreibgeschützt.
    registeredDevices directoryObject collection Geräte, die für den Benutzer registriert sind. Schreibgeschützt. Nullwerte zulassend. Unterstützt $expand und gibt bis zu 100 Objekte zurück.
    Lösungen userSolutionRoot Die Kennung, die den Benutzer mit dem Arbeitszeitplan in Beziehung setzt, löst aus. Schreibgeschützt. Nullwerte zulassend.
    sponsorOf directoryObject collection Verzeichnisobjekte, die dieser Benutzer sponsert, z. B. Gastbenutzer, Agent-Benutzer, Agent-Blaupausen, Agent-Blaupausenprinzipale und Agentidentitäten. Wenn der Benutzer Mitglied einer Gruppe ist, die ein Sponsor ist, werden die von dieser Gruppe gesponserten Objekte ebenfalls einbezogen. Schreibgeschützt. Nullwerte zulassend. Unterstützt $filter, $count, $select, $expand$top, und $skip.
    Sponsoren directoryObject collection Die Benutzer und Gruppen, die für die Berechtigungen dieses Gasts im Mandanten verantwortlich sind und die Informationen und den Zugriff des Gasts auf dem neuesten Stand halten. (HTTP-Methoden: GET, POST, DELETE.). Unterstützt $expand.
    Teamarbeit userTeamwork Ein Container für Microsoft Teams-Features, die für den Benutzer zur Verfügung stehen. Schreibgeschützt. Lässt Nullwerte zu.
    todo todo Stellt die für einen Benutzer verfügbaren To Do-Dienste dar.
    transitiveMemberOf directoryObject collection Die Gruppen, einschließlich verschachtelter Gruppen, und Verzeichnisrollen, bei denen ein Benutzer Mitglied ist. Nullwerte zulassend.

    JSON-Darstellung

    Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

    {
  "aboutMe": "String",
  "accountEnabled": true,
  "ageGroup": "String",
  "assignedLicenses": [{"@odata.type": "microsoft.graph.assignedLicense"}],
  "assignedPlans": [{"@odata.type": "microsoft.graph.assignedPlan"}],
  "birthday": "String (timestamp)",
  "businessPhones": ["String"],
  "city": "String",
  "companyName": "String",
  "consentProvidedForMinor": "String",
  "country": "String",
  "createdDateTime": "String (timestamp)",
  "creationType": "String",
  "customSecurityAttributes": {
    "@odata.type": "microsoft.graph.customSecurityAttributeValue"
  },
  "department": "String",
  "displayName": "String",
  "employeeHireDate": "2020-01-01T00:00:00Z",
  "employeeId": "String",
  "employeeOrgData": {"@odata.type": "microsoft.graph.employeeOrgData"},
  "employeeType": "String",
  "faxNumber" : "String",
  "givenName": "String",
  "hireDate": "String (timestamp)",
  "id": "String (identifier)",
  "identities": [{"@odata.type": "microsoft.graph.objectIdentity"}],
  "imAddresses": ["String"],
  "interests": ["String"],
  "isManagementRestricted": "Boolean",
  "isResourceAccount": false,
  "jobTitle": "String",
  "legalAgeGroupClassification": "String",
  "licenseAssignmentStates": [{"@odata.type": "microsoft.graph.licenseAssignmentState"}],
  "lastPasswordChangeDateTime": "String (timestamp)",
  "mail": "String",
  "mailboxSettings": {"@odata.type": "microsoft.graph.mailboxSettings"},
  "mailNickname": "String",
  "mobilePhone": "String",
  "mySite": "String",
  "officeLocation": "String",
  "onPremisesDistinguishedName": "String",
  "onPremisesDomainName": "String",
  "onPremisesExtensionAttributes": {"@odata.type": "microsoft.graph.onPremisesExtensionAttributes"},
  "onPremisesImmutableId": "String",
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesProvisioningErrors": [{"@odata.type": "microsoft.graph.onPremisesProvisioningError"}],
  "onPremisesSamAccountName": "String",
  "onPremisesSecurityIdentifier": "String",
  "onPremisesSyncEnabled": true,
  "onPremisesUserPrincipalName": "String",
  "otherMails": ["String"],
  "passwordPolicies": "String",
  "passwordProfile": {"@odata.type": "microsoft.graph.passwordProfile"},
  "pastProjects": ["String"],
  "postalCode": "String",
  "preferredDataLocation": "String",
  "preferredLanguage": "String",
  "preferredName": "String",
  "provisionedPlans": [{"@odata.type": "microsoft.graph.provisionedPlan"}],
  "proxyAddresses": ["String"],
  "responsibilities": ["String"],
  "schools": ["String"],
  "securityIdentifier": "String",
  "serviceProvisioningErrors": [
    { "@odata.type": "microsoft.graph.serviceProvisioningXmlError" }
  ],
  "showInAddressList": true,
  "signInActivity": {"@odata.type": "microsoft.graph.signInActivity"},
  "signInSessionsValidFromDateTime": "String (timestamp)",
  "skills": ["String"],
  "state": "String",
  "streetAddress": "String",
  "surname": "String",
  "usageLocation": "String",
  "userPrincipalName": "String",
  "userType": "String",

  "calendar": { "@odata.type": "microsoft.graph.calendar" },
  "calendarGroups": [{ "@odata.type": "microsoft.graph.calendarGroup" }],
  "calendarView": [{ "@odata.type": "microsoft.graph.event" }],
  "calendars": [ {"@odata.type": "microsoft.graph.calendar"} ],
  "contacts": [ { "@odata.type": "microsoft.graph.contact" } ],
  "contactFolders": [ { "@odata.type": "microsoft.graph.contactFolder" } ],
  "createdObjects": [ { "@odata.type": "microsoft.graph.directoryObject" } ],
  "directReports": [ { "@odata.type": "microsoft.graph.directoryObject" } ],
  "drive": { "@odata.type": "microsoft.graph.drive" },
  "drives": [ { "@odata.type": "microsoft.graph.drive" } ],
  "events": [ { "@odata.type": "microsoft.graph.event" } ],
  "inferenceClassification": { "@odata.type": "microsoft.graph.inferenceClassification" },
  "mailFolders": [ { "@odata.type": "microsoft.graph.mailFolder" } ],
  "manager": { "@odata.type": "microsoft.graph.directoryObject" },
  "memberOf": [ { "@odata.type": "microsoft.graph.directoryObject" } ],
  "messages": [ { "@odata.type": "microsoft.graph.message" } ],
  "outlook": { "@odata.type": "microsoft.graph.outlookUser" },
  "ownedDevices": [ { "@odata.type": "microsoft.graph.directoryObject" } ],
  "ownedObjects": [ { "@odata.type": "microsoft.graph.directoryObject" } ],
  "photo": { "@odata.type": "microsoft.graph.profilePhoto" },
  "photos": [ { "@odata.type": "microsoft.graph.profilePhoto" } ],
  "registeredDevices": [ { "@odata.type": "microsoft.graph.directoryObject" } ]
}

    Verwandte Inhalte

    • Last updated on