orgContact-Ressourcentyp

Namespace: microsoft.graph

Stellt einen Organisationskontakt dar. Organisationskontakte werden von den Administratoren eines organization verwaltet und unterscheiden sich von persönlichen Kontakten. Darüber hinaus werden Organisationskontakte entweder aus lokalen Verzeichnissen oder aus Exchange Online synchronisiert und sind 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 Auflisten der Eigenschaften von Organisationskontakten.
Organisationskontakt abrufen orgContact Lesen von Eigenschaften und Beziehungen eines Organisationskontakts.
Organisationshierarchie
Manager abrufen directoryObject Rufen Sie den Vorgesetzten des Organisationskontakts ab.
List directReports directoryObject collection Listen Sie die direkten Berichte des Organisationskontakts auf.
List memberOf directoryObject collection Listet die Gruppen auf, in der ein Organisationskontakt Mitglied ist.
List transitiveMemberOf directoryObject-Sammlung Listen Sie die Gruppen auf, in denen ein Organisationskontakt Mitglied ist, einschließlich der 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 String collection Gibt eine Liste von directoryObjects zurück, in der 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 Verzeichnisobjekte.

Eigenschaft Typ Beschreibung
Adressen physicalOfficeAddress-Sammlung Postadressen für diesen Organisationskontakt. Derzeit kann ein Kontakt nur eine physische Adresse haben.
CompanyName String Name des Unternehmens, zu dem dieser Organisationskontakt gehört. Unterstützt $filter (eq, , notne, ge, le, in, startsWithund eq für null Werte).
department Zeichenfolge Der Name für die Abteilung, in der der Kontakt arbeitet. Unterstützt $filter (eq, , notne, ge, le, in, startsWithund eq für null Werte).
displayName Zeichenfolge Anzeigename für diesen Organisationskontakt. Unterstützt $filter (eq, , notne, ge, le, in, startsWithund eq für null Werte), $searchund $orderby.
givenName Zeichenfolge Vorname für diesen Organisationskontakt. Unterstützt $filter (eq, , notne, ge, le, in, startsWithund eq für null Werte).
id Zeichenfolge Eindeutiger Bezeichner für diesen Organisationskontakt. Unterstützt $filter (eq, ne, not, in).
jobTitle Zeichenfolge Stellenbezeichnung für diesen Organisationskontakt. Unterstützt $filter (eq, , notne, ge, le, in, startsWithund eq für null Werte).
mail Zeichenfolge Die SMTP-Adresse für den Kontakt, z. B. "jeff@contoso.com". Unterstützt $filter (eq, , notne, ge, le, in, startsWithund eq für null Werte).
mailNickname Zeichenfolge Email Alias (Teil der E-Mail-Adresse, der das @-Symbol aussteht) für diesen Organisationskontakt. Unterstützt $filter (eq, , notne, ge, le, in, startsWithund eq für null Werte).
serviceProvisioningErrors serviceProvisioningError-Sammlung Von einem Verbunddienst veröffentlichte Fehler, die einen nicht vorübergehenden, dienstspezifischen Fehler in Bezug auf die Eigenschaften oder den Link eines Organisationskontaktobjekts beschreiben.

Unterstützt $filter (eq, not, für isResolved und serviceInstance).
onPremisesLastSyncDateTime DateTimeOffset Datum und Uhrzeit der letzten Synchronisierung dieses Organisationskontakts aus dem lokalen AD. Diese Datums- und Uhrzeitinformationen verwenden das ISO 8601-Format und sind 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 Fehler bei der Synchronisierungsbereitstellung für diesen Organisationskontakt. Unterstützt $filter (eq, not für category und propertyCausingError), /$count eq 0, /$count ne 0.
onPremisesSyncEnabled Boolesch 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 wird und jetzt in Exchange als Master verwendet wird; null , wenn dieses Objekt noch nie aus einem lokalen Verzeichnis synchronisiert wurde (Standard).

Unterstützt $filter (eq, ne, not, inund eq für null -Werte).
phones phone-Sammlung Liste der Telefone für diesen Organisationskontakt. Die Telefontypen können "Mobile", "Business" und "businessFax" sein. Nur ein Typ kann in der Auflistung 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, le, startsWith, /$count eq 0, /$count ne 0).
surname Zeichenfolge Nachname für diesen Organisationskontakt. Unterstützt $filter (eq, , notne, ge, le, in, startsWithund 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. Nullwerte zulassend. Unterstützt $expand.
manager directoryObject Der Benutzer oder Kontakt, bei dem es sich um den Vorgesetzten dieses Kontakts handelt. Schreibgeschützt. Unterstützt $expand und $filter (eq) nach ID.
memberOf directoryObject collection Gruppen, in denen dieser Kontakt Mitglied ist. Schreibgeschützt. Nullwerte zulassend. 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

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

{
  "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"],
  "serviceProvisioningErrors": [
    { "@odata.type": "microsoft.graph.serviceProvisioningXmlError" }
  ],
  "surname": "string"
}