Partilhar via

Grupos e usuários do MS Graph

O conector MS Graph Groups and Users ajuda a recuperar grupos de ID do Microsoft Entra, membros (usuários) e detalhes de licença

Este conector está disponível nos seguintes produtos e regiões:

Serviço Class Regiões
Estúdio Copiloto Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure Government
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Aplicações Power Premium Todas as regiões do Power Apps , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Automatize o poder Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Jay Jani, Microsoft
Email jayjani@microsoft.com
Metadados do conector
Editora Jay Jani
Sítio Web https://graph.microsoft.com
Política de privacidade https://privacy.microsoft.com/en-us/privacystatement
Categorias Operações de TI; Dados

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:
Predefinição Parâmetros para criar conexão. Todas as regiões Não compartilhável

Padrão

Aplicável: Todas as regiões

Parâmetros para criar conexão.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Limites de Limitação

Name Chamadas Período de Renovação
Chamadas de API por conexão 100 60 segundos

Ações

Lista de Skus Subscritos

Detalhes dos SKUs do plano de licença subscrito da organização
Lista de Utilizadores

Recuperar todos os usuários na organização (Locatário do Microsoft Entra ID)
Listar grupos por pesquisa de nome de exibição

Recuperar grupos pesquisando o nome de exibição do grupo
Listar membros diretos do grupo

Recuperar membros diretos de um grupo com contagem
Obter detalhes da licença de membro

Recuperar os detalhes da licença do membro do grupo (usuário)
Obter grupos de membros

Associações de grupo para um usuário (membro)
Obter propriedades do grupo

Recuperar propriedades e relações de um grupo de ID do Microsoft Entra

Lista de Skus Subscritos

ID da Operação:
ListSubscribedSkus

Detalhes dos SKUs do plano de licença subscrito da organização

Devoluções

Name Caminho Tipo Description
Contexto Odata
 @odata.context string

O link Odata.context.
valor
 value array of object

valor
Status da capacidade
 value.capabilityStatus string

Status de capacidade do SKU
Unidades consumidas
 value.consumedUnits integer

Quantas unidades de SKU já são consumidas?
ID
 value.id string

id
ID de SKU
 value.skuId string

Identificador global exclusivo de SKU
Número de peça SKU
 value.skuPartNumber string

Nome do SKU
Aplica-se a
 value.appliesTo string

A quem se aplica o SKU?
Ativado(a)
 value.prepaidUnits.enabled integer

Unidades habilitadas
Suspenso
 value.prepaidUnits.suspended integer

Unidades suspensas
Advertência
 value.prepaidUnits.warning integer

Unidades em alerta
Planos de Serviço
 value.servicePlans array of object

Planos de Serviço
servicePlanId
 value.servicePlans.servicePlanId string

servicePlanId
servicePlanName
 value.servicePlans.servicePlanName string

servicePlanName
estadoDeProvisionamento
 value.servicePlans.provisioningStatus string

estadoDeProvisionamento
aplica-seTo
 value.servicePlans.appliesTo string

aplica-seTo

Lista de Utilizadores

ID da Operação:
ListUsers

Recuperar todos os usuários na organização (Locatário do Microsoft Entra ID)

Devoluções

Name Caminho Tipo Description
@odata.CONTEXTO
 @odata.context string

O link Odata.context.
valor
 value array of object

valor
businessTelefones
 value.businessPhones array of string

businessTelefones
Nome de exibição
 value.displayName string

Nome completo do utilizador
Nome Próprio
 value.givenName string

Nome próprio do utilizador
Cargo
 value.jobTitle string

Cargo do usuário
Correio
 value.mail string

E-mail do utilizador
Telemóvel
 value.mobilePhone string

Telemóvel do utilizador
Localização do escritório
 value.officeLocation string

Localização do escritório do utilizador
Língua preferida
 value.preferredLanguage string

Língua preferida do utilizador
Surname
 value.surname string

Apelido do utilizador
Nome Principal do Utilizador
 value.userPrincipalName string

Nome principal do utilizador
ID
 value.id string

ID do objeto do usuário

Listar grupos por pesquisa de nome de exibição

ID da Operação:
ListGroupsByDisplayNameSearch

Recuperar grupos pesquisando o nome de exibição do grupo

Parâmetros

Name Chave Necessário Tipo Description
Pesquisar por nome de exibição
 $search string

Pesquisar por palavra-chave no nome de exibição do grupo Microsoft Entra ID

Devoluções

Name Caminho Tipo Description
Contexto Odata
 @odata.context string

O link Odata.context.
Número de Grupos
 @odata.count integer

@odata.count
valor
 value array of object

valor
ID
 value.id string

ID do objeto do grupo
Data Hora Excluída
 value.deletedDateTime string

Data e hora da eliminação do grupo
Classification
 value.classification string

Classificação do grupo
Data de Criação Hora
 value.createdDateTime string

Data e hora da criação do grupo
criaçãoOpções
 value.creationOptions array of

Criou opções do grupo.
Description
 value.description string

Descrição para o grupo
Nome de exibição
 value.displayName string

Nome de exibição do grupo
Data de validade, hora
 value.expirationDateTime string

Hora da data de expiração do grupo
groupTypes
 value.groupTypes array of string

Tipos de grupo para o grupo.
É atribuível à função
 value.isAssignableToRole string

É possível atribuir uma função a este grupo?
Correio
 value.mail string

E-mail do grupo
Mail ativado
 value.mailEnabled boolean

O e-mail de grupo está ativado?
Mail Nick Nome
 value.mailNickname string

Nome nick de e-mail do grupo
Regra de adesão
 value.membershipRule string

A regra que é usada para a avaliação da associação.
Estado de processamento da regra de associação
 value.membershipRuleProcessingState string

O estado de processamento da regra usada para a avaliação da associação.
Nome de domínio local
 value.onPremisesDomainName string

Contém o domainFQDN local, também chamado dnsDomainName sincronizado a partir do diretório local.
Hora da data da última sincronização no local
 value.onPremisesLastSyncDateTime string

A hora e a data em que o locatário foi sincronizado pela última vez com o diretório local.
Nome NetBios OnPremises
 value.onPremisesNetBiosName string

Nome do serviço de rede para servidor local.
Nome da conta OnPremises Sam
 value.onPremisesSamAccountName string

Nome da conta Sam para o diretório local.
Identificador de segurança local
 value.onPremisesSecurityIdentifier string

O identificador de segurança local.
Sincronização local habilitada
 value.onPremisesSyncEnabled boolean

True se a sincronização local estiver habilitada para o grupo.
Localização de dados preferida
 value.preferredDataLocation string

Localização de dados preferida do grupo.
Língua preferida
 value.preferredLanguage string

Idioma preferencial conforme configurado no Microsoft Entra ID.
endereços de proxy
 value.proxyAddresses array of string

Endereços proxy do grupo.
Data renovada Hora
 value.renewedDateTime string

Data renovada hora do grupo.
resourceBehaviorOptions
 value.resourceBehaviorOptions array of

Opções de comportamento de recursos do grupo.
resourceProvisioningOptions
 value.resourceProvisioningOptions array of string

Opções de provisionamento de recursos do grupo.
Segurança ativada
 value.securityEnabled boolean

Indica se o grupo está habilitado para segurança.
Identificador de Segurança
 value.securityIdentifier string

Identificador de segurança do grupo.
Theme
 value.theme string

Tema do grupo Microsoft Entra ID.
Visibilidade
 value.visibility string

Visibilidade do grupo.
onPremisesProvisioningErrors
 value.onPremisesProvisioningErrors array of

Erros de provisionamento no local do grupo.

Listar membros diretos do grupo

ID da Operação:
ListDirectGroupMembers

Recuperar membros diretos de um grupo com contagem

Parâmetros

Name Chave Necessário Tipo Description
ID do objeto do grupo Microsoft Entra ID
 group-id True string

ID do objeto do grupo Microsoft Entra ID
Filtrar por
 $filter string

Filtrar por
Seleção de ponto de dados (coluna)
 $select string

Selecione quais colunas recuperar

Devoluções

Name Caminho Tipo Description
Contexto Odata
 @odata.context string

O link Odata.context.
Contagem de Odata
 @odata.count integer

@odata.count
valor
 value array of object

valor
Tipo Odata
 value.@odata.type string

@odata.type
Nome de exibição
 value.displayName string

Nome completo do membro
Nome Principal do Utilizador
 value.userPrincipalName string

Nome principal do usuário do membro
ID
 value.id string

ID do objeto para o membro
Cargo
 value.jobTitle string

título do trabalho
Mail Nick Nome
 value.mailNickname string

Nome do apelido do e-mail do membro
Correio
 value.mail string

E-mail do membro
Nome Próprio
 value.givenName string

Nome próprio do membro
Surname
 value.surname string

Apelido do membro
businessTelefones
 value.businessPhones array of string

businessTelefones
Telemóvel
 value.mobilePhone string

telemóvel
Localização do escritório
 value.officeLocation string

escritórioLocalização
Língua preferida
 value.preferredLanguage string

Idioma preferencial conforme configurado no Microsoft Entra ID.

Obter detalhes da licença de membro

ID da Operação:
GetMemberLicenseDetails

Recuperar os detalhes da licença do membro do grupo (usuário)

Parâmetros

Name Chave Necessário Tipo Description
ID do objeto do membro do ID do Microsoft Entra (usuário)
 id True string

ID do objeto do membro do ID do Microsoft Entra (usuário)
Seleção de pontos de dados (colunas)
 $select string

Seleção de pontos de dados (colunas)

Devoluções

Name Caminho Tipo Description
Contexto Odata
 @odata.context string

O link Odata.context.
valor
 value array of object

valor
ID
 value.id string

id
ID de SKU
 value.skuId string

ID do SKU.
Número de peça SKU
 value.skuPartNumber string

Nome do SKU
Planos de Serviço
 value.servicePlans array of object

Planos de Serviço
servicePlanId
 value.servicePlans.servicePlanId string

servicePlanId
servicePlanName
 value.servicePlans.servicePlanName string

servicePlanName
estadoDeProvisionamento
 value.servicePlans.provisioningStatus string

estadoDeProvisionamento
aplica-seTo
 value.servicePlans.appliesTo string

aplica-seTo

Obter grupos de membros

ID da Operação:
GetMemberGroups

Associações de grupo para um usuário (membro)

Parâmetros

Name Chave Necessário Tipo Description
ID do objeto do membro do ID do Microsoft Entra (usuário)
 member-id True string

ID do objeto do membro do ID do Microsoft Entra (usuário)
Apenas segurança ativada (true/false)
 securityEnabledOnly True boolean

Deseja recuperar apenas grupos habilitados para segurança?

Devoluções

Name Caminho Tipo Description
Contexto Odata
 @odata.context string

O link Odata.context.
valor
 value array of string

valor

Obter propriedades do grupo

ID da Operação:
GetGroupProperties

Recuperar propriedades e relações de um grupo de ID do Microsoft Entra

Parâmetros

Name Chave Necessário Tipo Description
ID do objeto do grupo Microsoft Entra ID
 group-id True string

ID do objeto do grupo Microsoft Entra ID

Devoluções

Name Caminho Tipo Description
Contexto Odata
 @odata.context string

O link Odata.context.
ID
 id string

ID do objeto do grupo
Data Hora Excluída
 deletedDateTime string

Hora da data de exclusão do grupo
Classification
 classification string

classificação
Data de Criação Hora
 createdDateTime string

Data de criação do grupo Hora
criaçãoOpções
 creationOptions array of string

Criou opções do grupo.
Description
 description string

descrição
Nome de exibição
 displayName string

Nome de exibição do grupo
Data de validade, hora
 expirationDateTime string

Hora da data de expiração do grupo
groupTypes
 groupTypes array of string

Tipos de grupo para o grupo.
É atribuível à função
 isAssignableToRole string

É possível atribuir uma função a este grupo?
Correio
 mail string

E-mail do grupo
Mail ativado
 mailEnabled boolean

O e-mail de grupo está ativado?
Mail Nick Nome
 mailNickname string

Nome nick de e-mail do grupo
Regra de adesão
 membershipRule string

A regra que é usada para a avaliação da associação.
Estado de processamento da regra de associação
 membershipRuleProcessingState string

O estado de processamento da regra usada para a avaliação da associação.
Nome de domínio local
 onPremisesDomainName string

Contém o domainFQDN local, também chamado dnsDomainName sincronizado a partir do diretório local.
Hora da data da última sincronização no local
 onPremisesLastSyncDateTime string

A hora e a data em que o locatário foi sincronizado pela última vez com o diretório local.
Nome NetBios OnPremises
 onPremisesNetBiosName string

Nome do serviço de rede para servidor local.
Nome da conta OnPremises Sam
 onPremisesSamAccountName string

Nome da conta Sam para o diretório local.
Identificador de segurança local
 onPremisesSecurityIdentifier string

O identificador de segurança local.
Sincronização local habilitada
 onPremisesSyncEnabled boolean

True se a sincronização local estiver habilitada para o grupo.
Localização de dados preferida
 preferredDataLocation string

Localização de dados preferida do grupo.
Língua preferida
 preferredLanguage string

Idioma preferencial conforme configurado no Microsoft Entra ID.
endereços de proxy
 proxyAddresses array of string

Endereços proxy do grupo.
Data renovada Hora
 renewedDateTime string

Data renovada hora do grupo.
resourceBehaviorOptions
 resourceBehaviorOptions array of string

Opções de comportamento de recursos do grupo.
resourceProvisioningOptions
 resourceProvisioningOptions array of string

Opções de provisionamento de recursos do grupo.
Segurança ativada
 securityEnabled boolean

Indica se o grupo está habilitado para segurança.
Identificador de Segurança
 securityIdentifier string

Identificador de segurança do grupo.
Theme
 theme string

Tema do grupo Microsoft Entra ID.
Visibilidade
 visibility string

Visibilidade do grupo.
onPremisesProvisioningErrors
 onPremisesProvisioningErrors array of string

Erros de provisionamento no local do grupo.