Freigeben über


Office 365-Benutzer

Mit dem Office 365-Benutzerverbindungsanbieter können Sie mithilfe Ihres Office 365-Kontos auf Benutzerprofile in Ihrer Organisation zugreifen. Sie können verschiedene Aktionen ausführen, z. B. Ihr Profil, das Profil eines Benutzers, den Vorgesetzten eines Benutzers oder direkte Berichte und auch ein Benutzerprofil aktualisieren.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Dienstleistung Class Regions
Copilot Studio Norm Alle Power Automate-Regionen
Logik-Apps Norm Alle Logik-Apps-Regionen
Power Apps Norm Alle Power Apps-Regionen
Power Automate Norm Alle Power Automate-Regionen
Kontakt
Name Office 365-Benutzer
URL https://learn.microsoft.com/en-us/connectors/office365users/
Email idcknowledgeeco@microsoft.com
Connectormetadaten
Herausgeber Microsoft
Webseite https://www.office.com/
Datenschutzrichtlinie https://privacy.microsoft.com/
Kategorien Künstliche Intelligenz; Business Intelligence

Weitere Informationen zum Verwenden dieses Connectors in Power Apps finden Sie hier.

Bekannte Probleme und Einschränkungen

Nachfolgend sind einige der bekannten Einschränkungen der Verwendung des Office 365-Benutzerconnectors aufgeführt.

  1. Um diese Integration zu verwenden, benötigen Sie Zugriff auf ein Office 365-Postfach, das die REST-API aktiviert hat. Um eine Verbindung herzustellen, wählen Sie "Anmelden" aus. Sie werden aufgefordert, Ihr Office 365-Konto bereitzustellen, folgen Sie den restlichen Bildschirmen, um eine Verbindung zu erstellen.
  2. Der Connector unterstützt keine Government Community Cloud High (GCCH)-Konten in LogicApps US Government Cloud.
  3. Wenn beim Connector ein Fehler angezeigt wird, überprüfen Sie, ob die REST-API aktiviert ist. Konten auf einem dedizierten (lokalen) E-Mail-Server oder Konten, die Sandkastenkonten (Test)-Konten sind, können auch einen Fehler sehen. Ihr Administrator kann hier erfahren, wie Sie ein Postfach migrieren. Wenn Sie eine EWS-Anwendungszugriffsrichtlinie verwenden, stellen Sie außerdem sicher, dass die folgenden Benutzer-Agents zulässig sind: "LogicAppsDesigner/*","azure-logic-apps/*","PowerApps/*", "Mozilla/*"
  4. Die Aktion "Manager abrufen( V2) gibt "Kein Manager für den angegebenen Benutzer gefunden" zurück.
    • Dies geschieht, wenn der Benutzer keinen Vorgesetzten in der Microsoft Entra-ID konfiguriert hat. Erfahren Sie, wie Sie das Profil eines Microsoft Entra-ID-Benutzers aktualisieren, um hier einen Vorgesetzten zu konfigurieren.
  5. Abrufen von direkten Berichten (V2),Get Manager (V2), Abrufen meines Profils (V2) und Aktionen zum Abrufen von Benutzerprofilen (V2) deklarieren einen EingabeparameterSelect fields. Sie können eine durch Komma getrennte Liste von Feldern angeben, die in diesem Parameter ausgewählt werden sollen (weitere Informationen zu den verfügbaren Feldern finden Sie hier). Beispiel:
    • department, jobTitle
    • displayName, surname, mailNickname, userPrincipalName
  6. Wenn der Parameter nicht angegeben ist, Die folgenden Felder sind standardmäßig ausgewählt: aboutMe, accountEnabled, geburtstag, businessPhones, city, companyName, country, department, displayName, givenName, hireDate, id, interests, jobTitle, mail, mailNickname, mobilePhone, mySite, officeLocation, pastProjects, postalCode, preferredLanguage, preferredName, responsibilities, schools, skills, state, streetAddress, surname, userPrincipalName, userType.
  7. Direkte Berichte (V2) abrufen, Manager abrufen (V2), Abrufen meines Profils (V2) und Aktionen zum Abrufen von Benutzerprofilen (V2) treten möglicherweise fehler 403 Forbidden auf, wenn einige der Felder, die standardmäßig ausgewählt sind, durch Ihre Mandantenrichtlinien blockiert werden. Wenden Sie sich an Ihren Mandantenadministrator, um die Felder zuzulassen, oder versuchen Sie, den Parameter explizit anzugeben Select fields .
    • Stellen Sie sicher, dass jeder außer externen Benutzern über Berechtigungen My Site Host für abschnitte "Meine Einstellung" und "Berechtigung" im SharePoint Admin Center verfügt, um die felder abzufragen, die standardmäßig wie oben angegeben ausgewählt sind.
  8. Richtlinien für bedingten Zugriff können verhindern, dass der Connector wie erwartet ausgeführt wird. Beispiel für einen Fehler: "AADSTS53003: Der Zugriff wurde durch Richtlinien für bedingten Zugriff blockiert. Die Zugriffsrichtlinie lässt keine Tokenausstellung zu.". Weitere Informationen finden Sie in der Dokumentation zum bedingten Zugriff von Microsoft Entra ID .
  9. Fehler beim Abrufen meiner Profilaktion401 Unauthorized (V2) bei verwendung durch Gastbenutzer. Um dies zu umgehen, geben Select fields Sie den Parameter explizit an: id, displayName, givenName, surname, mail, mailNickname, accountEnabled, userPrincipalName, department, jobTitle, mobilePhone, businessPhones, city, companyName, country, officeLocation, postalCode.
  10. SearchUser (v2) schlägt möglicherweise fehl.403 Insufficient privileges to complete the operation
    • Gastbenutzer sind im Design eingeschränkt. Ein alternativer Vorschlag besteht darin, eine Benutzerliste zu erstellen, die von der Office365-Benutzerliste in SharePoint aufgefüllt wird, und dann diese Liste als Datenquelle verwenden.
    • Darüber hinaus kann das Einschränken der Zugriffsrechte von Gästen die Informationssicherheit Ihrer Organisation verbessern. Es wird empfohlen, die Sicherheitsauswirkungen dieses Vorgangs zu bewerten.

Erstellen einer Verbindung

Der Connector unterstützt die folgenden Authentifizierungstypen:

Vorgabe Parameter zum Erstellen einer Verbindung. Alle Regionen Nicht teilbar

Vorgabe

Anwendbar: Alle Regionen

Parameter zum Erstellen einer Verbindung.

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Drosselungsgrenzwerte

Name Aufrufe Verlängerungszeitraum
API-Aufrufe pro Verbindung 1000 60 Sekunden

Aktionen

Abrufen eines Benutzerfotos (V2)

Ruft das Foto des angegebenen Benutzers ab, wenn er über eins verfügt

Abrufen meiner beliebten Dokumente

Ruft die trendenden Dokumente für den angemeldeten Benutzer ab.

Abrufen relevanter Personen

Abrufen relevanter Personen.

Abrufen von Benutzerfotometadaten

Abrufen von Benutzerfotometadaten.

Abrufen von trendenden Dokumenten

Ruft die trendenden Dokumente für einen Benutzer ab.

Benutzerfoto abrufen (V1) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Benutzerfoto abrufen" (V2 ).

Ruft das Foto des angegebenen Benutzers ab, wenn er über einen verfügt.

Benutzerprofil abrufen (V1) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen get user profile (V2 ).

Ruft das Profil eines bestimmten Benutzers ab.

Benutzerprofil abrufen (V2)

Ruft das Profil eines bestimmten Benutzers ab. Weitere Informationen zu verfügbaren Feldern zur Auswahl: https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties

Direkte Berichte abrufen (V1) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Direkte Berichte abrufen" (V2 ).

Ruft die Benutzerprofile der direkten Berichte des angegebenen Benutzers ab.

Direkte Berichte abrufen (V2)

Ruft die Benutzerprofile der direkten Berichte des angegebenen Benutzers ab. Weitere Informationen zu verfügbaren Feldern zur Auswahl: https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties

Manager abrufen (V1) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen get manager (V2 ).

Ruft das Profil des Vorgesetzten des angegebenen Benutzers ab.

Manager abrufen (V2)

Ruft das Profil des Vorgesetzten des angegebenen Benutzers ab. Weitere Informationen zu verfügbaren Feldern zur Auswahl: https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties

Mein Profil abrufen (V1) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Mein Profil abrufen" (V2 ).

Ruft das Profil des aktuellen Benutzers ab.

Mein Profil abrufen (V2)

Ruft das Profil des aktuellen Benutzers ab. Weitere Informationen zu verfügbaren Feldern zur Auswahl: https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties

Mein Profil aktualisieren

Aktualisiert das Profil des aktuellen Benutzers.

Mein Profilfoto aktualisieren

Aktualisiert das Profilfoto des aktuellen Benutzers. Die Größe des Fotos muss kleiner als 4 MB sein.

Nach Benutzern suchen (V2)

Ruft die Benutzerprofile ab, die dem Suchbegriff (V2) entsprechen.

Nach Benutzern suchen [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen die Suche für Benutzer (V2 ).

Ruft die Benutzerprofile ab, die dem Suchbegriff entsprechen.

Senden einer HTTP-Anforderung

Erstellen Sie eine Microsoft Graph-REST-API-Anforderung, die aufgerufen werden soll. Diese Segmente werden unterstützt: 1. Segement: /me, /users/<userId> 2nd segment: messages, mailFolders, events, calendar, calendars, outlook, inferenceClassification. Weitere Informationen finden Sie hier: https://docs.microsoft.com/en-us/graph/use-the-api.

Abrufen eines Benutzerfotos (V2)

Ruft das Foto des angegebenen Benutzers ab, wenn er über eins verfügt

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Benutzer (UPN)
id True string

Benutzerprinzipalname oder -ID.

Gibt zurück

Bilddateiinhalt
binary

Abrufen meiner beliebten Dokumente

Ruft die trendenden Dokumente für den angemeldeten Benutzer ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Filterabfrage
$filter string

Ein OData-Filter zum Filtern der ausgewählten Ressourcen. Filtern ausgewählter Ressourcen auf ResourceVisualization/Type oder ResourceVisualization/containerType

Extrahieren der Vertraulichkeitsbezeichnung
extractSensitivityLabel boolean

Wählen Sie aus, ob Sie vertraulichkeitsbezeichnung extrahieren möchten ( false, true).

Metadaten für Vertraulichkeitsbezeichnungen
fetchSensitivityLabelMetadata boolean

Ein boolescher Wert, der vertraulichkeitsbezeichnungsmetadaten für die zugeordnete Bezeichnungs-ID abruft.

Gibt zurück

Name Pfad Typ Beschreibung
value
value array of GraphTrending

value

Abrufen relevanter Personen

Abrufen relevanter Personen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Benutzer (UPN)
userId True string

Benutzerprinzipalname oder -ID.

Gibt zurück

Stellt eine Liste aus der Graph-API dar.

Abrufen von Benutzerfotometadaten

Abrufen von Benutzerfotometadaten.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Benutzer (UPN)
userId True string

Benutzerprinzipalname oder -ID.

Gibt zurück

Photo Metadata-Klasse

Abrufen von trendenden Dokumenten

Ruft die trendenden Dokumente für einen Benutzer ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Benutzer (UPN)
id True string

Benutzerprinzipalname oder -ID.

Filterabfrage
$filter string

Ein OData-Filter zum Filtern der ausgewählten Ressourcen. Filtern ausgewählter Ressourcen auf ResourceVisualization/Type oder ResourceVisualization/containerType

Extrahieren der Vertraulichkeitsbezeichnung
extractSensitivityLabel boolean

Wählen Sie aus, ob Sie vertraulichkeitsbezeichnung extrahieren möchten ( false, true).

Metadaten für Vertraulichkeitsbezeichnungen
fetchSensitivityLabelMetadata boolean

Ein boolescher Wert, der vertraulichkeitsbezeichnungsmetadaten für die zugeordnete Bezeichnungs-ID abruft.

Gibt zurück

Name Pfad Typ Beschreibung
value
value array of GraphTrending

value

Benutzerfoto abrufen (V1) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Benutzerfoto abrufen" (V2 ).

Ruft das Foto des angegebenen Benutzers ab, wenn er über einen verfügt.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Benutzer (UPN)
userId True string

Benutzerprinzipalname oder -ID.

Gibt zurück

Bilddateiinhalt
binary

Benutzerprofil abrufen (V1) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen get user profile (V2 ).

Ruft das Profil eines bestimmten Benutzers ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Benutzer (UPN)
userId True string

Benutzerprinzipalname oder -ID.

Gibt zurück

Stellt ein User -Objekt im Verzeichnis dar

Body
User

Benutzerprofil abrufen (V2)

Ruft das Profil eines bestimmten Benutzers ab. Weitere Informationen zu verfügbaren Feldern zur Auswahl: https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Benutzer (UPN)
id True string

Benutzerprinzipalname oder -ID.

Felder auswählen
$select string

Kommagetrennte Liste der auszuwählenden Felder. Beispiel: Nachname, Abteilung, JobTitle

Gibt zurück

Benutzer aus Graph-API

Direkte Berichte abrufen (V1) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Direkte Berichte abrufen" (V2 ).

Ruft die Benutzerprofile der direkten Berichte des angegebenen Benutzers ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Benutzer (UPN)
userId True string

Benutzerprinzipalname oder -ID.

Gibt zurück

response
array of User

Direkte Berichte abrufen (V2)

Ruft die Benutzerprofile der direkten Berichte des angegebenen Benutzers ab. Weitere Informationen zu verfügbaren Feldern zur Auswahl: https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Benutzer (UPN)
id True string

Benutzerprinzipalname oder -ID.

Felder auswählen
$select string

Kommagetrennte Liste der auszuwählenden Felder. Beispiel: Nachname, Abteilung, JobTitle

Nach oben
$top integer

Grenzwert für die Anzahl der zurückzugebenden Ergebnisse. Standardmäßig werden alle Einträge zurückgegeben.

Gibt zurück

Name Pfad Typ Beschreibung
value
value array of GraphUser_V1

Wert

Manager abrufen (V1) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen get manager (V2 ).

Ruft das Profil des Vorgesetzten des angegebenen Benutzers ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Benutzer (UPN)
userId True string

Benutzerprinzipalname oder -ID.

Gibt zurück

Stellt ein User -Objekt im Verzeichnis dar

Body
User

Manager abrufen (V2)

Ruft das Profil des Vorgesetzten des angegebenen Benutzers ab. Weitere Informationen zu verfügbaren Feldern zur Auswahl: https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Benutzer (UPN)
id True string

Benutzerprinzipalname oder -ID.

Felder auswählen
$select string

Kommagetrennte Liste der auszuwählenden Felder. Beispiel: Nachname, Abteilung, JobTitle

Gibt zurück

Benutzer aus Graph-API

Mein Profil abrufen (V1) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Mein Profil abrufen" (V2 ).

Ruft das Profil des aktuellen Benutzers ab.

Gibt zurück

Stellt ein User -Objekt im Verzeichnis dar

Body
User

Mein Profil abrufen (V2)

Ruft das Profil des aktuellen Benutzers ab. Weitere Informationen zu verfügbaren Feldern zur Auswahl: https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Felder auswählen
$select string

Kommagetrennte Liste der auszuwählenden Felder. Beispiel: Nachname, Abteilung, JobTitle

Gibt zurück

Benutzer aus Graph-API

Mein Profil aktualisieren

Aktualisiert das Profil des aktuellen Benutzers.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Über mich
aboutMe string

Über mich

Geburtstag
birthday date-time

Geburtstag

Interessen
interests array of string

Interessen

Meine Website
mySite string

Meine Website

Vergangene Projekte
pastProjects array of string

Vergangene Projekte

Schulen
schools array of string

Schulen

Fähigkeiten
skills array of string

Fähigkeiten

Mein Profilfoto aktualisieren

Aktualisiert das Profilfoto des aktuellen Benutzers. Die Größe des Fotos muss kleiner als 4 MB sein.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Bilddateiinhalt
body True binary

Bilddateiinhalt

Inhaltstyp
Content-Type True string

Bildinhaltstyp (z. B. 'image/jpeg')

Nach Benutzern suchen (V2)

Ruft die Benutzerprofile ab, die dem Suchbegriff (V2) entsprechen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Suchbegriff
searchTerm string

Suchzeichenfolge (gilt für: Anzeigename, Vorname, Nachname, E-Mail, E-Mail- und Benutzerprinzipalname).

Nach oben
top integer

Grenzwert für die Anzahl der zurückzugebenden Ergebnisse. Der Mindestwert ist 1. Der Standardwert ist 1000.

Ist suchbegriff erforderlich
isSearchTermRequired boolean

Wenn dieser Wert auf "Ja" festgelegt ist, werden keine Benutzerprofile zurückgegeben, wenn der Suchbegriff leer ist. Wenn dieser Wert auf "Nein" festgelegt ist, wird keine Filterung angewendet, wenn der Suchbegriff leer ist.

Gibt zurück

Klasse, die entitätslistenantwort von einer Office-API darstellt.

Nach Benutzern suchen [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen die Suche für Benutzer (V2 ).

Ruft die Benutzerprofile ab, die dem Suchbegriff entsprechen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Suchbegriff
searchTerm string

Suchzeichenfolge (gilt für: Anzeigename, Vorname, Nachname, E-Mail, E-Mail- und Benutzerprinzipalname).

Nach oben
top integer

Grenzwert für die Anzahl der zurückzugebenden Ergebnisse. Standardmäßig werden alle Einträge zurückgegeben.

Gibt zurück

response
array of User

Senden einer HTTP-Anforderung

Erstellen Sie eine Microsoft Graph-REST-API-Anforderung, die aufgerufen werden soll. Diese Segmente werden unterstützt: 1. Segement: /me, /users/<userId> 2nd segment: messages, mailFolders, events, calendar, calendars, outlook, inferenceClassification. Weitere Informationen finden Sie hier: https://docs.microsoft.com/en-us/graph/use-the-api.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
URI
Uri True string

Der vollständige oder relative URI. Beispiel: https://graph.microsoft.com/{version}/{resource}.

Methode
Method True string

Die HTTP-Methode (Standard ist GET).

Body
Body binary

Der Anforderungstextinhalt.

Inhaltstyp
ContentType string

Der Inhaltstypheader für den Textkörper (Standard ist Application/json).

CustomHeader1
CustomHeader1 string

Benutzerdefinierte Kopfzeile 1. Im Format angeben: Headername: Headerwert

CustomHeader2
CustomHeader2 string

Benutzerdefinierte Kopfzeile 2. Im Format angeben: Headername: Headerwert

CustomHeader3
CustomHeader3 string

Benutzerdefinierte Kopfzeile 3. Im Format angeben: Headername: Headerwert

CustomHeader4
CustomHeader4 string

Benutzerdefinierte Kopfzeile 4. Im Format angeben: Headername: Headerwert

CustomHeader5
CustomHeader5 string

Benutzerdefinierte Kopfzeile 5. Im Format angeben: Headername: Headerwert

Gibt zurück

Definitionen

GraphTrending

Trending documents from Graph API

Name Pfad Typ Beschreibung
Id
id string

Eindeutiger Bezeichner der Beziehung

Weight
weight float

Wert, der angibt, wie viel das Dokument aktuell im Trend ist

Ressourcenvisualisierung
resourceVisualization resourceVisualization

resourceVisualization

sensitivityLabelInfo
sensitivityLabelInfo array of sensitivityLabelMetadata

resourceVisualization

resourceVisualization

Name Pfad Typ Beschreibung
Title
title string

Titeltext des Elements

Typ
type string

Der Medientyp des Elements (kann zum Filtern nach einer bestimmten Datei basierend auf einem bestimmten Typ verwendet werden)

Medientyp
mediaType string

Der Medientyp für Elemente (kann zum Filtern nach einem bestimmten Dateityp basierend auf unterstützten IANA Media MIME-Typen verwendet werden)

Vorschaubild-URL
previewImageUrl string

Eine URL, die zum Vorschaubild für das Element führt

Vorschau von Text
previewText string

Vorschautext für das Element

Containerweb-URL
containerWebUrl string

Ein Pfad, der zum Ordner führt, in dem das Element gespeichert ist

Anzeigename des Containers
containerDisplayName string

Eine Zeichenfolge, die beschreibt, wo das Element gespeichert ist

Containertyp
containerType string

Kann zum Filtern nach dem Typ des Containers verwendet werden, in dem die Datei gespeichert ist.

sensitivityLabelMetadata

Name Pfad Typ Beschreibung
sensitivityLabelId
sensitivityLabelId string

SensitivityLabel Id.

name
name string

SensitivityLabel-Name.

Anzeigename
displayName string

SensitivityLabel displayName-Informationen

Quickinfo
tooltip string

SensitivityLabel-Details zu QuickInfos.

priority
priority integer

Vertraulichkeitsbezeichnungspriorität.

color
color string

SensitivityLabel-Farbe.

istVerschlüsselt
isEncrypted boolean

ist SensitivityLabel Encrypted.

isEnabled
isEnabled boolean

Gibt an, ob SensitivityLabel aktiviert ist.

isParent
isParent boolean

Gibt an, ob SensitivityLabel übergeordnetes Element ist.

parentSensitivityLabelId
parentSensitivityLabelId string

Übergeordnete SensitivityLabel-ID.

LinklessEntityListResponse[List[Person]]

Stellt eine Liste aus der Graph-API dar.

Name Pfad Typ Beschreibung
value
value array of Person

Wert

Person

Stellt eine Person dar

Name Pfad Typ Beschreibung
Personen-ID
id string

Ein eindeutiger Bezeichner für das Person-Objekt im Verzeichnis

Anzeigename
displayName string

Der Anzeigename der Person

Vorname
givenName string

Der Vorname der Person

Surname
surname string

Der Nachname der Person

Geburtstag
birthday string

Geburtstag der Person

Personennotizen
personNotes string

Freiformnotizen, die der aktuelle Benutzer zu dieser Person gemacht hat

Ist Favorit?
isFavorite boolean

Wenn der aktuelle Benutzer diese Person als Favorit gekennzeichnet hat

Berufsbezeichnung
jobTitle string

Die Position der Person

Unternehmensname
companyName string

Der Name des Unternehmens der Person

Abteilung
department string

Die Abteilung der Person

Bürostandort
officeLocation string

Der Standort des Büros der Person

Beruf
profession string

Beruf der Person

Benutzerprinzipalname (USER Principal Name, UPN)
userPrincipalName string

Der Benutzerprinzipalname (UPN) des Benutzers. Der UPN ist ein Anmeldename im Internetstil für den Benutzer basierend auf dem Internetstandard RFC 822. In der Konvention sollte dies 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.

Chatadresse
imAddress string

VoIP-SIP-Adresse der Person

Bewertete E-Mail-Adressen
scoredEmailAddresses array of ScoredEmailAddress

Sammlung der E-Mail-Adressen der Person mit einer Relevanzbewertung

Telefone
phones array of Phone

Telefonnummern der Person

ScoredEmailAddress

Stellt eine bewertete E-Mail-Adresse dar.

Name Pfad Typ Beschreibung
E-Mail-Adresse
address string

Die E-Mail-Adresse

Relevanzbewertung
relevanceScore double

Die Relevanzbewertung der E-Mail-Adresse. Eine Relevanzbewertung wird als Sortierschlüssel im Verhältnis zu den anderen zurückgegebenen Ergebnissen verwendet. Ein höherer Relevanzbewertungswert entspricht einem relevanteren Ergebnis. Die Relevanz wird durch die Kommunikations- und Zusammenarbeitsmuster und Geschäftsbeziehungen des Benutzers bestimmt.

Telefonnummer

Stellt eine Telefonnummer dar.

Name Pfad Typ Beschreibung
Rufnummer
number string

Die Telefonnummer

Telefontyp
type string

Der Typ der Telefonnummer. Mögliche Werte: Home, Business, Mobile, other, assistant, homeFax, businessFax, otherFax, otherFax, pager, radio.

Benutzer

Stellt ein User -Objekt im Verzeichnis dar

Name Pfad Typ Beschreibung
Benutzer-ID
Id string

Ein eindeutiger Bezeichner für das Benutzerobjekt im Verzeichnis.

Konto aktiviert?
AccountEnabled boolean

true, wenn das Konto aktiviert ist; andernfalls "false". Diese Eigenschaft ist erforderlich, wenn ein Benutzer erstellt wird.

Telefone für Unternehmen
BusinessPhones array of string

Eine Liste der Geschäftlichen Telefonnummern für den Benutzer

Stadt
City string

Die Stadt, in der sich der Benutzer befindet.

Unternehmensname
CompanyName string

Der Name des Unternehmens, in dem der Benutzer arbeitet.

Country
Country string

Das Land/die Region, in dem sich der Benutzer befindet; z. B. "US" oder "UK".

Abteilung
Department string

Der Name der Abteilung, in der der Benutzer arbeitet.

Anzeigename
DisplayName string

Der Name des Benutzers, der im Adressbuch angezeigt wird. Dies ist in der Regel die Kombination aus vornamen, vornamen und nachname des Benutzers. Diese Eigenschaft ist erforderlich, wenn ein Benutzer erstellt wird und während updates nicht gelöscht werden kann.

Vorname
GivenName string

Der Vorname des Benutzers.

Berufsbezeichnung
JobTitle string

Die Position des Benutzers.

Email
Mail string

Die SMTP-/E-Mail-Adresse für den Benutzer, z. B. "jeff@contoso.onmicrosoft.com". Schreibgeschützt.

Spitzname
MailNickname string

Der E-Mail-Alias für den Benutzer. Diese Eigenschaft muss beim Erstellen eines Benutzers angegeben werden.

Bürostandort
OfficeLocation string

Der Bürostandort der Firma des Benutzers

Postleitzahl
PostalCode string

Die Postleitzahl für die Postanschrift des Benutzers. Die Postleitzahl ist für das Land/die Region des Benutzers spezifisch. In den USA enthält dieses Attribut den ZIP Code.

Surname
Surname string

Der Nachname des Benutzers.

Telefonnummer
TelephoneNumber string

Die Nummer des primären Mobiltelefons für den Benutzer.

Benutzerprinzipalname (USER Principal Name, UPN)
UserPrincipalName string

Der Benutzerprinzipalname (UPN) des Benutzers. Der UPN ist ein Anmeldename im Internetstil für den Benutzer basierend auf dem Internetstandard RFC 822. In der Konvention sollte dies 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.

ClientPhotoMetadata

Photo Metadata-Klasse

Name Pfad Typ Beschreibung
Hat Foto
HasPhoto boolean

Hat Foto

Höhe
Height integer

Höhe des Fotos

Breite
Width integer

Breite des Fotos

Inhaltstyp
ContentType string

Inhaltstyp des Fotos

Bilddateierweiterung
ImageFileExtension string

Dateierweiterung für das Foto (z. B. ".jpg")

EntityListResponse[IReadOnlyList[User]]

Klasse, die entitätslistenantwort von einer Office-API darstellt.

Name Pfad Typ Beschreibung
value
value array of User

Wert

@odata.nextLink
@odata.nextLink string

Link zur nächsten Seite

GraphUser_V1

Benutzer aus Graph-API

Name Pfad Typ Beschreibung
Über mich
aboutMe string

Über mich

Konto aktiviert?
accountEnabled boolean

true, wenn das Konto aktiviert ist; andernfalls "false". Diese Eigenschaft ist erforderlich, wenn ein Benutzer erstellt wird.

Geburtstag
birthday date-time

Geburtstag

Telefone für Unternehmen
businessPhones array of string

Telefone für Unternehmen

Stadt
city string

Die Stadt, in der sich der Benutzer befindet.

Unternehmensname
companyName string

Der Name des Unternehmens, in dem der Benutzer arbeitet.

Country
country string

Das Land/die Region, in dem sich der Benutzer befindet; z. B. "US" oder "UK".

Abteilung
department string

Der Name der Abteilung, in der der Benutzer arbeitet.

Anzeigename
displayName string

Anzeigename

Vorname
givenName string

Vorname

Einstellungsdatum
hireDate date-time

Einstellungsdatum

Id
id string

Id

Interessen
interests array of string

Interessen

Position
jobTitle string

Position

Mail
mail string

Mail

Spitzname
mailNickname string

Der E-Mail-Alias für den Benutzer. Diese Eigenschaft muss beim Erstellen eines Benutzers angegeben werden.

Mobiltelefon
mobilePhone string

Mobiltelefon

Meine Website
mySite string

Meine Website

Bürostandort
officeLocation string

Bürostandort

Vergangene Projekte
pastProjects array of string

Vergangene Projekte

Postleitzahl
postalCode string

Die Postleitzahl für die Postanschrift des Benutzers. Die Postleitzahl ist für das Land/die Region des Benutzers spezifisch. In den USA enthält dieses Attribut den ZIP Code.

Bevorzugte Sprache
preferredLanguage string

Bevorzugte Sprache

Bevorzugter Name
preferredName string

Bevorzugter Name

Verantwortlichkeiten
responsibilities array of string

Verantwortlichkeiten

Schulen
schools array of string

Schulen

Fähigkeiten
skills array of string

Fähigkeiten

Staat
state string

Staat

Anschrift
streetAddress string

Anschrift

Surname
surname string

Surname

Benutzerprinzipalname
userPrincipalName string

Benutzerprinzipalname

Benutzertyp
userType string

Benutzertyp

ObjectWithoutType

binär

Dies ist der grundlegende Datentyp "binary".