Ressourcentyp orgContact

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Stellt einen Kontakt in der Organisation dar. Organisationskontakte werden von den Administratoren einer 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, der über die hier dokumentierten hinaus zusätzliche Eigenschaften zulässt.

Methoden

Methode Rückgabetyp Beschreibung
Organisationskontakte
List orgContact-Sammlung Listeneigenschaften von Organisationskontakten.
Get orgContact Lesen Sie Eigenschaften und Beziehungen des orgContact-Objekts.
Delta abrufen orgContact-Sammlung Rufen Sie neu erstellte, aktualisierte oder gelöschte Organisationskontakte ab, ohne die gesamte Sammlung vollständig lesen zu müssen.
Abrufen des Deltas für das Verzeichnisobjekt direcyoryObject-Sammlung Rufen Sie neu erstellte, aktualisierte oder gelöschte Organisationskontakte über die Verzeichnisobjektsammlung ab, ohne die gesamte Auflistung vollständig lesen zu müssen.
memberOf auflisten String collection Rufen Sie die Liste der Gruppen und Verwaltungseinheiten ab, in denen der Kontakt Mitglied ist. Die Überprüfung ist transitiv.
Auflisten transitiver Mitglieder von directoryObject collection Listen Sie die Gruppen auf, in denen ein Organisationskontakt Mitglied ist, einschließlich der Gruppen, unter denen der Organisationskontakt verschachtelt ist.
Mitgliedergruppen prüfen String collection Überprüfen Sie die Mitgliedschaft eines Organisationskontakts in einer Liste von Gruppen. Die Überprüfung ist transitiv.
Mitgliedergruppen abrufen String collection Geben Sie alle Gruppen zurück, in denen der Organisationskontakt Mitglied ist. Die Überprüfung ist transitiv.
Überprüfen von Mitgliederobjekten String collection Überprüfen Sie die Mitgliedschaft eines Organisationskontakts in einer Liste von Gruppen, Verzeichnisrollen- oder Verwaltungseinheitsobjekten.
Mitgliedsobjekte abrufen String collection Gibt alle Gruppen, Verwaltungseinheiten und Verzeichnisrollen zurück, denen der Organisationskontakt angehört. Die Überprüfung ist transitiv.
Dienstbereitstellung wiederholen Keine Versuchen Sie erneut, den orgContact-Dienst bereitzustellen.
Transitive Berichte abrufen Integer Rufen Sie die Anzahl transitiver Berichte für einen Kontakt in einer organization über die Navigationseigenschaft transitiveReports ab.
Lokales Synchronisierungsverhalten (Quelle der Autorität)
Get onPremisesSyncBehavior Überprüfen Sie, ob die Autoritätsquelle (Source of Authority, SOA) des Kontaktobjekts die Cloud oder das lokale Active Directory ist.
Update onPremisesSyncBehavior Aktualisieren Sie die Autoritätsquelle (Source of Authority, SOA) des Kontaktobjekts in die Cloud oder in das lokale Active Directory.
Organisationshierarchie
Manager abrufen directoryObject Wenden Sie sich an den Manager des Kontakts.
Mitarbeiter auflisten directoryObject collection Listen Sie die direkt unterstellten Mitarbeiter des Kontakts auf.

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 Postanschriften für diesen organisatorischen Kontakt. Derzeit kann ein Kontakt nur eine physische Adresse haben.
CompanyName String Name des Unternehmens, zu dem dieser organisatorische Kontakt gehört. Unterstützt $filter (eq, ne, not, ge, le, instartsWith, , und eq für null Werte).
department Zeichenfolge Der Name für die Abteilung, in der der Kontakt funktioniert. Unterstützt $filter (eq, ne, not, ge, le, instartsWith, , und eq für null Werte).
displayName Zeichenfolge Anzeigename für diesen Kontakt in der Organisation. Die maximale Länge beträgt 256 Zeichen. Unterstützt $filter (eq, ne, not, ge, le, instartsWith, und eq für null Werte), $search, und $orderby.
givenName Zeichenfolge Vorname für diesen organisatorischen Kontakt. Unterstützt $filter (eq, ne, not, ge, le, instartsWith, , und eq für null Werte).
id Zeichenfolge Eindeutiger Bezeichner für diesen Kontakt in der Organisation. Unterstützt $filter (eq, ne, not, in).
jobTitle Zeichenfolge Stellenbezeichnung für diesen Organisationskontakt. Unterstützt $filter (eq, ne, not, ge, le, instartsWith, , und eq für null Werte).
mail Zeichenfolge Die SMTP-Adresse für den Kontakt, z. B. "".jeff@contoso.com Unterstützt $filter (eq, ne, not, ge, le, instartsWith, , und eq für null Werte).
mailNickname Zeichenfolge Email Alias (Teil der E-Mail-Adresse vor dem @-Symbol) für diesen Kontakt in der Organisation an. Unterstützt $filter (eq, ne, not, ge, le, instartsWith, , und eq für null Werte).
onPremisesLastSyncDateTime DateTimeOffset Datum und Uhrzeit, wann dieser Organisationskontakt zuletzt aus dem lokalen AD synchronisiert wurde. 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 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 Boolean true , wenn dieses Objekt aus einem lokalen Verzeichnis synchronisiert wird; falsch , 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 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. Telefontypen können Mobile, Business und BusinessFax sein. Nur einer von jedem Typ kann jemals in der Sammlung 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, le, startsWith, /$count eq 0, /$count ne 0).
serviceProvisioningErrors serviceProvisioningError-Sammlung Fehler, die von einem Verbunddienst veröffentlicht wurden und einen nicht vorübergehenden, dienstspezifischen Fehler in Bezug auf die Eigenschaften oder den Link von einem orgContact-Objekt beschreiben.
Unterstützt $filter (eq, not, für isResolved und serviceInstance).
surname Zeichenfolge Nachname für diesen Kontakt in der Organisation. Unterstützt $filter (eq, ne, not, lege, , instartsWith, und eq für null Werte)

Beziehungen

Beziehung Typ Beschreibung
directReports directoryObject collection Die direkten Mitarbeiter des Kontakts. (Die Benutzer und Kontakte, deren Manager-Eigenschaft auf diesen Kontakt festgelegt ist.) Schreibgeschützt. Nullwerte zulassend. Unterstützt $expand.
manager directoryObject Der Benutzer oder Kontakt, der der Manager dieses Kontakts ist. 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.
onPremisesSyncBehavior onPremisesSyncBehavior Gibt den Status der Synchronisierung für einen orgContact zwischen der Cloud und dem lokalen Active Directory an. Unterstützt $filter nur erweiterte Abfragefunktionen, z. B. $filter=onPremisesSyncBehavior/isCloudManaged eq true&$count=true. .
transitiveReports directoryObject-Sammlung Die transitiven Berichte für einen Kontakt. Schreibgeschützt.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht 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"
}
  • Last updated on