Comentários Editar

tipo de recurso de grupo

  • Artigo
  • 22 minutos para o fim da leitura

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor de versão.

Representa um grupo do Diretório Ativo do Azure (Azure AD), que pode ser um grupo do Microsoft 365, uma equipe do Microsoft Teams 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 as propriedades não retornadas por padrão, especifique-as em uma opção de consulta $select do OData.

Esse recurso permite:

O Microsoft Teams e os grupos do Microsoft 365 oferecem suporte à colaboração em grupo. Você pode usar a maioria das APIs de grupos do Microsoft 365 com o Microsoft Teams. Para criar uma equipe, primeiro crie o grupo e, em seguida, adicione uma equipe nele. Para obter detalhes, confira a visão geral do Microsoft Teams.

Métodos

Método Tipo de retorno Descrição
Gerenciamento de grupos
Criar grupo group Crie um novo grupo conforme especificado. Pode ser um grupo, grupo dinâmico, grupo de segurança ou equipe do Microsoft 365.
Obter grupo grupo Ler as propriedades e as relações do objeto do grupo.
Atualizar grupo Nenhum Atualizar as propriedades de um objeto group.
Excluir grupo Nenhum Excluir um objeto group.
Listar grupos group Ler as propriedades e as relações de todos os objetos do grupo.
delta Coleção group Obter alterações incrementais para grupos.
Adicionar membros directoryObject Adicione um usuário ou grupo a este grupo postando na propriedade de navegação membros (com suporte para grupos de segurança e grupos do Microsoft 365 apenas).
Adicionar proprietários directoryObject 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).
Criar configuração directorySetting Criar um objeto de configuração com base em um directorySettingTemplate. A solicitação POST deve fornecer settingValues para todas as configurações definidas no modelo. Somente modelos específicos de grupos podem ser usados para essa operação.
Excluir configuração Nenhum Excluir um objeto de configuração.
Obter o ponto de extremidade ponto de extremidade Leia as propriedades e os relacionamentos do objeto ponto de extremidade.
Obter configuração directorySetting Ler propriedades de um objeto de configuração específico.
Listar pontos de extremidade conjunto ponto de extremidade Obtenha uma coleção de o objeto ponto de extremidade.
Listar membros Coleção directoryObject Obter os usuários e grupos que são membros diretos desse grupo da propriedade de navegação members.
Listar memberOf Coleção directoryObject Obter os grupos e as unidades administrativas dos quais esse grupo é membro direto, da propriedade de navegação memberOf.
Listar groupLifecyclePolicies Coleção groupLifecyclePolicy Listar políticas de ciclo de vida de grupo.
Listar proprietários Coleção directoryObject Obter os proprietários do grupo da propriedade de navegação owners.
Listar configurações conjunto directorySetting Lista propriedades de todos os objetos de configuração.
Listar membros transitivos Coleção directoryObject Obtenha os usuários, grupos, dispositivos e entidades de serviço que são membros, incluindo membros aninhados desse grupo.
Listar memberOf transitivos Coleção directoryObject Listar as unidades administrativas e grupos dos quais esse grupo é membro. Essa operação é transitiva e inclui os grupos que são membros aninhados desse grupo.
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.
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.
Atualizar configuração directorySetting Atualizar um objeto setting.
assignLicense group Adicione ou remova inscrições para o grupo. Você também pode habilitar e desabilitar planos específicos associados a uma assinatura.
evaluateDynamicMembership evaluateDynamicMembershipResult Avaliar se um usuário ou dispositivo é ou seria membro de um grupo dinâmico.
renovar Booleano Renova a expiração de um grupo. Quando um grupo é renovado, a expiração do grupo é estendida pelo número de dias definido na política.
validateProperties JSON Validar se o nome de exibição de um grupo do Microsoft 365 ou apelido de email está em conformidade com as políticas de nomenclatura.
Atribuição de funções do aplicativo
List appRoleAssignments appRoleAssignment collection Obter os aplicativos e funções do aplicativo atribuídos a esse grupo.
Adicionar uma atribuição de função do aplicativo appRoleAssignment Atribuir uma função do aplicativo a esse grupo.
Remover uma atribuição de função do aplicativo Nenhum. Remover uma atribuição de função do aplicativo desse grupo.
Calendar
Criar evento event Criar um novo Event postando na coleção de eventos.
Obter evento event Ler as propriedades de um objeto event.
Listar eventos Coleção event Obter uma coleção de objetos de evento.
Atualizar evento Nenhum Atualizar as propriedades de um objeto event.
Excluir evento Nenhum Excluir o objeto event.
Listar calendarView Coleção event Obter um conjunto de eventos em uma janela de tempo especificada.
Conversas
Criar conversa conversa Crie uma nova conversa postando na coleção de conversas.
Obter conversa conversation Ler as propriedades de um objeto conversation.
Listar conversas Coleção conversation Obter uma coleção de objetos Conversation.
Excluir conversa Nenhum Excluir objeto conversation.
Criar thread conversationThread Criar um novo thread de conversa.
Acessar thread conversationThread Ler as propriedades de um objeto thread.
Listar threads Coleção conversationThread Obter todos os threads de um grupo.
Atualizar thread Nenhum Atualizar as propriedades de um objeto thread.
Excluir thread Nenhum Excluir objeto thread
Listar acceptedSenders Coleção directoryObject Obtenha uma lista de usuários ou grupos que estão na lista de remetentes aceitos para este grupo.
Adicionar acceptedSender directoryObject Adicionar um Usuário ou Grupo à coleção acceptSenders.
Remover acceptedSender directoryObject Remover um Usuário ou Grupo da coleção acceptedSenders.
Listar rejectedSenders Coleção directoryObject Obtenha uma lista de usuários ou grupos que estão na lista de remetentes rejeitados para este grupo.
Adicionar rejectedSender directoryObject Adicionar um novo Usuário ou Grupo à coleção rejectedSenders.
Remover rejectedSender directoryObject Remover um novo Usuário ou Grupo da coleção Remetentesrejeitados.
Objetos de diretório
Listar grupos excluídos Coleção directoryObject Recupere os grupos excluídos no locatário nos últimos 30 dias.
Listar grupos excluídos pertencentes ao usuário Coleção directoryObject Recupere os grupos excluídos no locatário nos últimos 30 dias e que pertencem a um usuário.
Obter grupo excluído Coleção directoryObject Recupere um grupo excluído por ID.
Restaurar grupo excluído Coleção directoryObject Restaure um grupo excluído no locatário nos últimos 30 dias.
Excluir permanentemente um grupo Coleção directoryObject Exclua permanentemente um grupo excluído do locatário.
checkMemberGroups Coleção de cadeias de caracteres Verificar associação em uma lista de grupos. Essa função é transitiva.
getMemberGroups Coleção de cadeias de caracteres Retornar todos os grupos dos quais o grupo é membro. Essa função é transitiva.
checkMemberObjects Coleção de cadeias de caracteres Verifique se há associação em uma lista de objetos de grupo, função de diretório ou unidade administrativa. A função é transitiva.
getMemberObjects Coleção de cadeias de caracteres Retornar todas as unidades administrativas e grupos dos quais o grupo é membro. Essa função é transitiva.
Extensões abertas
Criar extensão aberta openTypeExtension Crie uma extensão aberta e adicione propriedades personalizadas a uma instância nova ou existente de um recurso.
Obter extensão aberta Coleção openTypeExtension Obtenha uma extensão aberta identificada pelo nome da extensão.
Extensões de esquema
Adicionar valores de extensões de esquema Nenhum Cria uma definição para a extensão de esquema e usa-a para adicionar dados digitados personalizados a um recurso.
Outros recursos de grupo
Listar fotos Coleção profilePhoto Obter um conjunto de fotos de perfil para o grupo.
Listar plannerPlans Coleção plannerPlan Obter os planos de planejador pertencentes ao grupo.
Listar as permissionGrants Coleção resourceSpecificPermissionGrant Liste as permissões que foram concedidas aos aplicativos para acessar o grupo.
Configurações do usuário
addFavorite Nenhum Adicionar o grupo à lista de grupos favoritos do usuário conectado. Suportado apenas para grupos do Microsoft 365.
removeFavorite Nenhum Remova o grupo da lista de grupos favoritos do usuário que se inscreveu. Somente grupos do Microsoft 365 com suporte.
Listar memberOf 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 joinedTeams 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.
subscribeByMail Nenhum Defina a propriedade isSubscribedByMail como true. Permitindo que o usuário conectado receba conversas por email. Compatível apenas para grupos do Microsoft 365.
unsubscribeByMail Nenhum Defina a propriedade isSubscribedByMail como false. Desabilitando o usuário conectado de receber conversas de email. Compatível apenas para grupos do Microsoft 365.
resetUnseenCount Nenhum Redefinir a Contagem Não Vista para 0 de todas as postagens que o usuário que se inscreveu não viu desde sua última visita. Somente grupos do Microsoft 365 com suporte.

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, consulte Funcionalidades avançadas de consulta nos objetos de diretório do Microsoft Azure AD.

Propriedade Tipo Descrição
allowExternalSenders Boolean Indica se as pessoas externas à organização podem enviar mensagens para o grupo. O valor padrão é false.

Retornado somente em $select. Com suporte apenas para a API Get group (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.
assignedLicenses Coleção assignedLicense As licenças que são atribuídas ao grupo.

Retornado apenas em $select. Suportes $filter (eq). Somente leitura.
autoSubscribeNewMembers Boolean Indica se novos membros adicionados ao grupo serão automaticamente inscritos para receberem notificações por email. Você pode definir essa propriedade em uma solicitação PATCH para o grupo. Não a defina na solicitação POST inicial que cria esse grupo. O valor padrão é false.

Retornado somente em $select. Com suporte apenas para a API Get group (GET /groups/{ID}).
classificação String Descreve uma classificação para o grupo (como impacto comercial baixo, médio ou alto). Os valores válidos para esta propriedade são definidos criando um valor de configuração ClassificationList com base na definição de modelo.

Retornado por padrão. Suporta $filter (eq, ne, not, ge, le, startsWith).
createdByAppId Cadeia de caracteres ID do aplicativo usado para criar o grupo. Pode ser nulo para alguns grupos.

Retornado por padrão. Somente leitura. Suporta $filter (eq, ne, not, in, startsWith).
createdDateTime DateTimeOffset Carimbo de data/hora da ocasião em que o grupo foi criado. Não é possível modificar o valor e ele é 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 em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z.

Retornado por padrão. Suporta $filter (eq, ne, not, ge, le, in). Somente leitura.
deletedDateTime DateTimeOffset Para alguns objetos do Azure Active Directory (usuário, grupo, aplicativo), se o objeto for excluído, ele será primeiro excluído logicamente e essa propriedade será atualizada com a data e hora em que o objeto foi excluído. Caso contrário, esta propriedade é nula. Se o objeto for restaurado, essa propriedade será atualizada para nula.
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. Obrigatório. O comprimento máximo é de 256 caracteres.

Retornado por padrão. Suporta $filter (eq, ne, not, ge, le, in, startsWith, e eq em null valores), $search, e $orderBy.
expirationDateTime DateTimeOffset Data e hora de quando o grupo está configurado para expirar. Não é possível modificar o valor e ele é 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 em 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 será Microsoft 365 grupo; caso contrário, é um grupo de segurança ou grupo de distribuição. Para obter detalhes, consulte visão geral dos 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.

Essa propriedade nunca é retornada em uma operação GET. Você pode usá-lo como um $filter para obter grupos que têm membros com erros de licença (ou seja, filtrar essa propriedade sendo true).

Suporta $filter (eq).
hideFromAddressLists Booliano true se o grupo não for exibido em determinadas partes da interface do usuário do Outlook: no Catálogo de Endereços, em listas de endereços para selecionar destinatários de mensagens e na caixa de diálogo Procurar grupos para pesquisar grupos; caso contrário, false. O valor padrão é false.

Retornado somente em $select. Compatível apenas com a API Obter grupo (GET /groups/{ID}).
hideFromOutlookClients Booliano true se o grupo não for exibido em clientes do Outlook, como Outlook para Windows e Outlook na Web, caso contrário, false. O valor padrão é false.

Retornado somente em $select. Compatível apenas com a API Obter 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 do Azure Active Directory. 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 deverá ser definida como true e o grupo não poderá ser um grupo dinâmico (ou seja, groupTypes não pode conter DynamicMembership). Somente chamadores em funções de Administrador global e de Administrador de funções com privilégios podem definir essa propriedade. O chamador deve receber a permissão RoleManagement.ReadWrite.Directory para definir essa propriedade ou atualizar a associação desses grupos. Para obter mais informações, confira Usando um grupo para gerenciar atribuições de função do Azure Active Directory

Retornado por padrão. Suporta $filter (eq, ne, not).
infoCatalogs Conjunto de cadeias de caracteres Identifica os segmentos de informações atribuídos ao grupo. Retornado por padrão. Dá suporte $filter (eq, not, ge, le, startsWith).
isSubscribedByMail Boolean Indica se o usuário conectado está inscrito para receber conversas por email. O valor padrão é true.

Retornado somente em $select. Com suporte apenas para a API Get group (GET /groups/{ID}).
licenseProcessingState String Indica o status da atribuição de licença de grupo a todos os membros do grupo. Valores possíveis: QueuedForProcessing, ProcessingInProgresse ProcessingComplete.

Retornado apenas em $select. Somente leitura.
email String O endereço SMTP do grupo, por exemplo, "serviceadmins@contoso.onmicrosoft.com".

Retornado por padrão. Somente leitura. Suporta $filter (eq, ne, not, ge, le, in, startsWith, e eq em null valores).
mailEnabled Boolean Especifica se o grupo está habilitado para email. Obrigatório.

Devolvido por padrão. Suporte $filter (eq, ne, not, e eq no null valores).
mailNickname String O alias de email do grupo, exclusivo para grupos do Microsoft 365 na organização. O comprimento máximo é de 64 caracteres. Essa propriedade pode conter apenas caracteres no conjunto de caracteres ASCII de 0 a 127, exceto o seguinte: @ () \ [] " ; : . <> , SPACE.

Retornado por padrão. Suporta $filter (eq, ne, not, ge, le, in, startsWith).
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).
membershipRuleProcessingStatus membershipRuleProcessingStatus Descreve o status de processamento para grupos dinâmicos baseados em regras. A propriedade é null para grupos dinâmicos não baseados em regras ou se o processamento do grupo dinâmico foi pausado.

Retornado somente no $select. Compatível apenas com a API obter grupo (GET /groups/{ID}). Somente leitura.
onPremisesDomainName String Contém o FQDN de domínio local, também chamado dnsDomainName sincronizado do diretório local. A propriedade só é populada para clientes que estão sincronizando seu diretório local para Azure Active Directory via Azure AD Connect.

Retornado por padrão. Somente leitura.
onPremisesLastSyncDateTime DateTimeOffset Indica a última vez em que o grupo foi sincronizado com o diretório local. O tipo de carimbo de data/hora representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 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 nome netBios sincronizado do diretório local. A propriedade só é populada para clientes que estão sincronizando seu diretório local para Azure Active Directory via Azure AD 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 String Contém o nome da conta SAM sincronizado do diretório local. A propriedade só é populada para clientes que estão sincronizando seu diretório local para Azure Active Directory via Azure AD Connect.

Retornado por padrão. Suporta $filter (eq, ne, not, ge, le, in, startsWith). Somente leitura.
onPremisesSecurityIdentifier String Contém o identificador de segurança (SID) local do grupo que foi sincronizado do local com a nuvem.

Retornado por padrão. Suporta $filter(eq inclusive em null valores). Somente leitura.
onPremisesSyncEnabled Booliano true se esse grupo está sincronizado de um diretório local; false se esse grupo foi originalmente sincronizado de um diretório local, mas não está mais sincronizado; null se esse objeto nunca foi sido sincronizado de um diretório local (padrão).

Retornado por padrão. Somente leitura. Suporta $filter (eq, ne, not, in e eq em 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 essa propriedade, o usuário de chamada deve ter uma das seguintes funções do Azure AD:
  • Administrador Global
  • Administrador de Conta de Usuário
  • Escritor de Diretórios
  • Administrador do Exchange
  • Administrador do SharePoint

Para obter mais informações sobre essa propriedade, consulte OneDrive Online Multi-Geo.

Anulável. Retornado por padrão.
preferredLanguage Cadeia de caracteres O idioma preferencial para um Microsoft 365 grupo. Deve seguir o código ISO 639-1; por exemplo, en-US.

Retornado por padrão. Suporta $filter (eq, ne, not, ge, le, in, startsWith, e eq em 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 expressões de filtro em propriedades de vários valores.

Retornado por padrão. Somente leitura. Não anulável. Dá suporte a $filter (eq, not, ge, le, startsWith, endsWith e a contagem de coleções vazias).
renewedDateTime DateTimeOffset Carimbo de data/hora da ocasião em que o grupo foi renovado pela última vez. Não é possível modificar isso diretamente e a atualização ocorre apenas por meio da ação de renovação de serviço. 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 em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z.

Retornado por padrão. Suporta $filter (eq, ne, not, ge, le, in). Somente leitura.
resourceBehaviorOptions Conjunto de cadeias de caracteres Especifica os comportamentos de grupo que podem ser configurados para um grupo do Microsoft 365 durante sua criação. Isso só pode ser definido como parte da criação (POST). Os valores possíveis são AllowOnlyMembersToPost, HideGroupInOutlook, SubscribeNewGroupMembers, WelcomeEmailDisabled. Para obter mais informações, confira o artigo Definir as opções de provisionamento e comportamentos de grupo do Microsoft 365 .
resourceProvisioningOptions Conjunto de cadeias de caracteres Especifica os recursos de grupo provisionados como parte da criação de grupos do Microsoft 365 que não costumam fazer parte do processo padrão de criação de grupos. Um valor possível é Team. Para obter mais informações, confira o artigo Definir as opções de provisionamento e comportamentos de grupo do Microsoft 365 .

Retornado por padrão. Suporta $filter (eq, not, startsWith.
securityEnabled Boolean Especifica se o grupo é um grupo de segurança. Obrigatório.

Retornado por padrão. Dá suporte $filter (eq, ne, not, in).
securityIdentifier Cadeia de Caracteres Identificador de segurança do grupo, usado em cenários do Windows.

Retornado por padrão.
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, Orange ou Red.

Retornado por padrão.
unseenConversationsCount Int32 Contagem de conversas que foram entregues em uma ou mais postagens novas desde a última visita do usuário conectado ao grupo. Essa propriedade é a mesma que unseenCount.

Retornado apenas em $select.
unseenCount Int32 Contagem de conversas que receberam novas postagens desde que o usuário conectado visitou o grupo pela última vez. Essa propriedade é a mesma que unseenConversationsCount.

Retornado somente em $select. Compatível apenas com a API Obter grupo (GET /groups/{ID}).
unseenMessagesCount Int32 Contagem de novas postagens que foram entregues às conversas do grupo desde a última visita do usuário conectado ao grupo.

Retornado apenas em $select.
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 pode ser definido apenas 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, um grupo de segurança é criado como Private por padrão e o grupo Microsoft 365 é Public. Grupos atribuídos a funções são sempre Private. Saiba mais em Opções de visibilidade do grupo.

Retornado por padrão. Anulável.
writebackConfiguration groupWritebackConfiguration Especifica se um grupo está configurado ou não para gravar de volta as propriedades do objeto de grupo no Active Directory local. Essas propriedades são usadas quando o write-back de grupo é configurado no cliente de sincronização do Azure AD Connect.

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 o conteúdo do grupo.
Privado A permissão de proprietário é necessária para ingressar no grupo.
Não membros não podem exibir o conteúdo do grupo.
HiddenMembership A permissão de proprietário é necessária para ingressar no grupo.
Não membros não podem exibir o conteúdo do grupo.
Não membros não podem ver os membros do grupo.
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 usuários ou grupos que têm permissão para criar eventos de calendário ou postagens nesse grupo. Se essa lista não estiver vazia, somente os usuários ou grupos listados aqui poderão fazer postagens.
appRoleAssignments appRoleAssignment collection Representa as funções de aplicativo que um grupo recebeu para um aplicativo. Dá suporte $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. Observação: isso não será definido se o usuário for um administrador. Somente leitura.
drive unidade A unidade padrão do grupo. Somente leitura.
unidades Coleção drive As unidades do grupo. Somente leitura.
pontos de extremidade conjunto Ponto de extremidade Pontos de extremidade do grupo. Somente leitura. Anulável.
eventos Coleção event Eventos 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 A coleção de políticas de ciclo de vida para este grupo. Somente leitura. Anulável.
memberOf Coleção directoryObject Grupos e unidades administrativas dos qual esse grupo é membro. Métodos HTTP: GET (com suporte para todos os grupos). Somente leitura. Anulável. Dá suporte $expand.
members Coleção directoryObject Membros diretos 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 usuário Uma lista de membros do grupo com erros de licença desta atribuição de licença baseada em grupo. 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. Anulável. Se essa propriedade não for especificada ao criar um grupo Microsoft 365, o usuário chamador será atribuído automaticamente como o proprietário do grupo.
Suporta $expand incluindo $select aninhado. Por exemplo, /groups?$filter=startsWith(displayName,'Role')&$select=id,displayName&$expand=owners($select=id,userPrincipalName,displayName).
permissionGrants resourceSpecificPermissionGrant As permissões que foram concedidas a um grupo para um aplicativo específico. Suporta $expand.
photo profilePhoto A foto de perfil do grupo.
fotos Coleção profilePhoto As fotos de perfil pertencentes ao grupo. Somente leitura. Anulável.
planejador plannerGroup Serviços do Planejador Seletivo disponíveis para o grupo. Somente leitura. Nullable.
rejectedSenders Coleção directoryObject A lista de usuários ou grupos que não têm permissão para criar eventos de calendário ou postagens nesse grupo. Anulável
configurações conjunto directorySetting Configurações que podem reger o comportamento desse grupo, como se os membros podem convidar usuários convidados para o grupo. Nullable.
sites conjunto de sites A lista de sites do SharePoint nesse grupo. Acesse o site padrão com /sites/root.
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, seja diretamente ou através de afiliação aninhada. Anulável.
transitiveMembers Coleção directoryObject Os membros diretos e transitórios de um grupo. Anulável.

Representação JSON

Veja a seguir uma representação JSON do recurso.

{
  "accessType": "String",
  "assignedLabels": [{ "@odata.type": "microsoft.graph.assignedLabel" }],
  "assignedLicenses": [{ "@odata.type": "microsoft.graph.assignedLicense" }],
  "allowExternalSenders": false,
  "autoSubscribeNewMembers": true,
  "createdByAppId": "String",
  "createdDateTime": "String (timestamp)",
  "deletedDateTime": "String (timestamp)",
  "description": "String",
  "displayName": "String",
  "expirationDateTime": "String (timestamp)",
  "groupTypes": ["String"],
  "hideFromAddressLists": false,
  "hideFromOutlookClients": false,
  "id": "String (identifier)",
  "isFavorite": true,
  "isArchived": false,
  "isAssignableRole": false,
  "isSubscribedByMail": true,
  "licenseProcessingState": "String",
  "mail": "String",
  "mailEnabled": true,
  "mailNickname": "String",
  "onPremisesDomainName": "String",
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesNetBiosName": "String",
  "onPremisesProvisioningErrors": [
    { "@odata.type": "microsoft.graph.onPremisesProvisioningError" }
  ],
  "onPremisesSamAccountName": "String",
  "onPremisesSecurityIdentifier": "String",
  "onPremisesSyncEnabled": true,
  "preferredDataLocation": "String",
  "proxyAddresses": ["String"],
  "renewedDateTime": "String (timestamp)",
  "resourceBehaviorOptions": ["String"],
  "resourceProvisioningOptions": ["String"],
  "securityEnabled": true,
  "securityIdentifier": "String",
  "unseenConversationsCount": 1024,
  "unseenCount": 1024,
  "unseenMessagesCount": 1024,
  "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" },
  "rejectedSenders": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "sites": [{ "@odata.type": "microsoft.graph.site" }],
  "threads": [{ "@odata.type": "microsoft.graph.conversationThread" }],
  "classification": "String",
  "hasMembersWithLicenseErrors": true,
  "membershipRule": "String",
  "membershipRuleProcessingState": "String",
  "membershipRuleProcessingStatus": {
    "@odata.type": "microsoft.graph.membershipRuleProcessingStatus"
  },
  "preferredLanguage": "String",
  "theme": "String"
}

Confira também