Arbeiten mit Benutzern in Microsoft GraphWorking with users in Microsoft Graph

Mit Microsoft Graph können Sie überzeugende App-Erfahrung basierend auf Benutzern, Beziehungen mit anderen Benutzern und Gruppen, und E-Mails, Kalender und Dateien bieten.You can use Microsoft Graph to build compelling app experiences based on users, their relationships with other users and groups, and their mail, calendar, and files.

Sie können auf zwei Arten über Microsoft Graph auf Benutzer zugreifen:You can access users through Microsoft Graph in two ways:

  • Anhand der ID, /users/{id | userPrincipalName}By their ID, /users/{id | userPrincipalName}
  • Anhand des /me-Alias für den angemeldeten Benutzer, welcher /users/{signed-in user's id} entsprichtBy using the /me alias for the signed-in user, which is the same as /users/{signed-in user's id}

AutorisierungAuthorization

Für den Zugriff auf Benutzervorgänge ist eine der folgenden Berechtigungen erforderlich. Die ersten drei Berechtigungen können einer App durch einen Benutzer gewährt werden. Die übrigen können der App nur durch einen Administrator gewährt werden.One of the following permissions is required to access user operations. The first three permissions can be granted to an app by a user. The rest can only be granted to an app by the administrator.

  • User.ReadBasic.AllUser.ReadBasic.All
  • User.ReadUser.Read
  • User.ReadWriteUser.ReadWrite
  • User.Read.AllUser.Read.All
  • User.ReadWrite.AllUser.ReadWrite.All
  • Directory.Read.AllDirectory.Read.All
  • Directory.ReadWrite.AllDirectory.ReadWrite.All
  • Directory.AccessAsUser.AllDirectory.AccessAsUser.All

Allgemeine EigenschaftenCommon properties

Im Folgenden werden standardmäßige Eigenschaften dargestellt, die beim Abrufen eines Benutzers oder beim Auflisten von Benutzern zurückgegeben werden.The following represent the default set of properties that are returned when getting a user or listing users. Diese stellen eine Teilmenge aller verfügbaren Eigenschaften.These are a subset of all available properties. Verwenden Sie zum Abrufen weiterer Benutzereigenschaften den $select-Abfrageparameter.To get more user properties, use the $select query parameter.

EigenschaftProperty BeschreibungDescription
idid Die eindeutige ID des Benutzers.The unique identifier for the user.
businessPhonesbusinessPhones Telefonnummern des Benutzers.The user's phone numbers.
displayNamedisplayName Der Name des Benutzers, der im Adressbuch angezeigt wird.The name displayed in the address book for the user.
givenNamegivenName Der Vorname des Benutzers.The first name of the user.
jobTitlejobTitle Die Position des Benutzers.The user's job title.
mailmail Die E-Mail-Adresse des Benutzers.The user's email address.
mobilePhonemobilePhone Die Mobiltelefonnummern des Benutzers.The user's cellphone number.
officeLocationofficeLocation Der Bürostandort des Benutzers.The user's physical office location.
preferredLanguagepreferredLanguage Die vom Benutzer bevorzugte Sprache.The user's language of preference.
surnamesurname Der Nachname des Benutzers.The last name of the user.
userPrincipalNameuserPrincipalName Der Benutzerprinzipalname.The user's principal name.

Weitere Informationen und eine Liste aller Eigenschaften finden Sie unter user-Objekt.For details and a list of all the properties, see the user object.

Allgemeine VorgängeCommon operations

Hinweis: Einige dieser Vorgänge erfordern zusätzliche Berechtigungen.Note: Some of these operations require additional permissions.

PfadPath BeschreibungDescription
/users Listet die Benutzer in der Organisation auf.Lists users in the organization.
/users/{id} Ruft einen bestimmten Benutzer anhand der ID ab.Gets a specific user by id.
/users/{id}/photo/$value Ruft das Profilfoto des Benutzers ab.Gets the user's profile photo.
/users/{id}/manager Ruft den Vorgesetzten des Benutzers ab.Gets the user's manager.
/users/{id}/messages Listet die E-Mails des Benutzers im primären Posteingang auf.Lists the user's email messages in their primary inbox.
/users/{id}/events Listet bevorstehende Ereignisse des Benutzers im Kalender auf.Lists the user's upcoming events in their calendar.
/users/{id}/drive Ruft den OneDrive-Dateispeicher des Benutzers ab.Gets the user's OneDrive file store.
/users/{id}/memberOf Listet die Gruppen auf, deren Mitglied der Benutzer ist.Lists the groups that the user is a member of.