orgContact-Ressourcentyp
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 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-Sammlung | Auflisten der Eigenschaften von Organisationskontakten. |
Organisationskontakt abrufen | orgContact | Lesen von Eigenschaften und Beziehungen des orgContact-Objekts. |
Organisationshierarchie | ||
Manager abrufen | directoryObject | Rufen Sie den Vorgesetzten des Kontakts ab. |
transitiveReports abrufen | Ganzzahl | Ruft die Anzahl der transitiven Berichte für einen organization Kontakt aus der transitiveReports-Navigationseigenschaft ab. |
List directReports | directoryObject collection | Listen Sie die direkten Berichte des Kontakts auf. |
List memberOf | directoryObject collection | Ruft eine memberOf-Objektauflistung ab. |
checkMemberGroups | String collection | Überprüfen Sie die Gruppenmitgliedschaft. |
getMemberGroups | String collection | Gibt alle Gruppen zurück, in denen der angegebene Kontakt Mitglied ist. |
checkMemberObjects | String-Sammlung | Überprüfen Sie die Mitgliedschaft in Gruppen, Verwaltungseinheiten und Verzeichnisrollen. |
getMemberObjects | String collection | Rufen Sie die Liste der Gruppen, Verwaltungseinheiten 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 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 , , not ne , ge , le , in , startsWith und eq für null Werte). |
department | Zeichenfolge | Der Name für die Abteilung, in der der Kontakt arbeitet. Unterstützt $filter (eq , , not ne , ge , le , in , startsWith und eq für null Werte). |
displayName | Zeichenfolge | Anzeigename für diesen Organisationskontakt. Unterstützt $filter (eq , , not ne , ge , le , in , startsWith und eq für null Werte), $search und $orderby . |
givenName | Zeichenfolge | Vorname für diesen Organisationskontakt. Unterstützt $filter (eq , , not ne , 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 | Stellenbezeichnung für diesen Organisationskontakt. Unterstützt $filter (eq , , not ne , ge , le , in , startsWith und eq für null Werte). |
Zeichenfolge | Die SMTP-Adresse für den Kontakt, z. B. "jeff@contoso.com". Unterstützt $filter (eq , , not ne , ge , le , in , startsWith und 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 , , not ne , ge , le , in , startsWith und eq für null Werte). |
onPremisesLastSyncDateTime | DateTimeOffset | Datum und Uhrzeit der letzten Synchronisierung dieses Organisationskontakts aus dem lokalen 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 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 gemastert wird; NULL , wenn dieses Objekt noch 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. Die Telefontypen können "Mobile", "Business" und "businessFax" sein. Nur ein Typ kann in der Auflistung 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 | Von einem Verbunddienst veröffentlichte Fehler, die einen nicht vorübergehenden, dienstspezifischen Fehler in Bezug auf die Eigenschaften oder den Link eines orgContact-Objekts beschreiben. Unterstützt $filter (eq , not , für isResolved und serviceInstance). |
surname | Zeichenfolge | Nachname für diesen Organisationskontakt. Unterstützt $filter (eq , , not ne , 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. 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 . |
transitiveReports | directoryObject-Sammlung | Die transitiven Berichte für einen Kontakt. Schreibgeschützt. |
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"
}
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für