tipo de recurso de grupo
Namespace: microsoft.graph
Representa um grupo Microsoft Entra, um grupo do Microsoft 365 ou um grupo de segurança. Esse recurso é um tipo aberto que permite que outras propriedades sejam passadas.
Herda de directoryObject.
Por motivos de desempenho, as operações create, get e list retornam por padrão apenas um subconjunto das propriedades usadas com mais frequência. Essas propriedades padrão estão listadas na seção Propriedades. Para obter qualquer uma das propriedades não devolvidas por predefinição, especifique-as numa $select
opção de consulta OData.
Esse recurso permite:
- Adicionar os seus dados a propriedades personalizadas como extensões.
- Assinar as notificações de alteração.
- Usar a consulta delta para controlar adições, exclusões e atualizações incrementais oferecendo uma função delta.
Métodos
Método | Tipo de retorno | Descrição |
---|---|---|
List | Coleção group | Listar objetos group e suas propriedades. |
Create | group | Criar um novo grupo. Pode ser um grupo do Microsoft 365, um grupo dinâmico ou um grupo de segurança. |
Get | group | Ler as propriedades de um objeto group. |
Atualizar | Nenhum | Atualizar as propriedades de um objeto group. |
Upsert | group | Crie um novo grupo se não existir ou atualize as propriedades de um grupo existente. |
Delete | Nenhum | Excluir um objeto group. |
Obter delta | Coleção group | Obter alterações incrementais para grupos. |
Gerenciamento de grupos | ||
Listar membros | Coleção directoryObject | Obtenha os membros diretos deste grupo a partir da propriedade de navegação membros. |
Adicionar membros | Nenhum | Adicione um membro a este grupo ao publicar na propriedade de navegação dos membros (suportada apenas para grupos de segurança e grupos do Microsoft 365). |
Remover membro | Nenhum | Remova um membro de um grupo do Microsoft 365 ou de um grupo de segurança por meio da propriedade de navegação membros. |
Listar proprietários | Coleção directoryObject | Obter os proprietários do grupo da propriedade de navegação owners. |
Adicionar proprietários | Nenhum | Adicione um novo proprietário para o grupo postando na propriedade de navegação dos proprietários (com suporte para grupos de segurança e grupos do Microsoft 365 apenas). |
Remover proprietário | Nenhum | Remova um proprietário de um grupo do Microsoft 365 ou de um grupo de segurança por meio da propriedade de navegação proprietários. |
Listar políticas de ciclo de vida de grupo | Coleção groupLifecyclePolicy | Listar políticas de ciclo de vida de grupo. |
Listar membros transitivos | Coleção directoryObject | Obtenha os utilizadores, grupos e dispositivos que são membros, incluindo membros aninhados deste grupo. |
Listar membro transitivo de | Coleção directoryObject | Lista os grupos dos quais esse grupo é membro. Essa operação é transitiva e inclui os grupos que são membros aninhados desse grupo. |
Atribuir licença | group | Adicione ou remova assinaturas para o grupo. Você também pode habilitar e desabilitar planos específicos associados a uma assinatura. |
Renovar | Booliano | Renova o período de validade de um grupo. A renovação prolonga a expiração do grupo pelo número de dias definidos na política. |
Validar propriedades | JSON | Valide se o nome de exibição ou apelido de email de um grupo da Microsoft 365 está em conformidade com as políticas de nomenclatura. |
Atribuição de funções do aplicativo | ||
List | appRoleAssignment collection | Obtenha as aplicações e as funções de aplicação atribuídas a este grupo. |
Add | appRoleAssignment | Atribuir uma função do aplicativo a esse grupo. |
Remove | Nenhum. | Remover uma atribuição de função do aplicativo desse grupo. |
Calendar | ||
Obter calendário | calendar | Obtenha o calendário do grupo. |
Atualizar calendário | Nenhum | Atualize o calendário do grupo. |
Listar eventos | Coleção event | Obter uma coleção de objetos de evento. |
Criar evento | event | Criar um novo Event postando na coleção de eventos. |
Obter evento | event | Ler as propriedades de um objeto event. |
Atualizar evento | Nenhum | Atualizar as propriedades de um objeto event. |
Excluir evento | Nenhum | Excluir o objeto event. |
Listar modo de exibição de calendário | Coleção event | Obter um conjunto de eventos em uma janela de tempo especificada. |
Conversas | ||
Listar conversas | Coleção conversation | Obter uma coleção de objetos Conversation. |
Criar conversa | conversa | Crie uma nova conversa postando na coleção de conversas. |
Obter conversa | conversation | Ler as propriedades de um objeto conversation. |
Excluir conversa | Nenhum | Excluir objeto conversation. |
Listar threads | Coleção conversationThread | Obter todos os threads de um grupo. |
Criar thread | conversationThread | Criar um novo thread de conversa. |
Acessar thread | conversationThread | Ler as propriedades de um objeto thread. |
Atualizar thread | Nenhum | Atualizar as propriedades de um objeto thread. |
Excluir thread | Nenhum | Excluir objeto thread. |
Listar remetentes aceitos | Coleção directoryObject | Obtenha uma lista de usuários ou grupos que estão na lista de remetentes aceitos para este grupo. |
Adicionar remetente aceite | directoryObject | Adicionar um Usuário ou Grupo à coleção acceptSenders. |
Remover remetente aceito | directoryObject | Remover um Usuário ou Grupo da coleção acceptedSenders. |
Listar remetentes rejeitados | Coleção directoryObject | Obtenha uma lista de usuários ou grupos que estão na lista de remetentes rejeitados para este grupo. |
Adicionar remetente rejeitado | directoryObject | Adicionar um novo Usuário ou Grupo à coleção rejectedSenders. |
Remover remetente rejeitado | directoryObject | Remover um novo Usuário ou Grupo da coleção Remetentesrejeitados. |
Objetos de diretório | ||
Listar itens excluídos | Coleção directoryObject | Recupere os grupos excluídos no locatário nos últimos 30 dias. |
Obter item excluído | Coleção directoryObject | Recupere um grupo excluído por ID. |
Restaurar item excluído | Coleção directoryObject | Restaure um grupo excluído no locatário nos últimos 30 dias. |
Excluir permanentemente item | Coleção directoryObject | Exclua permanentemente um grupo excluído do locatário. |
Listar itens excluídos pertencentes ao usuário | Coleção directoryObject | Obtenha os grupos do utilizador eliminados no inquilino nos últimos 30 dias. |
Verificar grupos de membros | Coleção de cadeias de caracteres | Verifique se há uma associação em uma lista de grupos. Essa função é transitiva. |
Obter grupos de membros | Coleção String | Retornar todos os grupos dos quais o grupo é membro. Essa função é transitiva. |
Verificar objetos de membro | Coleção de cadeias de caracteres | Verifique se há associação em uma lista de grupo, função de diretório ou objetos de unidade administrativa. Essa função é transitiva. |
Obter objetos de membros | Coleção de cadeias de caracteres | Devolver todos os grupos e unidades administrativas dos quais o grupo é membro. Essa função é transitiva. |
Unidade | ||
Obter unidade | unidade | Recuperar as propriedades e as relações de um recurso Drive. |
Filhos de lista | DriveItems | Retornar uma coleção de DriveItems no relacionamento filho de um DriveItem. |
Configurações de grupo | ||
List | Conjunto groupSetting | Lista propriedades de todos os objetos de configuração. |
Create | groupSetting | Crie um objeto de definição com base num groupSettingTemplate. O pedido POST tem de fornecer settingValues para todas as definições definidas no modelo. Apenas os modelos específicos de grupos podem ser utilizados para esta operação. |
Get | groupSetting | Ler propriedades de um objeto de configuração específico. |
Atualizar | Nenhum | Atualizar um objeto setting. |
Delete | Nenhum | Excluir um objeto de configuração. |
Listar modelo de configuração | Nenhum | Listar propriedades de todos os modelos de configuração. |
Obter modelo de configuração | Nenhum | Ler as propriedades de um modelo de configuração. |
Observações | ||
Listar blocos de anotações | Coleção bloco de anotações | Recuperar uma lista de objetos do bloco de anotações. |
Criar bloco de anotações | bloco de anotações | Crie um novo bloco de anotações do OneNote. |
Fotografia de perfil | ||
Get | profilePhoto | Obtém o profilePhoto especificado ou seus metadados (propriedades profilePhoto). |
Atualizar | Nenhum | Atualiza a foto de qualquer usuário no locatário, incluindo o usuário conectado ou o grupo ou contato especificado. |
Delete | Nenhum | Elimine a fotografia de qualquer utilizador no inquilino, incluindo o utilizador com sessão iniciada ou o grupo especificado. |
Planner | ||
Listar planos | coleção plannerPlan | Obter planos atribuídos ao grupo. |
Mensagens | ||
List | Coleção post | Obter mensagens num tópico de conversação. |
Get | postagem | Obter uma publicação específica. |
Responder a publicar | Nenhum | Responder a uma mensagem. |
Encaminhar postagem | Nenhum | Reencaminhar uma mensagem. |
Outros recursos de grupo | ||
Listar as concessões de permissões | Coleção resourceSpecificPermissionGrant | Liste as permissões que são concedidas às aplicações para aceder ao grupo. |
Configurações do usuário | ||
Adicionar favorito | Nenhum | Adicionar o grupo à lista de grupos de favoritos do usuário conectado. Apenas grupos do Microsoft 365 são suportados. |
Remover favorito | Nenhum | Remover o grupo da lista de grupos favoritos do usuário conectado. Apenas grupos do Microsoft 365 são suportados. |
Listar membro de | Coleção directoryObject | Obter os grupos e unidades administrativas dos quais esse usuário é um membro direto a partir da propriedade de navegação memberOf. |
Listar equipes unidas | Coleção group | Obtenha as equipes do Microsoft Teams das quais o usuário é um membro direto. |
Listar equipes associadas | Coleção associatedTeamInfo | Obtenha a lista de objetos associatedTeamInfo no Microsoft Teams as quais um usuário está associado. |
Assinar por email | Nenhum | Defina a propriedade isSubscribedByMail como true . Permitir que o usuário conectado receba conversas por email. Apenas grupos do Microsoft 365 são suportados. |
Cancelar assinatura por email | Nenhum | Defina a propriedade isSubscribedByMail como false . Desabilitar o recebimento de conversas por email do usuário conectado. Apenas grupos do Microsoft 365 são suportados. |
Redefinir contagem não vista | Nenhum | Reponha a unseenCount para 0 de todas as mensagens que o utilizador com sessão iniciada não vê desde a última visita. Apenas grupos do Microsoft 365 são suportados. |
Propriedades
Importante
O uso específico de $filter
e o parâmetro de consulta $search
é suportado somente quando se usa o cabeçalho ConsistencyLevel definido como eventual
e $count
. Para obter mais informações, veja Capacidades avançadas de consulta em objetos de diretório.
Propriedade | Tipo | Descrição |
---|---|---|
allowExternalSenders | Boolean | Indica se as pessoas externas à empresa podem enviar mensagens para o grupo. O valor padrão é false . Retornado apenas em $select . Com suporte apenas para Obter API de grupo (GET /groups/{ID} ) |
assignedLabels | coleção assignedLabel | Lista de pares de rótulos de confidencialidade (ID do rótulo, nome do rótulo) associados a um grupo do Microsoft 365. Retornado apenas em $select . Esta propriedade só pode ser atualizada em cenários delegados em que o autor da chamada necessita da permissão do Microsoft Graph e de uma função de administrador suportada. |
assignedLicenses | Coleção assignedLicense | As licenças que são atribuídas ao grupo. Retornado apenas em $select . Suporta $filter (eq ). Somente leitura. |
autoSubscribeNewMembers | Boolean | Indica se os novos membros adicionados ao grupo estão automaticamente inscritos para receber notificações por email. Pode definir esta propriedade num pedido PATCH para o grupo; não o defina no pedido POST inicial que cria o grupo. O valor padrão é false . Retornado apenas em $select . Com suporte apenas para Obter API de grupo (GET /groups/{ID} ) |
classificação | String | Descreve uma classificação para o grupo (como impacto comercial baixo, médio ou elevado). Os valores válidos para esta propriedade são definidos através da criação de um valor de definição ClassificationList, com base na definição do modelo. Retornado por padrão. Suporta $filter (eq , ne , not , ge , le , startsWith ). |
createdDateTime | DateTimeOffset | Carimbo de data/hora da ocasião em que o grupo foi criado. O valor não pode ser modificado e é preenchido automaticamente quando o grupo é criado. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC a 1 de janeiro de 2014 é 2014-01-01T00:00:00Z . Retornado por padrão. Somente leitura. |
deletedDateTime | DateTimeOffset | Para alguns Microsoft Entra objetos (utilizador, grupo, aplicação), se o objeto for eliminado, é eliminado logicamente e esta propriedade é atualizada com a data e hora em que o objeto foi eliminado. Caso contrário, esta propriedade é null . Se o objeto for restaurado, esta propriedade será atualizada para null . Herdado de directoryObject. |
description | String | Uma descrição opcional para o grupo. Retornado por padrão. Suporta $filter (eq , ne , not , ge , le , startsWith ) e $search . |
displayName | String | O nome de exibição do grupo. Esta propriedade é necessária quando um grupo é criado e não pode ser limpo durante as atualizações. O comprimento máximo é de 256 caracteres. Retornado por padrão. Suporte $filter (eq , ne , not , ge , le , in , startsWith , e eq no null valores), $search , e $orderby . |
expirationDateTime | DateTimeOffset | Data e hora de quando o grupo está configurado para expirar.
null Destina-se a grupos de segurança, mas para grupos do Microsoft 365, representa quando o grupo está definido para expirar conforme definido no grupoLifecyclePolicy. O tipo carimbo de data/hora representa informações de data e hora com o formato ISO 8601 e está sempre em UTC. Por exemplo, meia-noite UTC a 1 de janeiro de 2014 é 2014-01-01T00:00:00Z . Retornado por padrão. Suporta $filter (eq , ne , not , ge , le , in ). Somente leitura. |
groupTypes | Coleção de cadeias de caracteres | Especifica o tipo de grupo e sua associação. Se a coleção contiver Unified , o grupo é um grupo do Microsoft 365; caso contrário, é um grupo de segurança ou um grupo de distribuição. Para obter detalhes, confira visão geral sobre grupos.Se a coleção inclui DynamicMembership , o grupo tem associação dinâmica; caso contrário, a associação é estática. Retornado por padrão. Suporta $filter (eq , not ). |
hasMembersWithLicenseErrors | Boolean | Indica se existem membros neste grupo com erros de licença da sua atribuição de licença baseada em grupo. Esta propriedade nunca é retornada em uma operação GET. Você pode usá-lo como um argumento $filter para acessar os grupos que têm membros com erros de licença (ou seja, o filtro para essa propriedade é true). Veja um exemplo. Suporta $filter (eq ). |
hideFromAddressLists | Booliano | Verdadeiro se o grupo não for apresentado em determinadas partes da IU do Outlook: o Livro de Endereços, listas de endereços para selecionar destinatários de mensagens e a caixa de diálogo Procurar Grupos para procurar grupos; caso contrário, falso. O valor padrão é false . Retornado apenas em $select . Com suporte apenas para Obter API de grupo (GET /groups/{ID} ) |
hideFromOutlookClients | Booliano | Verdadeiro se o grupo não for apresentado nos clientes do Outlook, como o Outlook para Windows e Outlook na Web; caso contrário, falso. O valor padrão é false . Retornado apenas em $select . Com suporte apenas para Obter API de grupo (GET /groups/{ID} ) |
id | String | O identificador exclusivo do grupo. Retornado por padrão. Herdado de directoryObject. Chave. Não anulável. Somente leitura. Suporta $filter (eq , ne , not , in ). |
isArchived | Booliano | Quando um grupo está associado a uma equipe, esta propriedade determina se a equipe está em modo somente leitura. Para ler essa propriedade, use o ponto de extremidade /group/{groupId}/team ou a API Obter equipe. Para atualizar essa propriedade, use as APIs archiveTeam e unarchiveTeam. |
isAssignableToRole | Booliano | Indica se este grupo pode ser atribuído a uma função de Microsoft Entra. Opcional. Esta propriedade só pode ser definida durante a criação do grupo e é imutável. Se definida como true , a propriedade securityEnabled também tem de ser definida como , a true visibilidade tem de ser Hidden e o grupo não pode ser um grupo dinâmico (ou seja, groupTypes não pode conter DynamicMembership ). Apenas os autores de chamadas com, pelo menos, a função Administrador de Função Privilegiada podem definir esta propriedade. O autor da chamada também tem de ter a permissão RoleManagement.ReadWrite.Directory para definir esta propriedade ou atualizar a associação desses grupos. Para obter mais informações, veja Utilizar um grupo para gerir atribuições de funções Microsoft Entra Utilizar esta funcionalidade requer uma licença Microsoft Entra ID P1. Devolvido por padrão. Suporta $filter (eq , ne , not ). |
isSubscribedByMail | Boolean | Indica se o usuário conectado está inscrito para receber conversas de email. O valor padrão é true . Retornado apenas em $select . Com suporte apenas para Obter API de grupo (GET /groups/{ID} ) |
licenseProcessingState | String | Indica a status da atribuição de licença de grupo a todos os membros do grupo. O valor padrão é false . Somente leitura. Valores possíveis: QueuedForProcessing , ProcessingInProgress e ProcessingComplete .Retornado apenas em $select . Somente leitura. |
String | O endereço SMTP para o grupo, por exemplo, "serviceadmins@contoso.com". Retornado por padrão. Somente leitura. Suporte $filter (eq , ne , not , ge , le , in , startsWith , e eq no null valores). |
|
mailEnabled | Boolean | Especifica se o grupo está habilitado para email. Obrigatório. Devolvido por padrão. Suporta $filter (eq , ne , not ). |
mailNickname | String | O alias de email do grupo, exclusivo para grupos do Microsoft 365 na organização. O comprimento máximo é de 64 caracteres. Esta propriedade só pode conter carateres no conjunto de carateres ASCII 0 - 127 , exceto os seguintes carateres: @ () \ [] " ; : <> , SPACE . Obrigatório. Devolvido por padrão. Suporta $filter (eq , ne , not , ge , le , in , startsWith , e eq em null valores). |
membershipRule | String | A regra que determina membros para esse grupo se o grupo for um grupo dinâmico (groupTypes contém DynamicMembership ). Para saber mais sobre a sintaxe da regra de associação, confira sintaxe regras de associação. Retornado por padrão. Suporta $filter (eq , ne , not , ge , le , startsWith ). |
membershipRuleProcessingState | String | Indica se o processamento de associação dinâmica está ativado ou em pausa. Os valores possíveis são: On ou Paused . Retornado por padrão. Suporta $filter (eq , ne , not , in ). |
onPremisesDomainName | Cadeia de Caracteres | Contém o nome de domínio totalmente qualificado (FQDN) local, também chamado de dnsDomainName sincronizado no diretório local. A propriedade só é preenchida para clientes que sincronizam o respetivo diretório no local para Microsoft Entra ID através do Microsoft Entra Connect. Retornado por padrão. Somente leitura. |
onPremisesLastSyncDateTime | DateTimeOffset | Indica a última vez em que o grupo foi sincronizado com o diretório no local. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC a 1 de janeiro de 2014 é 2014-01-01T00:00:00Z . Retornado por padrão. Somente leitura. Suporta $filter (eq , ne , not , ge , le , in ). |
onPremisesNetBiosName | Cadeia de Caracteres | Contém o netBios name local sincronizado no diretório local. A propriedade só é preenchida para clientes que sincronizam o respetivo diretório no local para Microsoft Entra ID através do Microsoft Entra Connect. Retornado por padrão. Somente leitura. |
onPremisesProvisioningErrors | coleção OnPremisesProvisioningError | Erros ao usar o produto de sincronização da Microsoft durante a configuração. Retornado por padrão. Suporta $filter (eq , not ). |
onPremisesSamAccountName | Cadeia de Caracteres | Contém o nome da conta SAM local sincronizado no diretório local. A propriedade só é preenchida para clientes que sincronizam o respetivo diretório no local para Microsoft Entra ID através do Microsoft Entra Connect. Devolvido por padrão. Suporta $filter (eq , ne , not , ge , le , in , startsWith ). Somente leitura. |
onPremisesSecurityIdentifier | String | Contém o identificador de segurança (SID) no local para o grupo sincronizado do local para a cloud. Somente leitura. Devolvido por padrão. Suporta $filter (eq inclusive em null valores). |
onPremisesSyncEnabled | Booliano |
true se este grupo for sincronizado a partir de um diretório no local; false se este grupo tiver sido originalmente sincronizado a partir de um diretório no local, mas já não estiver sincronizado; nulo se este objeto nunca tiver sido sincronizado a partir de um diretório no local (predefinição). Retornado por padrão. Somente leitura. Suporte $filter (eq , ne , not , in , e eq no null valores). |
preferredDataLocation | String | O local de data preferido para o grupo do Microsoft 365. Por padrão, o grupo herda o local de dados preferencial do criador do grupo. Para definir esta propriedade, a aplicação de chamadas tem de ter a permissão Directory.ReadWrite.All e ser atribuída ao utilizador, pelo menos, uma das seguintes funções de Microsoft Entra:
Para obter mais informações sobre essa propriedade, consulte OneDrive Online Multi-Geo. Anulável. Retornado por padrão. |
preferredLanguage | Cadeia de caracteres | Idioma de preferência de um grupo do Microsoft 365. Deve seguir o Código ISO 639-1; por exemplo, en-US . Devolvido por padrão. Suporte $filter (eq , ne , not , ge , le , in , startsWith , e eq no null valores). |
proxyAddresses | String collection | Endereços de email para o grupo que direcionam para a mesma caixa de correio do grupo. Por exemplo: ["SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com"] . O operador any é obrigatório para filtrar expressões em propriedades de vários valores. Retornado por padrão. Somente leitura. Não anulável. Suporta $filter (eq , not , ge , le , startsWith , endsWith , /$count eq 0 , /$count ne 0 ). |
renewedDateTime | DateTimeOffset | Carimbo de data/hora da ocasião em que o grupo foi renovado pela última vez. Este valor não pode ser modificado diretamente e só é atualizado através da ação renovar o serviço. O tipo carimbo de data/hora representa informações de data e hora com o formato ISO 8601 e está sempre em UTC. Por exemplo, meia-noite UTC a 1 de janeiro de 2014 é 2014-01-01T00:00:00Z . Retornado por padrão. Suporta $filter (eq , ne , not , ge , le , in ). Somente leitura. |
securityEnabled | Boolean | Especifica se o grupo é um grupo de segurança. Obrigatório. Devolvido por padrão. Suporta $filter (eq , ne , not , in ). |
securityIdentifier | Cadeia de Caracteres | Identificador de segurança do grupo, usado em cenários do Windows. Somente leitura. Devolvido por padrão. |
serviceProvisioningErrors | serviceProvisioningError collection | Erros publicados por um serviço federado que descreve um erro nãotransiente específico do serviço relativamente às propriedades ou ligação de um objeto de grupo. $filter Suporta (eq , not , para isResolved e serviceInstance). |
tema | cadeia de caracteres | Especifica o tema de cor de um grupo do Microsoft 365. Os valores possíveis são Teal , Purple , Green , Blue , Pink , ou Orange Red . Devolvido por padrão. |
Nome único | Cadeia de caracteres | O identificador exclusivo que pode ser atribuído a um grupo e utilizado como uma chave alternativa. Imutável. Somente leitura. |
unseenCount | Int32 | Contagem de conversações que receberam novas mensagens desde que o utilizador com sessão iniciada visitou o grupo pela última vez. Retornado apenas em $select . Com suporte apenas para Obter API de grupo (GET /groups/{ID} ) |
visibility | Cadeia de caracteres | Especifica a política de associação ao grupo e a visibilidade do conteúdo do grupo para grupos. Os valores possíveis são: Private , Public ou HiddenMembership .
HiddenMembership só pode ser definido para grupos do Microsoft 365 quando os grupos são criados. Não pode ser atualizado posteriormente. Outros valores de visibilidade podem ser atualizados após a criação do grupo.Se o valor de visibilidade não for especificado durante a criação do grupo no Microsoft Graph, é criado um grupo de segurança como Private por predefinição e o grupo do Microsoft 365 é Public . Grupos atribuídos a funções são sempre Private . Para saber mais, veja opções de visibilidade de grupo. Retornado por padrão. Anulável. |
Opções de visibilidade do grupo
Valor | Descrição |
---|---|
Público | Qualquer pessoa pode ingressar no grupo sem precisar de permissão de proprietário. Qualquer pessoa pode exibir os atributos do grupo. Qualquer pessoa pode ver os membros do grupo. |
Privado | A permissão de proprietário é necessária para ingressar no grupo. Qualquer pessoa pode exibir os atributos do grupo. Qualquer pessoa pode ver os membros do grupo. |
HiddenMembership | A permissão de proprietário é necessária para ingressar no grupo. Os convidados não podem ver os atributos do grupo. Os não membros não podem ver os membros do grupo. Esta definição não afeta a visibilidade dos proprietários de grupos. Administradores (global, empresa, usuário e helpdesk) podem visualizar a associação do grupo. O grupo aparece no catálogo de endereços global (GAL). |
Relações
Relação | Tipo | Descrição |
---|---|---|
acceptedSenders | Coleção directoryObject | A lista de utilizadores ou grupos autorizados a criar mensagens ou eventos de calendário neste grupo. Se esta lista não for atualizada, apenas os utilizadores ou grupos listados aqui podem publicar. |
appRoleAssignments | appRoleAssignment collection | Representa as funções de aplicação concedidas a um grupo para uma aplicação. Suporta o $expand . |
calendar | calendar | O calendário do grupo. Somente leitura. |
calendarView | Coleção event | O modo de exibição do calendário. Somente leitura. |
conversations | Coleção conversation | As conversas do grupo. |
createdOnBehalfOf | directoryObject | O usuário (ou aplicativo) que criou o grupo. NOTA: esta propriedade não está definida se o utilizador for um administrador. Apenas leitura. |
drive | unidade | Unidade padrão do grupo. Somente leitura. |
unidades | Coleção drive | As unidades do grupo. Somente leitura. |
events | Coleção event | Os eventos de calendário do grupo. |
extensions | Coleção extension | A coleção de extensões abertas definidas para o grupo. Somente leitura. Anulável. |
groupLifecyclePolicies | Coleção groupLifecyclePolicy | O conjunto de políticas de ciclo de vida para esse grupo. Somente leitura. Anulável. |
memberOf | Coleção directoryObject | Grupos dos quais esse grupo é membro. Métodos HTTP: GET (suporte para todos os grupos). Somente leitura. Anulável. Suporta o $expand . |
membros | Coleção directoryObject | Os membros deste grupo, que podem ser usuários, dispositivos, outros grupos ou entidades de serviço. Suporta as operações Membros da lista, Adicionar membro e Remover membro. Anulável. Suporta $expand incluindo $select aninhado. Por exemplo, /groups?$filter=startsWith(displayName,'Role')&$select=id,displayName&$expand=members($select=id,userPrincipalName,displayName) . |
membersWithLicenseErrors | Coleção user | Uma lista de membros do grupo com erros de licença desse grupo baseado em atribuição de licença. Somente leitura. |
onenote | Onenote | Somente leitura. |
owners | Coleção directoryObject | Os proprietários do grupo que podem ser usuários ou entidades de serviço. Limitado a 100 proprietários. Anulável. $filter Suporta (/$count eq 0 , /$count ne 0 , /$count eq 1 , /$count ne 1 ); Suporta, $expand incluindo o aninhado $select . Por exemplo, /groups?$filter=startsWith(displayName,'Role')&$select=id,displayName&$expand=owners($select=id,userPrincipalName,displayName) . |
photo | profilePhoto | A foto de perfil do grupo |
fotos | Coleção profilePhoto | As fotografias de perfil pertencentes ao grupo. Somente leitura. Anulável. |
planejador | plannerGroup | Ponto de entrada para o recurso Planejador que pode existir para um Grupo unificado. |
rejectedSenders | Coleção directoryObject | A lista de utilizadores ou grupos não autorizados a criar mensagens ou eventos de calendário neste grupo. Anulável |
configurações | Conjunto groupSetting | Definições que podem governar o comportamento deste grupo, como se os membros podem convidar convidados para o grupo. Anulável. |
sites | conjunto de sites | A lista de sites do SharePoint neste grupo. Aceda ao site predefinido com /sites/raiz. |
team | Coleção channel | A equipe associada a este grupo. |
threads | Coleção conversationThread | Os threads de conversas do grupo. Anulável. |
transitiveMemberOf | Coleção directoryObject | Os grupos dos quais um grupo é membro, diretamente ou através da associação aninhada. Anulável. |
transitiveMembers | Coleção directoryObject | Os membros diretos e transitórios de um grupo. Anulável. |
Representação JSON
A representação JSON seguinte mostra o tipo de recurso.
{
"allowExternalSenders": false,
"acceptedSenders": [{ "@odata.type": "microsoft.graph.directoryObject" }],
"assignedLicenses": [{ "@odata.type": "microsoft.graph.assignedLicense" }],
"autoSubscribeNewMembers": true,
"calendar": { "@odata.type": "microsoft.graph.calendar" },
"calendarView": [{ "@odata.type": "microsoft.graph.event" }],
"classification": "String",
"conversations": [{ "@odata.type": "microsoft.graph.conversation" }],
"createdDateTime": "String (timestamp)",
"createdOnBehalfOf": { "@odata.type": "microsoft.graph.directoryObject" },
"deletedDateTime": "String (timestamp)",
"description": "String",
"displayName": "String",
"drive": { "@odata.type": "microsoft.graph.drive" },
"events": [{ "@odata.type": "microsoft.graph.event" }],
"groupTypes": ["String"],
"hasMembersWithLicenseErrors": "Boolean",
"hideFromAddressLists": false,
"hideFromOutlookClients": false,
"id": "String (identifier)",
"isAssignableToRole": false,
"isSubscribedByMail": true,
"licenseProcessingState": "String",
"mail": "String",
"mailEnabled": true,
"mailNickname": "String",
"memberOf": [{ "@odata.type": "microsoft.graph.directoryObject" }],
"members": [{ "@odata.type": "microsoft.graph.directoryObject" }],
"membersWithLicenseErrors": [{ "@odata.type": "microsoft.graph.user" }],
"onPremisesDomainName": "String",
"onPremisesLastSyncDateTime": "String (timestamp)",
"onPremisesNetBiosName": "String",
"onPremisesProvisioningErrors": [
{ "@odata.type": "microsoft.graph.onPremisesProvisioningError" }
],
"onPremisesSecurityIdentifier": "String",
"onPremisesSyncEnabled": true,
"owners": [{ "@odata.type": "microsoft.graph.directoryObject" }],
"preferredDataLocation": "String",
"proxyAddresses": ["String"],
"photo": { "@odata.type": "microsoft.graph.profilePhoto" },
"photos": [{ "@odata.type": "microsoft.graph.profilePhoto" }],
"rejectedSenders": [{ "@odata.type": "microsoft.graph.directoryObject" }],
"renewedDateTime": "String (timestamp)",
"securityEnabled": true,
"securityIdentifier": "String",
"serviceProvisioningErrors": [
{ "@odata.type": "microsoft.graph.serviceProvisioningXmlError" }
],
"sites": [{ "@odata.type": "microsoft.graph.site" }],
"threads": [{ "@odata.type": "microsoft.graph.conversationThread" }],
"uniqueName": "String",
"unseenCount": 1024,
"visibility": "String"
}