orgContact tipo de recurso

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

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 un tipo abierto que permite propiedades adicionales además de las documentadas aquí.

Métodos

Método Tipo de valor devuelto Descripción
Contactos de la organización
Lista orgColección de contactos Enumerar las propiedades de los contactos de la organización.
Get orgContact Lea las propiedades y relaciones del objeto orgContact.
Obtener delta orgColección de contactos Obtenga contactos de la organización recién creados, actualizados o eliminados sin tener que realizar una lectura completa de toda la colección.
Obtener 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 Recuperar la lista de grupos y unidades administrativas de los que es miembro el contacto. La comprobación es transitiva.
Lista de miembros transitivos de Colección directoryObject Enumera los grupos de los que es miembro un contacto de la organización, incluidos los grupos en los que está anidado el contacto de la organización.
Comprobar grupos de miembro Colección string Comprobar si un contacto de la organización es miembro de una lista de grupos. La comprobación es transitiva.
Obtener grupos de miembro Colección string Devuelva todos los grupos de los que sea miembro el contacto de la organización. La comprobación es transitiva.
Comprobar objetos miembro Colección string Comprobar si un contacto de la organización es miembro de una lista de grupos, rol de directorio u objetos de unidad administrativa.
Obtener objetos de miembro Colección string Devuelva todos los grupos, unidades administrativas y roles de directorio de los que sea miembro el contacto de la organización. La comprobación es transitiva.
Reintento de aprovisionamiento del servicio Ninguno Reintente el aprovisionamiento del servicio orgContact.
Obtener informes transitivos Entero Obtenga el recuento de informes transitivos de un contacto de la organización desde la propiedad de navegación transitiveReports.
Comportamiento de sincronización local (origen de autoridad)
Get onPremisesSyncBehavior Compruebe si el origen de autoridad (SOA) del objeto de contacto es el Active Directory local o en la nube.
Actualizar onPremisesSyncBehavior Actualice el origen de autoridad (SOA) del objeto de contacto a la nube o a Active Directory local local.
Jerarquía organizativa
Obtener administrador directoryObject Obtener el administrador del contacto.
Enumerar subordinados Colección directoryObject Enumera los subordinados directos del contacto.

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 de la organización. Por ahora, un contacto solo puede tener una dirección física.
CompanyName String Nombre de la empresa a la que pertenece este contacto de la organización. Admite $filter (eq, ne, not, inlestartsWithgey para eqnull valores).
department Cadena El nombre del departamento en el que trabaja el contacto. Admite $filter (eq, ne, not, inlestartsWithgey para eqnull valores).
displayName Cadena Nombre para mostrar de este contacto de la organización. La longitud máxima es de 256 caracteres. Admite $filter (eq, ne, not, ingelestartsWithy eq para null valores), $searchy .$orderby
givenName Cadena Nombre de este contacto de la organización. Admite $filter (eq, ne, not, inlestartsWithgey para eqnull valores).
id Cadena Identificador único de este contacto de la organización. Admite $filter (eq, ne, not y in).
jobTitle Cadena Puesto de trabajo para este contacto de la organización. Admite $filter (eq, ne, not, inlestartsWithgey para eqnull valores).
mail Cadena La dirección SMTP del contacto, por ejemplo, "jeff@contoso.com". Admite $filter (eq, ne, not, inlestartsWithgey para eqnull valores).
mailNickname Cadena Alias de Email (parte de la dirección de correo electrónico que tiene pendiente el símbolo @) para este contacto de la organización. Admite $filter (eq, ne, not, inlestartsWithgey para eqnull valores).
onPremisesLastSyncDateTime DateTimeOffset Fecha y hora en que este contacto de la organización se sincronizó por última vez desde el AD local. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y está siempre 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 errores de aprovisionamiento de sincronización para 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 se sincroniza y ahora se masteriza en Exchange; Valor Null si este objeto nunca se ha sincronizado desde un directorio local (valor predeterminado).

Admite $filter (eq, ne, notin, y eq para null valores).
phones Colección phone Lista de teléfonos para este contacto de la organización. Los tipos de teléfono pueden ser móvil, empresa y businessFax. Solo uno de cada tipo puede estar presente en la colección. Admite $filter (eq, ne, not y in).
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).
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 el enlace de un objeto orgContact.
Admite $filter (eq, not, para isResolved y serviceInstance).
surname Cadena Apellido de este contacto de la organización. Admite $filter (eq, ne, not, ge, lestartsWithin, , y para eqnull valores)

Relaciones

Relación Tipo Descripción
directReports Colección directoryObject Los informes directos del contacto. (Los usuarios y contactos que tienen su propiedad de administrador establecida en este contacto). Solo lectura. Admite valores NULL. Admite $expand.
manager directoryObject El usuario o contacto que es el administrador de este contacto. Solo lectura. Admite $expand y $filter (eq) por id.
memberOf Colección directoryObject Grupos de los que este contacto es miembro. Solo lectura. Admite valores NULL. Admite $expand.
onPremisesSyncBehavior onPremisesSyncBehavior Indica el estado de sincronización de un orgContact entre la nube y Active Directory local local. Solo es compatible $filter con funcionalidades de consulta avanzadas, por ejemplo, $filter=onPremisesSyncBehavior/isCloudManaged eq true&$count=true.
transitiveReports Colección directoryObject Los informes transitivos de un contacto. Solo lectura.

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"
}
  • Last updated on