Gruppi e utenti di MS Graph
Il connettore MS Graph Groups and Users consente di recuperare i gruppi, i membri (utenti) e i dettagli della licenza di Microsoft Entra ID
Questo connettore è disponibile nei prodotti e nelle aree seguenti:
| Servizio | Class | Regions |
|---|---|---|
| Copilot Studio | Di alta qualità | Tutte le aree di Power Automate , ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| App per la logica | Normale | Tutte le aree di App per la logica , ad eccezione delle seguenti: - Aree di Azure per enti pubblici - Aree di Azure Cina - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Apps | Di alta qualità | Tutte le aree di Power Apps , ad eccezione dei seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Automate | Di alta qualità | Tutte le aree di Power Automate , ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Contatto | |
|---|---|
| Nome | Jay Jani, Microsoft |
| jayjani@microsoft.com |
| Metadati del connettore | |
|---|---|
| Editore | Jay Jani |
| Sito web | https://graph.microsoft.com |
| Informativa sulla privacy | https://privacy.microsoft.com/en-us/privacystatement |
| Categorie | Operazioni IT; Dati |
Creazione di una connessione
Il connettore supporta i tipi di autenticazione seguenti:
| Predefinita | Parametri per la creazione della connessione. | Tutte le aree geografiche | Non condivisibile |
Predefinito
Applicabile: tutte le aree
Parametri per la creazione della connessione.
Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.
Limiti per la limitazione delle richieste
| Nome | Chiamate | Periodo di rinnovo |
|---|---|---|
| Chiamate API per connessione | 100 | 60 secondi |
Azioni
| Elenca utenti |
Recuperare tutti gli utenti dell'organizzazione (Tenant ID Microsoft Entra) |
| Elencare gli SKU sottoscritti |
Dettagli degli SKU del piano di licenza sottoscritto dell'organizzazione |
| Elencare i membri del gruppo diretto |
Recuperare i membri diretti di un gruppo con conteggio |
| List Groups By Display Name Search |
Recuperare i gruppi eseguendo una ricerca nel nome visualizzato del gruppo |
| Ottenere gruppi di membri |
Appartenenze a gruppi per un utente (membro) |
| Ottenere i dettagli della licenza dei membri |
Recuperare i dettagli della licenza dei membri del gruppo (utente) |
| Ottenere le proprietà del gruppo |
Recuperare le proprietà e le relazioni di un gruppo microsoft Entra ID |
Elenca utenti
Recuperare tutti gli utenti dell'organizzazione (Tenant ID Microsoft Entra)
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
@odata.context
|
@odata.context | string |
Collegamento Odata.context. |
|
value
|
value | array of object |
value |
|
businessPhone
|
value.businessPhones | array of string |
businessPhone |
|
Nome visualizzato
|
value.displayName | string |
Nome completo dell'utente |
|
Nome
|
value.givenName | string |
Nome dell'utente |
|
Posizione
|
value.jobTitle | string |
Titolo di lavoro dell'utente |
|
Posta
|
value.mail | string |
Posta elettronica dell'utente |
|
Cellulare
|
value.mobilePhone | string |
Telefono cellulare dell'utente |
|
Posizione ufficio
|
value.officeLocation | string |
Posizione dell'ufficio dell'utente |
|
Lingua preferita
|
value.preferredLanguage | string |
Lingua preferita dell'utente |
|
Surname
|
value.surname | string |
Cognome dell'utente |
|
Nome principale dell'utente
|
value.userPrincipalName | string |
Nome dell'entità utente |
|
Documento d'identità
|
value.id | string |
ID oggetto dell'utente |
Elencare gli SKU sottoscritti
Dettagli degli SKU del piano di licenza sottoscritto dell'organizzazione
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Contesto Odata
|
@odata.context | string |
Collegamento Odata.context. |
|
value
|
value | array of object |
value |
|
Stato funzionalità
|
value.capabilityStatus | string |
Stato della funzionalità dello SKU |
|
Unità utilizzate
|
value.consumedUnits | integer |
Quante unità SKU vengono già utilizzate? |
|
Documento d'identità
|
value.id | string |
id |
|
SKU ID
|
value.skuId | string |
Identificatore univoco globale dello SKU |
|
Numero parte SKU
|
value.skuPartNumber | string |
Nome dello SKU |
|
Si applica a
|
value.appliesTo | string |
A chi si applica lo SKU? |
|
Enabled
|
value.prepaidUnits.enabled | integer |
Unità abilitate |
|
Sospeso
|
value.prepaidUnits.suspended | integer |
Unità sospese |
|
Avvertimento
|
value.prepaidUnits.warning | integer |
Unità di avviso |
|
servicePlans
|
value.servicePlans | array of object |
servicePlans |
|
servicePlanId
|
value.servicePlans.servicePlanId | string |
servicePlanId |
|
servicePlanName
|
value.servicePlans.servicePlanName | string |
servicePlanName |
|
provisioningStatus
|
value.servicePlans.provisioningStatus | string |
provisioningStatus |
|
si applicaA
|
value.servicePlans.appliesTo | string |
si applicaA |
Elencare i membri del gruppo diretto
Recuperare i membri diretti di un gruppo con conteggio
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID oggetto del gruppo Microsoft Entra ID
|
group-id | True | string |
ID oggetto del gruppo Microsoft Entra ID |
|
Filtra per
|
$filter | string |
Filtra per |
|
|
Selezione del punto dati (colonna)
|
$select | string |
Selezionare le colonne da recuperare |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Contesto Odata
|
@odata.context | string |
Collegamento Odata.context. |
|
Conteggio Odata
|
@odata.count | integer |
@odata.count |
|
value
|
value | array of object |
value |
|
Tipo Odata
|
value.@odata.type | string |
@odata.type |
|
Nome visualizzato
|
value.displayName | string |
Nome completo del membro |
|
Nome principale dell'utente
|
value.userPrincipalName | string |
Nome dell'entità utente del membro |
|
Documento d'identità
|
value.id | string |
ID oggetto per il membro |
|
Posizione
|
value.jobTitle | string |
titolo di lavoro |
|
Mail Nick Name
|
value.mailNickname | string |
Nome nick di posta elettronica del membro |
|
Posta
|
value.mail | string |
Messaggio di posta elettronica del membro |
|
Nome
|
value.givenName | string |
Nome del membro |
|
Surname
|
value.surname | string |
Cognome del membro |
|
businessPhone
|
value.businessPhones | array of string |
businessPhone |
|
Cellulare
|
value.mobilePhone | string |
telefono cellulare |
|
Posizione ufficio
|
value.officeLocation | string |
officeLocation |
|
Lingua preferita
|
value.preferredLanguage | string |
Lingua preferita configurata in Microsoft Entra ID. |
List Groups By Display Name Search
Recuperare i gruppi eseguendo una ricerca nel nome visualizzato del gruppo
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Cerca in base al nome visualizzato
|
$search | string |
Cercare per parola chiave nel nome visualizzato del gruppo Microsoft Entra ID |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Contesto Odata
|
@odata.context | string |
Collegamento Odata.context. |
|
Numero di gruppi
|
@odata.count | integer |
@odata.count |
|
value
|
value | array of object |
value |
|
Documento d'identità
|
value.id | string |
ID oggetto del gruppo |
|
Data/ora eliminata
|
value.deletedDateTime | string |
Data e ora di eliminazione del gruppo |
|
Classification
|
value.classification | string |
Classificazione del gruppo |
|
Data creazione
|
value.createdDateTime | string |
Data e ora di creazione del gruppo |
|
creationOptions
|
value.creationOptions | array of |
Opzioni create del gruppo. |
|
Description
|
value.description | string |
Descrizione per il gruppo |
|
Nome visualizzato
|
value.displayName | string |
Nome visualizzato del gruppo |
|
Data di scadenza
|
value.expirationDateTime | string |
Data di scadenza del gruppo |
|
groupTypes
|
value.groupTypes | array of string |
Tipi di gruppo per il gruppo. |
|
È assegnabile al ruolo
|
value.isAssignableToRole | string |
È possibile assegnare un ruolo a questo gruppo? |
|
Posta
|
value.mail | string |
Posta elettronica del gruppo |
|
Posta abilitata
|
value.mailEnabled | boolean |
La posta elettronica di gruppo è abilitata? |
|
Mail Nick Name
|
value.mailNickname | string |
Nome dell'indirizzo di posta elettronica del gruppo |
|
Regola di appartenenza
|
value.membershipRule | string |
Regola utilizzata per la valutazione dell'appartenenza. |
|
Stato di elaborazione delle regole di appartenenza
|
value.membershipRuleProcessingState | string |
Stato di elaborazione della regola utilizzata per la valutazione dell'appartenenza. |
|
Nome di dominio OnPremises
|
value.onPremisesDomainName | string |
Contiene il dominio localeFQDN, detto anche dnsDomainName sincronizzato dalla directory locale. |
|
Ora ultima sincronizzazione onPremises
|
value.onPremisesLastSyncDateTime | string |
Ora e data dell'ultima sincronizzazione del tenant con la directory locale. |
|
OnPremises NetBios Name
|
value.onPremisesNetBiosName | string |
Nome del servizio di rete per il server locale. |
|
OnPremises Nome account Sam
|
value.onPremisesSamAccountName | string |
Nome dell'account Sam per la directory locale. |
|
Identificatore di sicurezza OnPremises
|
value.onPremisesSecurityIdentifier | string |
Identificatore di sicurezza locale. |
|
Sincronizzazione OnPremises abilitata
|
value.onPremisesSyncEnabled | boolean |
True se la sincronizzazione locale è abilitata per il gruppo. |
|
Percorso dati preferito
|
value.preferredDataLocation | string |
Posizione dei dati preferita del gruppo. |
|
Lingua preferita
|
value.preferredLanguage | string |
Lingua preferita configurata in Microsoft Entra ID. |
|
proxyAddresses
|
value.proxyAddresses | array of string |
Indirizzi proxy del gruppo. |
|
Data rinnovata
|
value.renewedDateTime | string |
Data rinnovata del gruppo. |
|
resourceBehaviorOptions
|
value.resourceBehaviorOptions | array of |
Opzioni di comportamento delle risorse del gruppo. |
|
resourceProvisioningOptions
|
value.resourceProvisioningOptions | array of string |
Opzioni di provisioning delle risorse del gruppo. |
|
Sicurezza abilitata
|
value.securityEnabled | boolean |
Indica se il gruppo è abilitato per la sicurezza. |
|
Identificatore di sicurezza
|
value.securityIdentifier | string |
Identificatore di sicurezza del gruppo. |
|
Tema
|
value.theme | string |
Tema del gruppo Microsoft Entra ID. |
|
Visibilità
|
value.visibility | string |
Visibilità del gruppo. |
|
onPremisesProvisioningErrors
|
value.onPremisesProvisioningErrors | array of |
Errori di provisioning locali del gruppo. |
Ottenere gruppi di membri
Appartenenze a gruppi per un utente (membro)
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID oggetto del membro Microsoft Entra ID (user)
|
member-id | True | string |
ID oggetto del membro Microsoft Entra ID (user) |
|
Solo sicurezza abilitata (true/false)
|
securityEnabledOnly | True | boolean |
Recuperare solo i gruppi abilitati per la sicurezza? |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Contesto Odata
|
@odata.context | string |
Collegamento Odata.context. |
|
value
|
value | array of string |
value |
Ottenere i dettagli della licenza dei membri
Recuperare i dettagli della licenza dei membri del gruppo (utente)
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID oggetto del membro Microsoft Entra ID (user)
|
id | True | string |
ID oggetto del membro Microsoft Entra ID (user) |
|
Selezione di punti dati (colonne)
|
$select | string |
Selezione di punti dati (colonne) |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Contesto Odata
|
@odata.context | string |
Collegamento Odata.context. |
|
value
|
value | array of object |
value |
|
Documento d'identità
|
value.id | string |
id |
|
SKU ID
|
value.skuId | string |
ID dello SKU. |
|
Numero parte SKU
|
value.skuPartNumber | string |
Nome dello SKU |
|
servicePlans
|
value.servicePlans | array of object |
servicePlans |
|
servicePlanId
|
value.servicePlans.servicePlanId | string |
servicePlanId |
|
servicePlanName
|
value.servicePlans.servicePlanName | string |
servicePlanName |
|
provisioningStatus
|
value.servicePlans.provisioningStatus | string |
provisioningStatus |
|
si applicaA
|
value.servicePlans.appliesTo | string |
si applicaA |
Ottenere le proprietà del gruppo
Recuperare le proprietà e le relazioni di un gruppo microsoft Entra ID
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID oggetto del gruppo Microsoft Entra ID
|
group-id | True | string |
ID oggetto del gruppo Microsoft Entra ID |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Contesto Odata
|
@odata.context | string |
Collegamento Odata.context. |
|
Documento d'identità
|
id | string |
ID oggetto del gruppo |
|
Data/ora eliminata
|
deletedDateTime | string |
Data di eliminazione del gruppo |
|
Classification
|
classification | string |
classificazione |
|
Data creazione
|
createdDateTime | string |
Data di creazione del gruppo |
|
creationOptions
|
creationOptions | array of string |
Opzioni create del gruppo. |
|
Description
|
description | string |
descrizione |
|
Nome visualizzato
|
displayName | string |
Nome visualizzato del gruppo |
|
Data di scadenza
|
expirationDateTime | string |
Data di scadenza del gruppo |
|
groupTypes
|
groupTypes | array of string |
Tipi di gruppo per il gruppo. |
|
È assegnabile al ruolo
|
isAssignableToRole | string |
È possibile assegnare un ruolo a questo gruppo? |
|
Posta
|
string |
Posta elettronica del gruppo |
|
|
Posta abilitata
|
mailEnabled | boolean |
La posta elettronica di gruppo è abilitata? |
|
Mail Nick Name
|
mailNickname | string |
Nome dell'indirizzo di posta elettronica del gruppo |
|
Regola di appartenenza
|
membershipRule | string |
Regola utilizzata per la valutazione dell'appartenenza. |
|
Stato di elaborazione delle regole di appartenenza
|
membershipRuleProcessingState | string |
Stato di elaborazione della regola utilizzata per la valutazione dell'appartenenza. |
|
Nome di dominio OnPremises
|
onPremisesDomainName | string |
Contiene il dominio localeFQDN, detto anche dnsDomainName sincronizzato dalla directory locale. |
|
Ora ultima sincronizzazione onPremises
|
onPremisesLastSyncDateTime | string |
Ora e data dell'ultima sincronizzazione del tenant con la directory locale. |
|
OnPremises NetBios Name
|
onPremisesNetBiosName | string |
Nome del servizio di rete per il server locale. |
|
OnPremises Nome account Sam
|
onPremisesSamAccountName | string |
Nome dell'account Sam per la directory locale. |
|
Identificatore di sicurezza OnPremises
|
onPremisesSecurityIdentifier | string |
Identificatore di sicurezza locale. |
|
Sincronizzazione OnPremises abilitata
|
onPremisesSyncEnabled | boolean |
True se la sincronizzazione locale è abilitata per il gruppo. |
|
Percorso dati preferito
|
preferredDataLocation | string |
Posizione dei dati preferita del gruppo. |
|
Lingua preferita
|
preferredLanguage | string |
Lingua preferita configurata in Microsoft Entra ID. |
|
proxyAddresses
|
proxyAddresses | array of string |
Indirizzi proxy del gruppo. |
|
Data rinnovata
|
renewedDateTime | string |
Data rinnovata del gruppo. |
|
resourceBehaviorOptions
|
resourceBehaviorOptions | array of string |
Opzioni di comportamento delle risorse del gruppo. |
|
resourceProvisioningOptions
|
resourceProvisioningOptions | array of string |
Opzioni di provisioning delle risorse del gruppo. |
|
Sicurezza abilitata
|
securityEnabled | boolean |
Indica se il gruppo è abilitato per la sicurezza. |
|
Identificatore di sicurezza
|
securityIdentifier | string |
Identificatore di sicurezza del gruppo. |
|
Tema
|
theme | string |
Tema del gruppo Microsoft Entra ID. |
|
Visibilità
|
visibility | string |
Visibilità del gruppo. |
|
onPremisesProvisioningErrors
|
onPremisesProvisioningErrors | array of string |
Errori di provisioning locali del gruppo. |