Compartir a través de


Tipo de recurso orgContact

Espacio de nombres: microsoft.graph

Representa un contacto de la organización. Los contactos de la organización los administran los administradores de una organización y son diferentes de los contactos personales. Además, los contactos de la organización se sincronizan desde directorios locales o desde Exchange Online y son de solo lectura en Microsoft Graph.

Se hereda de directoryObject.

Este recurso es compatible con el uso de una consulta delta para realizar un seguimiento de las adiciones incrementales, las eliminaciones y las actualizaciones proporcionando una función delta. Este recurso es de tipo abierto y permite que pasen otras propiedades.

Methods

Método Tipo de valor devuelto Descripción
Contactos de la organización
Lista orgContact Enumera las propiedades de los contactos de la organización.
Get orgContact Lee las propiedades y las relaciones de un contacto de la organización.
Obtener delta OrgContact (colección) Obtenga contactos de la organización recién creados, actualizados o eliminados sin tener que realizar una lectura completa de toda la colección.
Obtención de delta para el objeto de directorio colección direcyoryObject Obtenga contactos de la organización recién creados, actualizados o eliminados a través de la colección de objetos de directorio sin tener que realizar una lectura completa de toda la colección.
Enumerar miembro de Colección string Recupere la lista de grupos y unidades administrativas de las que es miembro el contacto. La comprobación es transitiva.
Enumeración de miembros transitivos de Colección directoryObject Enumere los grupos de los que es miembro un contacto organizativo, incluidos los grupos en los que está anidado el contacto organizativo.
Comprobar grupos de miembro Colección string Compruebe si hay pertenencia a un contacto de la organización en una lista de grupos. La comprobación es transitiva.
Obtener grupos de miembro Colección de cadenas Devuelve todos los grupos de los que es miembro el contacto de la organización. La comprobación es transitiva.
Comprobación de objetos miembro Colección de cadenas Compruebe si hay pertenencia a un contacto de la organización en una lista de grupos, rol de directorio u objetos de unidad administrativa.
Obtener objetos de miembro Colección de cadenas Devuelve todos los grupos, unidades administrativas y roles de directorio de los que es miembro el contacto de la organización. La comprobación es transitiva.
Reintentar el aprovisionamiento del servicio Ninguno Vuelva a intentar el aprovisionamiento del servicio orgContact.
Jerarquía organizativa
Obtener administrador directoryObject Obtenga el administrador del contacto de la organización.
Enumerar subordinados Colección directoryObject Enumere los informes directos del contacto de la organización.

Propiedades

Importante

El uso específico de $filter y el parámetro de consulta $search solo se admite cuando se usa el encabezado ConsistencyLevel establecido en eventual y $count. Para obtener más información, vea Funcionalidades avanzadas de consulta en objetos de directorio.

Propiedad Tipo Descripción
Direcciones colección physicalOfficeAddress Direcciones postales de este contacto organizativo. Por ahora, un contacto solo puede tener una dirección física.
CompanyName String Nombre de la empresa a la que pertenece este contacto organizativo. Admite $filter (eq, ne, not, ge, le, in, y startsWitheq para valoresnull).
department Cadena Nombre del departamento en el que funciona el contacto. Admite $filter (eq, ne, not, ge, le, in, y startsWitheq para valoresnull).
displayName Cadena Nombre para mostrar de este contacto organizativo. Admite $filter (eq, ne, not, ge, le, in, startsWithy eq para los null valores ), $searchy $orderby.
givenName Cadena Nombre de este contacto organizativo. Admite $filter (eq, ne, not, ge, le, in, y startsWitheq para valoresnull).
id Cadena Identificador único de este contacto organizativo. Admite $filter (eq, ne, not y in).
jobTitle Cadena Puesto de trabajo para este contacto organizativo. Admite $filter (eq, ne, not, ge, le, in, y startsWitheq para valoresnull).
mail Cadena La dirección SMTP del contacto, por ejemplo, "jeff@contoso.com". Admite $filter (eq, ne, not, ge, le, in, y startsWitheq para valoresnull).
mailNickname Cadena Alias de correo electrónico (parte de la dirección de correo electrónico pendiente previamente del símbolo @) para este contacto de la organización. Admite $filter (eq, ne, not, ge, le, in, y startsWitheq para valoresnull).
serviceProvisioningErrors colección serviceProvisioningError Errores publicados por un servicio federado que describen un error no transitorio específico del servicio con respecto a las propiedades o vínculos de un objeto de contacto de la organización .

Admite $filter (eq, not, para isResolved y serviceInstance).
onPremisesLastSyncDateTime DateTimeOffset Fecha y hora en que este contacto organizativo se sincronizó por última vez desde AD local. Esta información de fecha y hora usa el formato ISO 8601 y siempre está en hora UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z. Admite $filter (eq, ne, not, ge, le y in).
onPremisesProvisioningErrors Colección OnPremisesProvisioningError Lista de los errores de aprovisionamiento de sincronización de este contacto de la organización. Admite $filter (eq, not para category y propertyCausingError), /$count eq 0, /$count ne 0.
onPremisesSyncEnabled Booleano true si este objeto se sincroniza desde un directorio local; false si este objeto se sincronizó originalmente desde un directorio local, pero ya no está sincronizado y ahora se ha masterizado en Exchange; null si este objeto nunca se ha sincronizado desde un directorio local (valor predeterminado).

Admite $filter (eq, ne, not, iny eq para valores null ).
phones Colección phone Lista de teléfonos para este contacto de la organización. Los tipos de teléfono pueden ser móviles, empresariales y businessFax. Solo uno de cada tipo puede estar presente en la colección.
proxyAddresses Colección string Por ejemplo: "SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com". El operador any es necesario para las expresiones de filtro en las propiedades de varios valores. Admite $filter (eq, not, ge, le, startsWith, /$count eq 0 y /$count ne 0).
surname Cadena Apellidos de este contacto organizativo. Admite $filter (eq, ne, not, ge, le, in, y startsWitheq para valoresnull).

Relaciones

Relación Tipo Descripción
directReports Colección directoryObject Informes directos del contacto. (Los usuarios y contactos que tienen su propiedad de administrador establecida en este contacto). Solo lectura. Admite un valor NULL. Admite $expand.
manager directoryObject El usuario o contacto que es el administrador de este contacto. Solo lectura. Admite $expand y $filter (eq) por identificador.
memberOf Colección directoryObject Grupos de los que es miembro este contacto. Solo lectura. Admite un valor NULL. Admite $expand.
transitiveMemberOf Colección directoryObject Grupos de los que es miembro este contacto, incluidos los grupos en los que está anidado el contacto. Solo lectura. Admite valores NULL.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

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