orgContact-Ressourcentyp

Namespace: microsoft.graph

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 Eigenschaften von Organisationskontakten auflisten.
Organisationskontakt abrufen orgContact Dient zum Lesen von Eigenschaften und Beziehungen eines Organisationskontakts.
Organisationshierarchie
Manager abrufen directoryObject Rufen Sie den Vorgesetzten des Organisationskontakts ab.
List directReports directoryObject collection Listet die direkten Berichte des Organisationskontakts auf.
List memberOf directoryObject collection Listet die Gruppen auf, in denen ein Organisationskontakt Mitglied ist.
transitiveMemberOf auflisten directoryObject-Sammlung Auflisten der Gruppen, in denen ein Organisationskontakt Mitglied ist, einschließlich Gruppen, unter denen der Organisationskontakt geschachtelt ist.
checkMemberGroups String collection Überprüfen Sie die Gruppenmitgliedschaft.
getMemberGroups String collection Gibt alle Gruppen zurück, in denen der angegebene Organisationskontakt Mitglied ist.
getMemberObjects Zeichenfolgenauflistung Gibt eine Liste der directoryObjects zurück, in denen der Organisationskontakt 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. Diese Datums- und Uhrzeitinformationen verwenden das ISO 8601-Format und werden 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 truewenn 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.
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-Sammlung Gruppen, bei denen dieser Kontakt Mitglied ist. Schreibgeschützt. Lässt NULL-Werte zu. Unterstützt $expand.
transitiveMemberOf directoryObject collection Gruppen, in denen dieser Kontakt Mitglied ist, einschließlich Gruppen, unter denen der Kontakt geschachtelt ist. Schreibgeschützt. Nullwerte zulassend.

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"
}