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 | ||
Enumerar contactos de la organización | orgContact | Enumera las propiedades de los contactos de la organización. |
Obtener contacto de la organización | orgContact | Lee las propiedades y las relaciones de un contacto de la organización. |
Jerarquía organizativa | ||
Obtener administrador | directoryObject | Obtenga el administrador del contacto de la organización. |
Enumerar directReports | Colección directoryObject | Enumere los informes directos del contacto de la organización. |
Enumerar memberOf | Colección directoryObject | Enumere los grupos de los que es miembro un contacto de la organización. |
List transitiveMemberOf | 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. |
checkMemberGroups | Colección string | Compruebe si hay pertenencia a grupos. |
getMemberGroups | Colección string | Devuelve todos los grupos de los que es miembro el contacto organizativo especificado. |
getMemberObjects | Colección string | Devuelve una lista de directoryObjects de los que es miembro el contacto organizativo. |
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 startsWith eq para valoresnull ). |
department | Cadena | Nombre del departamento en el que funciona el contacto. Admite $filter (eq , ne , not , ge , le , in , y startsWith eq para valoresnull ). |
displayName | Cadena | Nombre para mostrar de este contacto organizativo. Admite $filter (eq , ne , not , ge , le , in , startsWith y eq para los null valores ), $search y $orderby . |
givenName | Cadena | Nombre de este contacto organizativo. Admite $filter (eq , ne , not , ge , le , in , y startsWith eq 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 startsWith eq para valoresnull ). |
Cadena | La dirección SMTP del contacto, por ejemplo, "jeff@contoso.com". Admite $filter (eq , ne , not , ge , le , in , y startsWith eq para valoresnull ). |
|
mailNickname | Cadena | Email alias (parte de la dirección de correo electrónico pendiente del símbolo @) para este contacto de la organización. Admite $filter (eq , ne , not , ge , le , in , y startsWith eq 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 , in y 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 startsWith eq 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 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 identificador. |
memberOf | Colección directoryObject | Grupos de los que es miembro este contacto. Solo lectura. Admite valores 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"
}
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de