Compartilhar via

Grupos e usuários do MS Graph

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

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

Service Class Regions
Copilot Studio Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicativos Lógicos Standard Todas as regiões dos Aplicativos Lógicos , exceto as seguintes:
     – Regiões do Azure Governamental
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Power Apps Premium Todas as regiões do Power Apps , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Power Automate Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Jay Jani
Email jayjani@microsoft.com
Metadados do conector
Publicador Jay Jani
Site https://graph.microsoft.com
Política de privacidade https://privacy.microsoft.com/en-us/privacystatement
Categorias Operações de TI; Dados

Criando uma conexão

O conector dá suporte aos seguintes tipos de autenticação:
Default 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.

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Limitações

Nome Chamadas Período de renovação
Chamadas à API por conexão 100 60 segundos

Ações

Listar grupos por pesquisa de nome de exibição

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

Recuperar membros diretos de um grupo com contagem
Listar Skus inscritos

Detalhes das SKUs do plano de licença subscrito da organização
Listar usuários

Recuperar todos os usuários na organização (Locatário da ID do Microsoft Entra)
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 de grupo

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

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

Nome Chave Obrigatório Tipo Description
Pesquisar por nome de exibição
 $search string

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

Retornos

Nome Caminho Tipo Description
Contexto Odata
 @odata.context string

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

@odata.count
value
 value array of object

value
ID
 value.id string

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

Data e hora da exclusão de grupo
Classification
 value.classification string

Classificação do grupo
Hora da Data Criada
 value.createdDateTime string

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

Opções criadas do grupo.
Description
 value.description string

Descrição do grupo
Nome de Exibição
 value.displayName string

Nome de exibição do grupo
Hora da data de validade
 value.expirationDateTime string

Data de validade do grupo
groupTypes
 value.groupTypes array of string

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

Uma função pode ser atribuída a esse grupo?
Mail
 value.mail string

Email do grupo
Email Habilitado
 value.mailEnabled boolean

O email de grupo está habilitado?
Nome do Email Nick
 value.mailNickname string

Nome do nick de email do grupo
Regra de associação
 value.membershipRule string

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

O estado de processamento da regra que é usada para avaliação de associação.
Nome de Domínio OnPremises
 value.onPremisesDomainName string

Contém o domainFQDN local, também chamado dnsDomainName sincronizado do diretório local.
Hora da Data da Última Sincronização do OnPremises
 value.onPremisesLastSyncDateTime string

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

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

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

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

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

Local de dados preferencial do grupo.
Idioma Preferencial
 value.preferredLanguage string

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

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

Hora da data renovada do grupo.
resourceBehaviorOptions
 value.resourceBehaviorOptions array of

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

Opções de provisionamento de recursos do grupo.
Segurança Habilitada
 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.
Tema
 value.theme string

Tema do grupo de IDs do Microsoft Entra.
Visibilidade
 value.visibility string

Visibilidade do grupo.
onPremisesProvisioningErrors
 value.onPremisesProvisioningErrors array of

Erros de provisionamento local do grupo.

Listar membros do grupo direto

ID da operação:
ListDirectGroupMembers

Recuperar membros diretos de um grupo com contagem

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do objeto do grupo de IDs do Microsoft Entra
 group-id True string

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

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

Selecione quais colunas recuperar

Retornos

Nome Caminho Tipo Description
Contexto Odata
 @odata.context string

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

@odata.count
value
 value array of object

value
Tipo Odata
 value.@odata.type string

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

Nome completo do membro
Nome Principal do Usuário
 value.userPrincipalName string

Nome da entidade de usuário do membro
ID
 value.id string

ID do objeto para o membro
Cargo
 value.jobTitle string

título do cargo
Nome do Email Nick
 value.mailNickname string

Nome do nick de email do membro
Mail
 value.mail string

Email do membro
Nome
 value.givenName string

Nome do membro
Surname
 value.surname string

Sobrenome do membro
businessPhones
 value.businessPhones array of string

businessPhones
Celular
 value.mobilePhone string

mobilePhone
Localização do Office
 value.officeLocation string

officeLocation
Idioma Preferencial
 value.preferredLanguage string

Idioma preferencial, conforme configurado na ID do Microsoft Entra.

Listar Skus inscritos

ID da operação:
ListSubscribedSkus

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

Retornos

Nome Caminho Tipo Description
Contexto Odata
 @odata.context string

O link Odata.context.
value
 value array of object

value
Status da funcionalidade
 value.capabilityStatus string

Status da funcionalidade do SKU
Unidades consumidas
 value.consumedUnits integer

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

id
ID DA SKU
 value.skuId string

Identificador exclusivo global de SKU
Número da parte do SKU
 value.skuPartNumber string

Nome da SKU
Aplica-se a
 value.appliesTo string

A quem a SKU se aplica?
Enabled
 value.prepaidUnits.enabled integer

Unidades habilitadas
Suspenso
 value.prepaidUnits.suspended integer

Unidades suspensas
Aviso
 value.prepaidUnits.warning integer

Unidades em aviso
servicePlans
 value.servicePlans array of object

servicePlans
servicePlanId
 value.servicePlans.servicePlanId string

servicePlanId
servicePlanName
 value.servicePlans.servicePlanName string

servicePlanName
status de provisionamento
 value.servicePlans.provisioningStatus string

status de provisionamento
aplica-sePara
 value.servicePlans.appliesTo string

aplica-sePara

Listar usuários

ID da operação:
ListUsers

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

Retornos

Nome Caminho Tipo Description
@odata.context
 @odata.context string

O link Odata.context.
value
 value array of object

value
businessPhones
 value.businessPhones array of string

businessPhones
Nome de Exibição
 value.displayName string

Nome completo do usuário
Nome
 value.givenName string

Nome do usuário
Cargo
 value.jobTitle string

Título do trabalho do usuário
Mail
 value.mail string

Email do usuário
Celular
 value.mobilePhone string

Telefone celular do usuário
Localização do Office
 value.officeLocation string

Localização do escritório do usuário
Idioma Preferencial
 value.preferredLanguage string

Idioma preferencial do usuário
Surname
 value.surname string

Sobrenome do usuário
Nome Principal do Usuário
 value.userPrincipalName string

Nome principal do usuário
ID
 value.id string

ID do objeto do usuário

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

Nome Chave Obrigatório Tipo Description
ID do objeto do membro (usuário) da ID do Microsoft Entra
 id True string

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

Seleção de pontos de dados (colunas)

Retornos

Nome Caminho Tipo Description
Contexto Odata
 @odata.context string

O link Odata.context.
value
 value array of object

value
ID
 value.id string

id
ID DA SKU
 value.skuId string

ID da SKU.
Número da parte do SKU
 value.skuPartNumber string

Nome da SKU
servicePlans
 value.servicePlans array of object

servicePlans
servicePlanId
 value.servicePlans.servicePlanId string

servicePlanId
servicePlanName
 value.servicePlans.servicePlanName string

servicePlanName
status de provisionamento
 value.servicePlans.provisioningStatus string

status de provisionamento
aplica-sePara
 value.servicePlans.appliesTo string

aplica-sePara

Obter grupos de membros

ID da operação:
GetMemberGroups

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

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do objeto do membro (usuário) da ID do Microsoft Entra
 member-id True string

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

Deseja recuperar apenas grupos habilitados para segurança?

Retornos

Nome Caminho Tipo Description
Contexto Odata
 @odata.context string

O link Odata.context.
value
 value array of string

value

Obter propriedades de grupo

ID da operação:
GetGroupProperties

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

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do objeto do grupo de IDs do Microsoft Entra
 group-id True string

ID do objeto do grupo de IDs do Microsoft Entra

Retornos

Nome Caminho Tipo Description
Contexto Odata
 @odata.context string

O link Odata.context.
ID
 id string

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

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

classificação
Hora da Data Criada
 createdDateTime string

Hora da data de criação do grupo
creationOptions
 creationOptions array of string

Opções criadas do grupo.
Description
 description string

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

Nome de exibição do grupo
Hora da data de validade
 expirationDateTime string

Data de validade do grupo
groupTypes
 groupTypes array of string

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

Uma função pode ser atribuída a esse grupo?
Mail
 mail string

Email do grupo
Email Habilitado
 mailEnabled boolean

O email de grupo está habilitado?
Nome do Email Nick
 mailNickname string

Nome do nick de email do grupo
Regra de associação
 membershipRule string

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

O estado de processamento da regra que é usada para avaliação de associação.
Nome de Domínio OnPremises
 onPremisesDomainName string

Contém o domainFQDN local, também chamado dnsDomainName sincronizado do diretório local.
Hora da Data da Última Sincronização do OnPremises
 onPremisesLastSyncDateTime string

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

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

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

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

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

Local de dados preferencial do grupo.
Idioma Preferencial
 preferredLanguage string

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

Endereços proxy do grupo.
Hora da Data Renovada
 renewedDateTime string

Hora da data renovada do grupo.
resourceBehaviorOptions
 resourceBehaviorOptions array of string

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

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

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

Identificador de segurança do grupo.
Tema
 theme string

Tema do grupo de IDs do Microsoft Entra.
Visibilidade
 visibility string

Visibilidade do grupo.
onPremisesProvisioningErrors
 onPremisesProvisioningErrors array of string

Erros de provisionamento local do grupo.