orgContact-Ressourcentyp

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Stellt einen Organisationskontakt dar. Organisationskontakte werden von den Administratoren einer Organisation verwaltet und unterscheiden sich von persönlichen Kontakten. Darüber hinaus werden Organisationskontakte entweder aus lokalen Verzeichnissen oder aus Exchange Online synchronisiert und in Microsoft Graph schreibgeschützt.

Erbt von directoryObject.

Diese Ressource unterstützt die Verwendung einer Delta-Abfrage zum Nachverfolgen von inkrementellen Hinzufügungen, Löschungen und Aktualisierungen durch Bereitstellen einer delta-Funktion. Diese Ressource ist ein offener Typ, mit dem andere Eigenschaften übergeben werden können.

Methoden

Methode	Rückgabetyp	Beschreibung
Organisationskontakte
Organisationskontakte auflisten	orgContact-Sammlung	Eigenschaften von Organisationskontakten auflisten.
Organisationskontakt abrufen	orgContact	Dient zum Lesen der Eigenschaften und der Beziehungen des orgContact-Objekts.
Organisationshierarchie
Manager abrufen	directoryObject	Rufen Sie den Vorgesetzten des Kontakts ab.
transitiveReports abrufen	Ganzzahl	Rufen Sie die Anzahl der transitiven Berichte für einen Organisationskontakt aus der transitiveReports-Navigationseigenschaft ab.
List directReports	directoryObject collection	Listet die direkten Berichte des Kontakts auf.
List memberOf	directoryObject-Sammlung	Dient zum Abrufen einer memberOf-Objektauflistung.
checkMemberGroups	Zeichenfolgensammlung	Überprüfen Sie die Gruppenmitgliedschaft.
getMemberGroups	Zeichenfolgenauflistung	Gibt alle Gruppen zurück, in denen der angegebene Kontakt Mitglied ist.
checkMemberObjects	String-Sammlung	Überprüfen Sie die Mitgliedschaft in Gruppen, administrativen Einheiten und Verzeichnisrollen.
getMemberObjects	Zeichenfolgenauflistung	Rufen Sie die Liste der Gruppen, administrativen Einheiten und Verzeichnisrollen ab, in der der Kontakt Mitglied ist.

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 Azure AD-Verzeichnisobjekte.

Eigenschaft	Typ	Beschreibung
Adressen	physicalOfficeAddress-Sammlung	Postadressen für diesen Organisationskontakt. Vorerst kann ein Kontakt nur eine physische Adresse haben.
CompanyName	String	Name des Unternehmens, zu dem dieser Organisationskontakt gehört. Unterstützt $filter (eq, ne, not, ge, le, in, startsWith und eq für null-Werte).
department	Zeichenfolge	Der Name der Abteilung, in der der Kontakt arbeitet. Unterstützt $filter (eq, ne, not, ge, le, in, startsWith und eq für null-Werte).
displayName	Zeichenfolge	Anzeigename für diesen Organisationskontakt. Unterstützt $filter (eq, ne, not, ge, le, in, startsWith und eq für null-Werte), $search und $orderBy.
givenName	Zeichenfolge	Vorname für diesen Organisationskontakt. Unterstützt $filter (eq, ne, not, ge, le, in, startsWith und eq für null-Werte).
id	Zeichenfolge	Eindeutiger Bezeichner für diesen Organisationskontakt. Unterstützt $filter (eq, ne, not, in).
jobTitle	Zeichenfolge	Position für diesen Organisationskontakt. Unterstützt $filter (eq, ne, not, ge, le, in, startsWith und eq für null-Werte).
mail	Zeichenfolge	Die SMTP-Adresse für den Kontakt, z. B. "jeff@contoso.onmicrosoft.com". Unterstützt $filter (eq, ne, not, ge, le, in, startsWith und eq für null-Werte).
mailNickname	Zeichenfolge	E-Mail-Alias (Teil der E-Mail-Adresse, der vor dem @-Symbol steht) für diesen Organisationskontakt. Unterstützt $filter (eq, ne, not, ge, le, in, startsWith und eq für null-Werte).
onPremisesLastSyncDateTime	DateTimeOffset	Datum und Uhrzeit der letzten Synchronisierung dieses Organisationskontakts aus lokalem AD. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z. Unterstützt $filter (eq, ne, not, ge, le, in).
onPremisesProvisioningErrors	onPremisesProvisioningError-Sammlung	Liste aller Synchronisierungsbereitstellungsfehler für diesen Organisationskontakt. Unterstützt $filter (eq, not).
onPremisesSyncEnabled	Boolean	true, wenn dieses Objekt aus einem lokalen Verzeichnis synchronisiert wird; false, wenn dieses Objekt ursprünglich aus einem lokalen Verzeichnis synchronisiert wurde, aber nicht mehr synchronisiert und jetzt in Exchange gemastert wird; null, wenn dieses Objekt nie aus einem lokalen Verzeichnis synchronisiert wurde (Standard). Unterstützt $filter (eq, ne, not, in und eq für null-Werte).
phones	phone-Sammlung	Liste der Telefone für diesen Organisationskontakt. Telefon Typen können mobil, business und businessFax sein. In der Auflistung kann immer nur ein Typ vorhanden sein. Unterstützt $filter (eq, ne, not, in).
proxyAddresses	String collection	Beispiel: "SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com". Der any-Operator ist für Filterausdrücke für mehrwertige Eigenschaften erforderlich. Unterstützt $filter (eq, not, ge, leund startsWithzählen leere Sammlungen).
surname	Zeichenfolge	Nachname für diesen Organisationskontakt. Unterstützt $filter (eq, ne, not, ge, le, in, startsWith und eq für null-Werte)

Beziehungen

Beziehung	Typ	Beschreibung
directReports	directoryObject collection	Die direkten Berichte des Kontakts. (Die Benutzer und Kontakte, deren Managereigenschaft auf diesen Kontakt festgelegt ist.) Schreibgeschützt. Lässt NULL-Werte zu. Unterstützt $expand.
manager	directoryObject	Der Benutzer oder Kontakt, bei dem es sich um den Vorgesetzten dieses Kontakts handelt. Schreibgeschützt. Unterstützt $expand.
memberOf	directoryObject collection	Gruppen, bei denen dieser Kontakt Mitglied ist. Schreibgeschützt. Lässt NULL-Werte zu. Unterstützt $expand.
transitiveReports	directoryObject-Sammlung	Die transitiven Berichte für einen Kontakt. Schreibgeschützt.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "addresses": [{"@odata.type": "microsoft.graph.physicalOfficeAddress"}],
  "companyName": "string",
  "department": "string",
  "displayName": "string",
  "givenName": "string",
  "id": "string (identifier)",
  "jobTitle": "string",
  "mail": "string",
  "mailNickname": "string",
  "onPremisesLastSyncDateTime": "string (timestamp)",
  "onPremisesProvisioningErrors": [{"@odata.type": "microsoft.graph.onPremisesProvisioningError"}],
  "onPremisesSyncEnabled": true,
  "phones": [{"@odata.type": "microsoft.graph.phone"}],
  "proxyAddresses": ["string"],
  "surname": "string"
}