tipo de recurso de grupo

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 grupo de Microsoft Entra, que puede ser un grupo de Microsoft 365, un equipo de Microsoft Teams o un grupo de seguridad. Este recurso es un tipo abierto que permite propiedades adicionales además de las documentadas aquí.

Se hereda de directoryObject.

Por motivos de rendimiento, las operaciones create, get y list devuelven solo un subconjunto de las propiedades más usadas de forma predeterminada. Estas propiedades predeterminadas se indican en la sección Propiedades. Para obtener cualquiera de las propiedades que no se devuelvan de forma predeterminada, especifíquelas en una $select opción de consulta OData.

Este recurso admite:

Los grupos de Microsoft Teams y Microsoft 365 admiten la colaboración de grupos. Puede usar la mayoría de las API de grupos de Microsoft 365 con Microsoft Teams. Para crear un equipo, primero cree un grupo y, después, agregue un equipo a él. Para obtener más información, vea la información general de Microsoft Teams.

Métodos

Método Tipo de valor devuelto Descripción
List Colección group Lee las propiedades y las relaciones de todos los objetos group.
Crear group Crear un nuevo grupo tal como se especificó. Puede ser un equipo, un grupo de seguridad, un grupo dinámico o un grupo de Microsoft 365.
Get group Lea las propiedades y las relaciones del objeto group.
Actualizar Ninguno Actualiza las propiedades de un objeto de grupo.
Upsert group Crear un grupo nuevo si no existe o actualizar las propiedades de un grupo existente.
Delete Ninguno Elimina el objeto de grupo.
Obtener delta Colección group Obtiene los cambios incrementales de grupos.
Administración de grupos
Enumerar los miembros Colección directoryObject Obtiene los usuarios y grupos que son miembros directos de este grupo desde la propiedad de navegación members.
Agregar miembro directoryObject Agregue un miembro a este grupo publicando en la propiedad de navegación de miembros (compatible solo con grupos de seguridad y grupos de Microsoft 365).
Eliminar miembro Ninguno Quite un miembro de un grupo de Microsoft 365 o un grupo de seguridad a través de la propiedad de navegación de miembros.
Enumerar propietarios Colección directoryObject Obtiene los propietarios del grupo desde la propiedad de navegación owners.
Agregar propietario directoryObject Agregue un nuevo propietario para el grupo publicando en la propiedad de navegación de propietarios (compatible solo con grupos de seguridad y grupos de Microsoft 365).
Eliminar propietario Ninguno Quite un propietario de un grupo de Microsoft 365 o un grupo de seguridad a través de la propiedad de navegación de los propietarios.
Enumerar pertenencias Colección directoryObject Obtenga los grupos, roles de administrador y unidades administrativas de los que este grupo es miembro directo de la propiedad de navegación memberOf.
Enumerar miembros transitivos Colección directoryObject Obtiene los usuarios, grupos, dispositivos y entidades de servicio que son miembros, incluidos los miembros anidados de este grupo.
Enumerar pertenencias transitivas Colección directoryObject Enumera los grupos y unidades administrativas de los que este grupo es miembro. Esta operación es transitiva e incluye los grupos de los que este grupo es un miembro anidado.
Enumerar directivas del ciclo de vida Colección de groupLifecyclePolicy Muestra las directivas de ciclo de vida del grupo.
Lista de puntos de conexión Colección endpoint Obtiene una colección de puntos de conexión.
Obtener punto de conexión endpoint Lee las propiedades y relaciones de un objeto de punto de conexión.
Asignar licencia group Agregue o quite suscripciones para el grupo. También puede habilitar y deshabilitar planes específicos asociados a una suscripción.
Evaluar pertenencia dinámica evaluateDynamicMembershipResult Evalúa si un usuario o un dispositivo es o será miembro de un grupo dinámico.
Renovar Booleano Renueva la expiración de un grupo. Cuando se renueva un grupo, la expiración del grupo se amplía por el número de días definidos en la directiva.
Validar las propiedades JSON Valide el nombre para mostrar o el apodo de correo de un grupo de Microsoft 365 que cumpla con las directivas de nomenclatura.
Obtener fuente de autoridad (SOA) onPremisesSyncBehavior Compruebe si el origen de autoridad (SOA) del objeto de grupo es el Active Directory local o en la nube.
Actualizar origen de autoridad (SOA) onPremisesSyncBehavior Actualice el origen de autoridad (SOA) del objeto de grupo a la nube o a Active Directory local local.
Asignaciones de roles de aplicación
Lista Colección appRoleAssignment Obtenga las aplicaciones y los roles de aplicación a los que se ha asignado este grupo.
Add appRoleAssignment Asigna un rol de aplicación a este grupo.
Remove Ninguno. Elimina una asignación de roles de aplicación de este grupo.
Calendario
Get calendar calendar Obtenga el calendario del grupo.
Actualizar calendario Ninguno Actualizar el calendario del grupo.
Lista de eventos Colección event Obtiene una colección de objetos de evento.
Crear evento evento Crea un evento al publicarlo en la colección de eventos.
Obtener evento evento Lee las propiedades de un objeto de evento.
Actualizar evento Ninguno Actualiza las propiedades del objeto de evento.
Eliminar evento Ninguno Elimina el objeto de evento.
Enumerar vista de calendario Colección de eventos Obtiene una colección de eventos en un intervalo de tiempo especificado.
Licencias en la nube
Enumerar derechos de uso Colección microsoft.graph.cloudLicensing.usageRight Obtener una lista de los objetos usageRight concedidos a un grupo.
Obtener el uso correcto microsoft.graph.cloudLicensing.usageRight Obtener las propiedades y relaciones de un objeto usageRight concedido a un grupo.
Conversaciones
Lista de conversaciones Colección de conversaciones Obtiene una colección de objetos de conversación.
Crear conversación conversation Crea una conversación al publicarla en la colección de conversaciones.
Obtener conversación conversación Lee las propiedades de un objeto de conversación.
Eliminar conversación Ninguno Elimina un objeto de conversación.
Lista de conversaciones Colección conversationThread Obtenga todos los hilos de un grupo.
Crear hilo Hilo de conversación Crear un nuevo hilo de conversación
Obtener conversación conversationThread Lee las propiedades de un objeto de conversación.
Actualizar conversación Ninguno Actualiza las propiedades de un objeto de conversación.
Eliminar conversación Ninguno Elimina un objeto de conversación
Enumerar remitentes aceptados Colección directoryObject Obtiene una lista de usuarios o grupos que se encuentran en la lista de remitentes aceptados de este grupo.
Agregar remitente aceptado directoryObject Agrega un usuario o grupo a la colección acceptSenders.
Eliminar remitente aceptado directoryObject Elimina a un usuario o grupo de la colección acceptedSenders.
Enumerar remitentes rechazados Colección directoryObject Obtiene una lista de usuarios o grupos que se encuentran en la lista de remitentes rechazados de este grupo.
Agregar remitente rechazado directoryObject Agrega un nuevo usuario o grupo a la colección rejectedSenders.
Quitar remitente rechazado directoryObject Elimina un usuario o grupo de la colección rejectedSenders.
Objetos de directorio
Enumerar elementos eliminados Colección directoryObject Recupere los grupos eliminados en el espacio empresarial en los últimos 30 días.
Obtener elemento eliminado Colección directoryObject Recuperar un grupo eliminado por identificador.
Restaurar elemento eliminado Colección directoryObject Restaurar un grupo eliminado en el espacio empresarial en los últimos 30 días.
Eliminar permanentemente Colección directoryObject Elimine permanentemente un grupo eliminado del espacio empresarial.
Enumerar elementos eliminados que son propiedad del usuario Colección directoryObject Recupere los grupos eliminados en el espacio empresarial en los últimos 30 días que sean propiedad de un usuario.
Comprobar grupos de miembro Colección string Comprueba la pertenencia a una lista de grupos. La función es transitiva.
Obtener grupos de miembro Colección string Devolver todos los grupos de los que es miembro el grupo. La función es transitiva.
Comprobar objetos miembro Colección de cadenas Comprobar la pertenencia en una lista de objetos de grupo, rol de directorio o unidad administrativa. La función es transitiva.
Obtener objetos de miembro Colección string Devuelva todos los grupos y unidades administrativas de los que es miembro. La función es transitiva.
Unidad de disco
Obtener unidad drive Recupere las propiedades y relaciones de un recurso Drive.
Enumerar elementos secundarios Colección driveItem Devuelve una colección de objetos driveItem en la relación secundaria de un elemento de unidad.
Configuración de grupo
Lista Colección directorySetting Enumera las propiedades de todos los objetos de configuración.
Crear directorySetting Cree un objeto de configuración basado en directorySettingTemplate. La solicitud POST debe proporcionar valores de configuración para todas las configuraciones definidas en la plantilla. Solo se pueden usar plantillas específicas de grupos para esta operación.
Get directorySetting Lee las propiedades de un objeto de configuración específico.
Actualizar Ninguno Actualiza el objeto de configuración.
Delete Ninguno Elimina un objeto de configuración.
Plantillas de configuración de lista Ninguno Enumera las propiedades de todas las plantillas de configuración.
Obtener plantilla de configuración Ninguno Lea las propiedades de una plantilla de configuración.
Notas
Enumerar los blocs de notas Colección notebook Recupera una lista de objetos de bloc de notas.
Crear bloc de notas Bloc de notas Crear un bloc de notas de OneNote.
Credenciales de inicio de sesión único basadas en contraseña
Get Colección passwordSingleSignOnCredentialSet Obtenga la lista de credenciales de inicio de sesión único basadas en contraseña para este grupo. Las contraseñas nunca se devuelven y, en su lugar, siempre se devuelven como nulas.
Delete Ninguno Elimine la credencial de inicio de sesión único basada en contraseña para una entidad de servicio determinada que esté asociada a este grupo.
nombre.
Foto de perfil
Get profilePhoto Obtenga el objeto profilePhoto especificado o sus metadatos (propiedades profilePhoto).
Actualizar Ninguno Actualiza la foto del usuario que inició sesión o el grupo o contacto especificado.
Delete Ninguno Elimine la foto de cualquier usuario del espacio empresarial, incluido el usuario que ha iniciado sesión o el grupo especificado.
Planificador
Enumerar planes Colección plannerPlan Obtener planes asignados al grupo.
Posts
Lista Colección post Obtener publicaciones en una conversación.
Get post Consigue una publicación específica.
Responder a la publicación Ninguno Responder a una entrada.
Reenviar publicación Ninguno Reenviar una publicación.
Otros recursos de grupo
Enumerar concesiones de permisos Colección de resourceSpecificPermissionGrant Enumerar los permisos concedidos a las aplicaciones para acceder al grupo.
Configuración de usuario
Agregar favorito Ninguno Agrega el grupo a la lista de grupos favoritos del usuario que ha iniciado sesión. Solo es compatible con los grupos de Microsoft 365.
Quitar favorito Ninguno Elimina el grupo de la lista de grupos favoritos del usuario que ha iniciado sesión. Solo es compatible con los grupos de Microsoft 365.
Enumerar miembro de Colección directoryObject Obtenga los grupos y las unidades administrativas de los que este usuario es miembro directo de la propiedad de navegación memberOf .
Enumerar equipos a los que se ha unido Colección group Obtiene los equipos de Microsoft Teams de los cuales el usuario es un miembro directo.
Enumerar los equipos asociados colección associatedTeamInfo Obtenga la lista de los associatedTeamInfo de Microsoft Teams a los que está asociado un usuario.
Suscripción por correo Ninguno Establece la propiedad isSubscribedByMail como true. Permite que el usuario que ha iniciado sesión pueda recibir conversaciones de correo electrónico. Solo es compatible con los grupos de Microsoft 365.
Cancelar la suscripción por correo Ninguno Establece la propiedad isSubscribedByMail como false. Deshabilitar al usuario que ha iniciado sesión para que no reciba conversaciones de correo electrónico. Solo es compatible con los grupos de Microsoft 365.
Restablecer recuento invisible Ninguno Restablezca unseenCount a 0 para todas las publicaciones que el usuario que ha iniciado sesión no ha visto desde su última visita. Solo es compatible con los grupos de Microsoft 365.

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
accessType groupAccessType Indica el tipo de acceso al grupo. Los valores posibles son none, private, secret, y public.
allowExternalSenders Booleano Indica si los usuarios externos a la organización pueden enviar mensajes al grupo. El valor predeterminado es false.

Requiere $select recuperarse. Solo se admite en la API Obtener grupo (GET /groups/{ID}).
assignedLabels Colección assignedLabel La lista de pares de etiquetas de confidencialidad (id. de etiqueta, nombre de etiqueta) asociados a un grupo de Microsoft 365 o un grupo de seguridad en la nube. Requiere una licencia de Microsoft Entra ID P1.

Requiere $select recuperarse. Esta propiedad se puede especificar durante la creación o actualización del grupo. Sin embargo, para los grupos de seguridad en la nube, es inmutable una vez que se establece. Esta propiedad solo se puede actualizar en escenarios delegados donde el autor de la llamada requiere tanto el permiso de Microsoft Graph como un rol de administrador admitido. Consulte Diferencias clave con el etiquetado de grupos de Microsoft 365 para obtener más información sobre cómo administrar esta propiedad para los grupos de seguridad de Microsoft 365 frente a los grupos de seguridad en la nube.
assignedLicenses Colección assignedLicense Licencias asignadas al grupo.

Requiere $select recuperarse. Admite $filter (eq). Solo lectura.
autoSubscribeNewMembers Booleano Indica si los nuevos miembros agregados al grupo se suscriben automáticamente para recibir notificaciones por correo electrónico. Puede establecer esta propiedad en una solicitud PATCH para el grupo; no lo establezca en la solicitud POST inicial que crea el grupo. El valor predeterminado es false.

Requiere $select recuperarse. Solo se admite en la API Obtener grupo (GET /groups/{ID}).
classification String Describe una clasificación para el grupo (como impacto empresarial bajo, medio o alto). Los valores válidos para esta propiedad se definen creando un valor de configuración ClassificationList basado en la definición de la plantilla.

Se devuelve de forma predeterminada. Admite $filter (eq, ne, not, ge, le y startsWith).
cloudLicensing microsoft.graph.cloudLicensing.groupCloudLicensing Las relaciones de un grupo con los recursos de licencias en la nube.
createdByAppId Cadena ID de la aplicación usada para crear el grupo. Puede ser nulo para algunos grupos.

Se devuelve de forma predeterminada. Solo lectura. Admite $filter (eq, ne, not, in, startsWith).
createdDateTime DateTimeOffset Marca de tiempo de cuando se creó el grupo. El valor no se puede modificar y se rellena automáticamente cuando se crea el grupo. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y siempre está en UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z.

Se devuelve de forma predeterminada. Solo lectura.
deletedDateTime DateTimeOffset Para algunos objetos de Microsoft Entra (usuario, grupo, aplicación), si se elimina el objeto, primero se elimina lógicamente y esta propiedad se actualiza con la fecha y hora en que se eliminó el objeto. En caso contrario, esta propiedad es nula. Si se restaura el objeto, esta propiedad se actualiza a null. Heredado de directoryObject.
description String Una descripción opcional del grupo.

Se devuelve de forma predeterminada. Admite $filter (eq, ne, not, ge, le, startsWith) y $search.
displayName Cadena El nombre para mostrar del grupo. Obligatorio. La longitud máxima es de 256 caracteres.

Se devuelve de forma predeterminada. Admite $filter (eq, ne, not, ge, le, in, startsWith y eq en valores null), $search y $orderby.
expirationDateTime DateTimeOffset Marca de tiempo de la fecha de expiración del grupo. Es null para grupos de seguridad, pero para los grupos de Microsoft 365, representa el momento en que el grupo está configurado para expirar como se define en groupLifecyclePolicy. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y siempre está en UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z.

Se devuelve de forma predeterminada. Admite $filter (eq, ne, not, ge, le y in). Solo lectura.
groupTypes Colección de cadena Especifica el tipo de grupo y su pertenencia.

Si la colección contiene Unified, el grupo es un grupo de Microsoft 365; de lo contrario, es un grupo de seguridad o un grupo de distribución. Para más información, vea información general de grupos.

Si la colección incluye DynamicMembership, el grupo tiene pertenencia dinámica; en caso contrario, la pertenencia es estática.

Se devuelve de forma predeterminada. Admite $filter (eq, not).
hasMembersWithLicenseErrors Boolean Indica si hay miembros de este grupo que tienen errores de licencia de la asignación de licencias basada en grupos.

Esta propiedad no se devuelve nunca en una operación GET. Puede usarla como argumento $filter para obtener grupos que tienen miembros con errores de licencia (es decir, el filtro de esta propiedad es true).

Admite $filter (eq).
hideFromAddressLists Booleano true si el grupo no se muestra en determinadas partes de la interfaz de usuario de Outlook: en la libreta de direcciones, en las listas de direcciones para seleccionar destinatarios de mensajes y en el cuadro de diálogo Examinar grupos para buscar grupos; False en caso contrario. El valor predeterminado es false.

Requiere $select recuperarse. Solo se admite en la API Obtener grupo (GET /groups/{ID}).
hideFromOutlookClients Booleano trueSi el grupo no se muestra en clientes de Outlook, como Outlook para Windows y Outlook en la Web, false en caso contrario. El valor predeterminado es false.

Requiere $select recuperarse. Solo se admite en la API Obtener grupo (GET /groups/{ID}).
id String El identificador único del grupo.

Se devuelve de forma predeterminada. Heredado de directoryObject. Clave. No admite valores NULL. Solo lectura.

Admite $filter (eq, ne, not, in).
isArchived Booleano Cuando un grupo está asociado a un equipo, esta propiedad determina si el equipo está en modo de solo lectura.
Para leer esta propiedad, use el punto de conexión /group/{groupId}/team o la API Obtener equipo. Para actualizar esta propiedad, use las API archiveTeam y unarchiveTeam.
isAssignableToRole Booleano Indica si este grupo se puede asignar a un rol de Microsoft Entra. Opcional.

Esta propiedad solo se puede establecer al crear el grupo y es invariable. Si se establece en true, la propiedad securityEnabled también debe establecerse en true, visibility debe ser Hiddeny el grupo no puede ser un grupo dinámico (es decir, groupTypes no puede contener DynamicMembership).

Solo los autores de llamadas con al menos el rol de administrador de roles con privilegios pueden establecer esta propiedad. También se debe asignar al autor de la llamada el permiso RoleManagement.ReadWrite.Directory para establecer esta propiedad o actualizar la pertenencia de dichos grupos. Para obtener más información, consulte Uso de un grupo para administrar asignaciones de roles de Microsoft Entra

El uso de esta función requiere una licencia de Microsoft Entra ID P1. Se devuelve de forma predeterminada. Admite $filter (eq, ne y not).
isFavorite Boolean Indica si el usuario marcó el grupo como favorito.
isManagementRestricted Booleano Indica si el grupo es miembro de una unidad administrativa de administración restringida. Si no se establece, el valor predeterminado es null y el comportamiento predeterminado es false. Solo lectura.

Para administrar un miembro del grupo de una unidad administrativa de administración restringida, se debe asignar al administrador o a la aplicación que llama un rol de Microsoft Entra en el ámbito de la unidad administrativa de administración restringida.
infoCatalogs Colección de cadenas Identifica los segmentos de información asignados al grupo. Se devuelve de forma predeterminada. Admite $filter (eq, not, ge, le y startsWith).
isSubscribedByMail Booleano Indica si el usuario que ha iniciado sesión está suscrito para recibir conversaciones de correo electrónico. El valor predeterminado es true.

Requiere $select recuperarse. Solo se admite en la API Obtener grupo (GET /groups/{ID}).
licenseProcessingState String Indica el estado de la asignación de licencias de grupo a todos los miembros del grupo. Valores posibles: QueuedForProcessing, ProcessingInProgress y ProcessingComplete.

Requiere $select recuperarse. Solo lectura.
mail Cadena La dirección SMTP del grupo, por ejemplo, "serviceadmins@contoso.com".

Se devuelve de forma predeterminada. Solo lectura. Admite $filter (eq, ne, not, ge, le, in, startsWith y eq en valores null).
mailEnabled Booleano Especifica si el grupo está habilitado para correo. Obligatorio.

Se devuelve de forma predeterminada. Admite $filter (eq, ne, not y eq en valores null).
mailNickname Cadena El alias de correo para el grupo, único para los grupos de Microsoft 365 en la organización. La longitud máxima es de 64 caracteres. Esta propiedad solo puede contener caracteres incluidos en el juego de caracteres ASCII de 0 a 127 con estas excepciones: @ () \ [] " ; : <> , SPACE.

Se devuelve por defecto. Admite $filter (eq, ne, not, ge, le, in y startsWith).
membershipRule String Regla que determina los miembros de este grupo si el grupo es un grupo dinámico (groupTypes contiene DynamicMembership). Para más información sobre la sintaxis de la regla de pertenencia, consulte Sintaxis de las reglas de pertenencia

Se devuelve de forma predeterminada. Admite $filter (eq, ne, not, ge, le y startsWith).
membershipRuleProcessingState String Indica si el procesamiento de pertenencia dinámica se encuentra activado o pausado. Los valores posibles son On o Paused.

Se devuelve de forma predeterminada. Admite $filter (eq, ne, noty in).
membershipRuleProcessingStatus membershipRuleProcessingStatus Describe el estado de procesamiento de los grupos dinámicos basados en reglas. La propiedad es para grupos dinámicos null no basados en reglas o si se ha pausado el procesamiento del grupo dinámico.

Requiere $select recuperarse. Solo se admite en la API Obtener grupo (GET /groups/{ID}). Solo lectura.
onPremisesDomainName Cadena Contiene el FQDN de dominio local, también denominado dnsDomainName, sincronizado desde el directorio local. La propiedad solo se rellena para los clientes que sincronizan su directorio local con Microsoft Entra ID a través de Microsoft Entra Connect.

Se devuelve de forma predeterminada. Solo lectura.
onPremisesExtensionAttributes OnPremisesExtensionAttributes Tipo complejo que contiene los atributos de extensión del 1 al 15 para el grupo, sincronizado desde Active Directory local Solo se devuelve en $select. Admite $filter (eq, ne, not y in).
onPremisesLastSyncDateTime DateTimeOffset Indica la última vez que se sincronizó el grupo con el directorio local. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y siempre está en UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z.

Se devuelve de forma predeterminada. Solo lectura. Admite $filter (eq, ne, not, ge, le, in).
onPremisesNetBiosName Cadena Contiene el nombre netBios local sincronizado desde el directorio local. La propiedad solo se rellena para los clientes que sincronizan su directorio local con Microsoft Entra ID a través de Microsoft Entra Connect.

Se devuelve de forma predeterminada. Solo lectura.
onPremisesProvisioningErrors Colección OnPremisesProvisioningError Errores al usar el producto de sincronización de Microsoft durante el aprovisionamiento.

Se devuelve de forma predeterminada. Admite $filter (eq, not).
onPremisesSamAccountName Cadena Contiene el nombre de cuenta de SAM local sincronizado desde el directorio local. La propiedad solo se rellena para los clientes que sincronizan su directorio local con Microsoft Entra ID a través de Microsoft Entra Connect.

Se devuelve de forma predeterminada. Admite $filter (eq, ne, not, ge, le, in y startsWith). Solo lectura.
onPremisesSecurityIdentifier Cadena Contiene el identificador de seguridad (SID) local del grupo sincronizado desde local a la nube. Solo lectura.

Se devuelve de forma predeterminada. Compatibilidad $filter (eq incluidos en null valores).
onPremisesSyncEnabled Boolean true si este grupo está sincronizado desde un directorio local; false si este grupo se ha sincronizado originalmente desde un directorio local, pero ya no está sincronizado; null si este grupo no se ha sincronizado nunca desde un directorio local (valor predeterminado).

Se devuelve de forma predeterminada. Solo lectura. Admite $filter (eq, ne, not, in y eq en valores null).
preferredDataLocation Cadena Ubicación de datos preferida para el grupo de Microsoft 365. De forma predeterminada, el grupo hereda la ubicación de datos preferida del creador del grupo. Para establecer esta propiedad, se debe conceder a la aplicación que realiza la llamada el permiso Directory.ReadWrite.All y asignar al usuario al menos uno de los siguientes roles de Microsoft Entra:
  • Administrador de cuentas de usuario
  • Escritor de directorios
  • Administrador de Exchange
  • Administrador de SharePoint

Para obtener más información sobre esta propiedad, consulte OneDrive Online Multi-Geo y Crear un grupo de Microsoft 365 con una PDL específica.

Admite valores NULL. Se devuelve de forma predeterminada.
preferredLanguage Cadena El idioma preferido para un grupo de Microsoft 365. Debe seguir el código ISO 639-1; por ejemplo, en-US.

Se devuelve de forma predeterminada. Admite $filter (eq, ne, not, ge, le, in, startsWith y eq en valores null).
proxyAddresses Colección string Direcciones de correo electrónico del grupo que dirigen al mismo buzón del grupo. 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.

Se devuelve de forma predeterminada. Solo lectura. No admite valores NULL. Admite $filter (eq, not, ge, le, startsWith, endsWith, /$count eq 0 y /$count ne 0).
renewedDateTime DateTimeOffset Marca de tiempo de la última vez que se renovó el grupo. Esto no se puede modificar directamente y solo se actualiza a través de la acción de servicio de renovación. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y siempre está en UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z.

Se devuelve de forma predeterminada. Admite $filter (eq, ne, not, ge, le y in). Solo lectura.
resourceBehaviorOptions Colección de cadenas Especifica los comportamientos de grupo que se pueden establecer para un grupo de Microsoft 365 durante su creación. Esta propiedad solo se puede establecer como parte de la creación (POST). Para obtener la lista de valores posibles, consulte Comportamientos de grupo de Microsoft 365 y opciones de aprovisionamiento.
resourceProvisioningOptions Colección de cadenas Especifica los recursos de grupo asociados al grupo de Microsoft 365. El valor posible es Team. Para obtener más información, consulte Comportamientos de grupo de Microsoft 365 y opciones de aprovisionamiento.

Se devuelve de forma predeterminada. Admite $filter (eq, not y startsWith).
securityEnabled Booleano Especifica si el grupo es un grupo de seguridad. Obligatorio.

Se devuelve de forma predeterminada. Admite $filter (eq, ne, not, in).
securityIdentifier Cadena Identificador de seguridad del grupo, que se usa en escenarios de Windows. Solo lectura.

Se devuelve de forma predeterminada.
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 vínculo de un objeto de grupo.
theme Cadena Especifica el tema de color de un grupo de Microsoft 365. Los valores posibles son Teal, Purple, Green, Blue, Pink, Orange o Red.

Se devuelve de forma predeterminada.
uniqueName Cadena Identificador único que puede asignarse a un grupo y usarse como clave alternativa. Inmutable. Solo lectura.
unseenConversationsCount Int32 Recuento de conversaciones entregadas una o más publicaciones nuevas desde la última visita del usuario con sesión iniciada al grupo. Esta propiedad es la misma que unseenCount.

Requiere $select recuperarse.
unseenCount Int32 Recuento de las conversaciones que han recibido nuevas entradas desde que el usuario que inició sesión visitó el grupo por última vez. Esta propiedad es la misma que unseenConversationsCount.

Requiere $select recuperarse. Solo se admite en la API Obtener grupo (GET /groups/{ID}).
unseenMessagesCount Int32 Recuento de las nuevas entradas que se han entregado a las conversaciones del grupo desde que el usuario que inició sesión visitó el grupo por última vez.

Requiere $select recuperarse.
visibility Cadena Especifica la directiva de combinación de grupos y la visibilidad del contenido del grupo para los grupos. Los valores posibles son: Private, Public, o HiddenMembership. HiddenMembership solo se puede establecer para los grupos de Microsoft 365 cuando se crean los grupos. No se puede actualizar más adelante. Es posible actualizar otros valores de visibilidad después de crear grupos.
Si el valor de visibilidad no se especifica durante la creación del grupo en Microsoft Graph, se crea un grupo de seguridad de Private forma predeterminada y el grupo de Microsoft 365 se crea Public. Los grupos a los que se pueden asignar roles siempre son Private. Para obtener más información, consulte Opciones de visibilidad de grupos.

Se devuelve de forma predeterminada. Admite un valor NULL.
welcomeMessageEnabled Booleano Indica si se envía un mensaje de bienvenida a los nuevos miembros cuando se agregan al grupo. El valor predeterminado es true.

Requiere $select recuperarse. Solo se admite en la API Obtener grupo (GET /groups/{ID}).
writebackConfiguration groupWritebackConfiguration Especifica si un grupo está configurado para reescribir propiedades de objetos de grupo en Active Directory local localmente. Estas propiedades se usan cuando se configura la escritura diferida de grupos en el cliente de sincronización de Microsoft Entra Connect

Opciones de visibilidad del grupo

Valor Descripción
Public Cualquier persona puede unirse al grupo sin el permiso del propietario.
Cualquier usuario puede ver el contenido del grupo.
Private Se necesita el permiso del propietario para unirse al grupo.
Cualquier usuario puede ver el contenido del grupo.
HiddenMembership Se necesita el permiso del propietario para unirse al grupo.
Cualquier usuario puede ver el contenido del grupo.
Cualquier usuario puede ver los miembros del grupo.
Los administradores (global, empresa, usuarios y soporte técnico) pueden ver la pertenencia del grupo.
El grupo aparece en la lista global de direcciones (LGD).

Relaciones

Relación Tipo Descripción
acceptedSenders Colección directoryObject La lista de usuarios o grupos autorizados a crear publicaciones o eventos de calendario en este grupo. Si esta lista no está vacía, solo los usuarios o grupos enumerados aquí pueden publicar.
appRoleAssignments Colección appRoleAssignment Representa los roles de aplicación que se le han otorgado a un grupo para una aplicación. Admite $expand.
calendar calendario El calendario del grupo. Solo lectura.
calendarView Colección event La vista Calendario del calendario. Solo lectura.
conversations Colección conversation Las conversaciones del grupo.
createdOnBehalfOf directoryObject El usuario (o la aplicación) que creó el grupo. Nota: Esto no se establece si el usuario es un administrador. Solo lectura.
drive drive Unidad predeterminada del grupo. Solo lectura.
drives Colección drive Las unidades del grupo. Solo lectura.
Puntos de conexión Colección endpoint Puntos de conexión del grupo. Solo lectura. Admite un valor NULL.
eventos Colección event Eventos del grupo.
extensions Colección Extension La colección de extensiones abiertas definidas para el grupo. Solo lectura. Admite valores NULL.
groupLifecyclePolicies Colección groupLifecyclePolicy La colección de directivas de ciclo de vida de este grupo. Solo lectura. Admite valores NULL.
memberOf Colección directoryObject Grupos y unidades administrativas de los que el usuario es miembro. Métodos HTTP: GET (compatible con todos los grupos). Solo lectura. Admite un valor NULL. Admite $expand.
members Colección directoryObject Miembros directos del grupo, que pueden ser usuarios, dispositivos, otros grupos o entidades de servicio. Admite las operaciones Lista de miembros, Agregar miembros, y Quitar miembros. Admite un valor NULL.
Compatibilidad $expand incluidos los anidados$select. Por ejemplo, /groups?$filter=startsWith(displayName,'Role')&$select=id,displayName&$expand=members($select=id,userPrincipalName,displayName).
membersWithLicenseErrors Colección user Una lista de miembros del grupo con errores de licencia de esta asignación de licencias basadas en grupos. Solo lectura.
onenote onenote Solo lectura.
onPremisesSyncBehavior onPremisesSyncBehavior Indica el estado de sincronización de un grupo entre la nube y Active Directory local. Solo es compatible $filter con funcionalidades de consulta avanzadas. Por ejemplo, $filter=onPremisesSyncBehavior/isCloudManaged eq true&$count=true.
owners Colección directoryObject Los propietarios del grupo que pueden ser usuarios o entidades de servicio. Limitado a 100 propietarios. Admite un valor NULL.
  • Si esta propiedad no se especifica al crear un grupo de Microsoft 365, el usuario que llama (administrador o no administrador) se asigna automáticamente como propietario del grupo.
  • Un usuario que no es administrador no puede agregarse explícitamente a sí mismo a esta colección al crear el grupo. Para obtener más información, consulte el problema conocido relacionado.
  • En el caso de los grupos de seguridad, el usuario administrador no se agrega automáticamente a esta colección. Para obtener más información, consulte el problema conocido relacionado.

    Admite $filter (/$count eq 0, /$count ne 0, /$count eq 1, /$count ne 1); Admite $expand la inclusión de archivos anidados $select. Por ejemplo, /groups?$filter=startsWith(displayName,'Role')&$select=id,displayName&$expand=owners($select=id,userPrincipalName,displayName).
permissionGrants resourceSpecificPermissionGrant Los permisos concedidos para un grupo a una aplicación específica. Admite $expand.
photo profilePhoto La foto de perfil del grupo.
photos Colección profilePhoto Las fotos de perfil propiedad del grupo. Solo lectura. Admite valores NULL.
planner plannerGroup Servicios Selective Planner disponibles para el grupo. Solo lectura. Admite un valor NULL.
rejectedSenders Colección directoryObject La lista de usuarios o grupos a los que no se les permite crear publicaciones o eventos de calendario en este grupo. Admite valores NULL
settings Colección directorySetting Configuración que puede regir el comportamiento del grupo, por ejemplo, si los miembros pueden invitar a usuarios al grupo. Admite un valor NULL.
sites Colección site La lista de sitios de SharePoint de este grupo. Acceda al sitio predeterminado con /sites/root.
team Colección channel El equipo asociado a este grupo.
threads Colección conversationThread Los hilos de conversación del grupo. Admite valores NULL.
transitiveMemberOf Colección directoryObject Los grupos de los que es miembro un grupo, ya sea directamente o a través de la pertenencia anidada. Admite un valor NULL.
transitiveMembers Colección directoryObject Los miembros directos y transitivos de un grupo. Admite valores NULL.

Representación JSON

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

{
  "accessType": "String",
  "assignedLabels": [{ "@odata.type": "microsoft.graph.assignedLabel" }],
  "assignedLicenses": [{ "@odata.type": "microsoft.graph.assignedLicense" }],
  "allowExternalSenders": "Boolean",
  "autoSubscribeNewMembers": "Boolean",
  "cloudLicensing": { "@odata.type": "microsoft.graph.cloudLicensing.groupCloudLicensing" },
  "createdByAppId": "String",
  "createdDateTime": "String (timestamp)",
  "deletedDateTime": "String (timestamp)",
  "description": "String",
  "displayName": "String",
  "expirationDateTime": "String (timestamp)",
  "groupTypes": ["String"],
  "hideFromAddressLists": "Boolean",
  "hideFromOutlookClients": "Boolean",
  "welcomeMessageEnabled": "Boolean",
  "id": "String (identifier)",
  "isFavorite": "Boolean",
  "isArchived": "Boolean",
  "isAssignableToRole": "Boolean",
  "isManagementRestricted": "Boolean",
  "isSubscribedByMail": "Boolean",
  "licenseProcessingState": "String",
  "mail": "String",
  "mailEnabled": "Boolean",
  "mailNickname": "String",
  "onPremisesDomainName": "String",
  "onPremisesExtensionAttributes": { "@odata.type": "microsoft.graph.onPremisesExtensionAttributes" }, 
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesNetBiosName": "String",
  "onPremisesProvisioningErrors": [
    { "@odata.type": "microsoft.graph.onPremisesProvisioningError" }
  ],
  "onPremisesSamAccountName": "String",
  "onPremisesSecurityIdentifier": "String",
  "onPremisesSyncEnabled": "Boolean",
  "preferredDataLocation": "String",
  "proxyAddresses": ["String"],
  "renewedDateTime": "String (timestamp)",
  "resourceBehaviorOptions": ["String"],
  "resourceProvisioningOptions": ["String"],
  "securityEnabled": "Boolean",
  "securityIdentifier": "String",
  "serviceProvisioningErrors": [
    { "@odata.type": "microsoft.graph.serviceProvisioningXmlError" }
  ],
  "uniqueName": "String",
  "unseenConversationsCount": "Int32",
  "unseenCount": "Int32",
  "unseenMessagesCount": "Int32",
  "visibility": "String",
  "acceptedSenders": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "calendar": { "@odata.type": "microsoft.graph.calendar" },
  "calendarView": [{ "@odata.type": "microsoft.graph.event" }],
  "conversations": [{ "@odata.type": "microsoft.graph.conversation" }],
  "createdOnBehalfOf": { "@odata.type": "microsoft.graph.directoryObject" },
  "drive": { "@odata.type": "microsoft.graph.drive" },
  "events": [{ "@odata.type": "microsoft.graph.event" }],
  "memberOf": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "members": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "membersWithLicenseErrors": [{ "@odata.type": "microsoft.graph.user" }],
  "owners": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "photo": { "@odata.type": "microsoft.graph.profilePhoto" },
  "photos": [{ "@odata.type": "microsoft.graph.profilePhoto" }],
  "rejectedSenders": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "sites": [{ "@odata.type": "microsoft.graph.site" }],
  "threads": [{ "@odata.type": "microsoft.graph.conversationThread" }],
  "classification": "String",
  "hasMembersWithLicenseErrors": "Boolean",
  "membershipRule": "String",
  "membershipRuleProcessingState": "String",
  "membershipRuleProcessingStatus": {
    "@odata.type": "microsoft.graph.membershipRuleProcessingStatus"
  },
  "preferredLanguage": "String",
  "theme": "String"
}

Contenido relacionado

  • Last updated on