Ajouter ou supprimer des attributs personnalisés sur une carte de profil à l’aide de l’API de carte de profil
La carte de profil dans Microsoft 365 affiche des informations sur un utilisateur d’une organisation. Les informations affichées sur la carte de profil sont stockées et gérées par l’organisation, par exemple, poste ou emplacement du bureau.
Les organisations peuvent utiliser la ressource profileCardProperty pour afficher d’autres propriétés de l’ID Microsoft Entra sur la carte de profil d’un utilisateur d’une organisation en :
- Rendre plus d’attributs visibles
- Ajout d’attributs personnalisés
D’autres propriétés s’affichent dans la section Contact de la carte de profil dans Microsoft 365.
Vous pouvez également supprimer des attributs personnalisés des cartes de profil de l’organisation.
Remarque
Les propriétés de la carte de profil correspondent aux attributs de l’ID Microsoft Entra. L’ajout d’un attribut en tant que profileCardProperty à la collection profileCardProperties pour une organisation configure les cartes de profil pour afficher la valeur de l’attribut. La suppression du profileCardProperty de la collection ne supprime pas l’attribut de l’ID Microsoft Entra ; il supprime la configuration afin que les cartes de profil n’affichent plus la valeur d’attribut.
Remarque
Les personnalisations des propriétés de carte de profil décrites dans cet article ne s’appliquent pas aux applications Win32 telles que les clients de bureau Outlook et Office. Pour savoir comment personnaliser les propriétés de carte de profil dans les applications Win32 pour votre organisation, consultez Personnaliser la carte de profil dans les applications Win32 à l’aide de clés de Registre.
Les API de propriétés de carte de profil sont disponibles dans les déploiements de cloud national suivants.
Service global | Gouvernement des États-Unis L4 | Us Government L5 (DOD) | Chine gérée par 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Notes
Les opérations sur la ressource profileCardProperty qui utilisent des autorisations déléguées nécessitent que l’utilisateur connecté ait un rôle Administrateur client ou Administrateur général.
Rendre d’autres attributs visibles sur la carte de profil
Vous pouvez rendre les attributs suivants de l’ID Microsoft Entra visibles sur les cartes de profil des utilisateurs. Ces attributs ne respectent pas la casse :
UserPrincipalName
Fax
StreetAddress
PostalCode
StateOrProvince
Alias
Le tableau suivant montre comment les attributs d’ID Microsoft Entra correspondent aux propriétés de l’entité utilisateur Microsoft Graph.
Attribut d’ID Microsoft Entra | Propriété de l’entité utilisateur |
---|---|
UserPrincipalName | userPrincipalName |
Fax | faxNumber |
StreetAddress | streetAddress |
PostalCode | postalCode |
StateOrProvince | état |
Alias | mailNickname |
Vous pouvez ajouter l’un de ces attributs à la carte de profil en configurant vos paramètres d’administration de personnes et en ajoutant l’attribut en tant que propriété directoryPropertyName d’un profileCardProperty dans Microsoft Graph. Lorsque vous rendez ces attributs visibles, vous devez utiliser les noms de propriété pour en-us
. Vous n’êtes pas obligé d’ajouter des valeurs localisées. Ces propriétés sont automatiquement affichées dans les paramètres de langue que l’utilisateur spécifie pour Microsoft 365.
Note: Les valeurs de propriété d’entité utilisateur contiennent des informations utilisateur stockées et gérées par l’organisation.
Importante
Lors de l’ajout d’un attribut à une carte de profil, l’affichage de l’ajout prend jusqu’à 24 heures.
Configurer les propriétés de la carte de profil à l’aide de l’API REST Microsoft Graph
Exemple
L’exemple suivant affiche l’attribut Alias
sur la carte de visite :
POST https://graph.microsoft.com/v1.0/admin/people/profileCardProperties
Content-Type: application/json
{
"directoryPropertyName": "Alias"
}
Note: Le
/organization/{organizationId}/settings
chemin d’accès est déconseillé dans l’expérience bêta. À l’avenir, utilisez le chemin d’accès/admin/people
.
Si elle réussit, la réponse renvoie un code de réponse 201 OK
et un objet profileCardProperty dans le corps de la réponse. La valeur de l’attribut Alias
s’affiche sur la carte de profil d’un utilisateur.
HTTP/1.1 201 OK
Content-type: application/json
{
"directoryPropertyName": "Alias",
"annotations": []
}
Ajouter un attribut personnalisé à la carte de profil
Vous pouvez ajouter l’un des 15 attributs d’extension personnalisée d’ID Microsoft Entra aux cartes de profil des utilisateurs en configurant les paramètres de votre organisation et en ajoutant la valeur correspondante en tant que profileCardProperty dans Microsoft Graph. Vous pouvez ajouter une ressource profileCardProperty à la fois.
L’affichage des modifications sur les cartes de profil prend jusqu’à 24 heures.
Les propriétés personnalisées ne peuvent pas faire l’objet d’une recherche et ne peuvent pas être utilisées pour rechercher des personnes dans les applications et services Microsoft.
Le tableau suivant montre comment les noms d’attributs d’extension personnalisés d’ID Microsoft Entra correspondent aux valeurs prises en charge pour la propriété directoryPropertyName de la ressource profileCardProperty . Ces noms d’attributs d’extension personnalisés d’ID Microsoft Entra ne respectent pas la casse :
Attribut d’extension personnalisée d’ID Microsoft Entra | Valeur à spécifier comme directoryPropertyName |
---|---|
extensionAttribute1 | CustomAttribute1 |
extensionAttribute2 | CustomAttribute2 |
extensionAttribute3 | CustomAttribute3 |
extensionAttribute4 | CustomAttribute4 |
extensionAttribute5 | CustomAttribute5 |
extensionAttribute6 | CustomAttribute6 |
extensionAttribute7 | CustomAttribute7 |
extensionAttribute8 | CustomAttribute8 |
extensionAttribute9 | CustomAttribute9 |
extensionAttribute10 | CustomAttribute10 |
extensionAttribute12 | CustomAttribute12 |
extensionAttribute11 | CustomAttribute11 |
extensionAttribute13 | CustomAttribute13 |
extensionAttribute14 | CustomAttribute14 |
extensionAttribute15 | CustomAttribute15 |
Importante
Des attributs de carte de profil personnalisés sont ajoutés pour tous les utilisateurs de l’organisation, ce qui nécessite des précautions nécessaires pour empêcher l’exposition accidentelle de données sensibles.
Exemple
L’exemple suivant ajoute le premier attribut d’extension personnalisée d’ID Microsoft Entra à la carte de profil, en utilisant le nom complet Centre de coûts. Pour les utilisateurs qui définissent leurs paramètres linguistiques sur l’allemand, le nom d’affichage est Kostenstelle.
Demande
POST https://graph.microsoft.com/v1.0/admin/people/profileCardProperties
Content-Type: application/json
{
"directoryPropertyName": "CustomAttribute1",
"annotations": [
{
"displayName": "Cost center",
"localizations": [
{
"languageTag": "de",
"displayName": "Kostenstelle"
}
]
}
]
}
Note: Le
/organization/{organizationId}/settings
chemin d’accès est déconseillé dans l’expérience bêta. À l’avenir, utilisez le chemin d’accès/admin/people
.
Si une langue n’est pas prise en charge, le nom de la propriété est affiché avec la valeur par défaut.
Si elle réussit, la réponse renvoie un code de réponse 201 OK
et un objet profileCardProperty dans le corps de la réponse. Dans cet exemple, vous pouvez supposer que la carte de profil affiche Kostenstelle pour tous les utilisateurs qui définissent leurs paramètres linguistiques sur l’allemand sur la carte de profil. Pour tous les autres utilisateurs, le Centre de coûts s’affiche sur la carte de profil.
Réponse
HTTP/1.1 201 OK
Content-type: application/json
{
"directoryPropertyName": "CustomAttribute1",
"annotations": [
{
"displayName": "Cost center",
"localizations": [
{
"languageTag": "de",
"displayName": "Kostenstelle"
}
]
}
]
}
Supprimer un attribut personnalisé de la carte de profil
En suivant le même mappage entre les attributs d’extension personnalisés de l’ID Microsoft Entra et les attributs personnalisés de carte de profil (tels que CustomAttribute1
) que celui décrit dans la section précédente Ajout d’un attribut personnalisé, vous pouvez supprimer un attribut personnalisé à l’aide de l’opération de suppression , comme illustré dans l’exemple suivant.
Exemple
L’exemple suivant supprime l’attribut CustomAttribute5
personnalisé des paramètres de l’organisation. Si elle réussit, cette méthode renvoie un code de réponse 204 No Content
.
Demande
DELETE https://graph.microsoft.com/v1.0/admin/people/profileCardProperties/CustomAttribute5
Note: Le
/organization/{organizationId}/settings
chemin d’accès est déconseillé dans l’expérience bêta. À l’avenir, utilisez le chemin d’accès/admin/people
.
Réponse
HTTP/1.1 204 No Content
Configurer les propriétés de la carte de profil à l’aide de PowerShell
Vous pouvez utiliser le Kit de développement logiciel (SDK) Microsoft Graph PowerShell pour configurer les propriétés de carte de profil dans votre organisation.
Configuration requise
- Module PowerShell : installez le module version 1.24.0 ou ultérieure.
- .NET Framework : installez .NET Framework 4.7.2 ou une version ultérieure.
Confirmer vos paramètres actuels
Pour obtenir la configuration des propriétés de carte de profil pour une organisation, utilisez la commande suivante.
Get-MgAdminPeopleProfileCardProperty
Pour obtenir une configuration de propriété de carte de profil spécifique dans une organisation, utilisez la commande suivante.
Get-MgAdminPeopleProfileCardProperty -ProfileCardPropertyId $profileCardPropertyId
Notes
Les commandes get nécessitent l’autorisation PeopleSettings.Read.All
. Pour créer une session Microsoft Graph avec une étendue requise spécifique, utilisez la commande et l’autorisation suivantes pour demander des autorisations.
Connect-MgGraph -Scopes "PeopleSettings.Read.All"
Ajouter des propriétés de carte de profil dans votre organisation
Vous pouvez utiliser le module Microsoft Graph PowerShell pour rendre à la fois les attributs d’ID Microsoft Entra et les 15 attributs d’extension d’ID Microsoft Entra personnalisables, disponibles dans votre organisation.
Remarque
La nouvelle commande nécessite l’autorisation PeopleSettings.ReadWrite.All
. Pour créer une session Microsoft Graph avec une étendue requise spécifique, utilisez la commande et l’autorisation suivantes pour demander des autorisations.
Connect-MgGraph -Scopes "PeopleSettings.ReadWrite.All","PeopleSettings.Read.All"
Utilisez la commande suivante.
$params = @{
directoryPropertyName = "CustomAttribute1"
annotations = @(
@{
displayName = "Cost Center"
localizations = @(
@{
languageTag = "ru"
displayName = "центр затрат"
}
)
}
)
}
New-MgAdminPeopleProfileCardProperty -BodyParameter $params
Mettre à jour les propriétés de la carte de profil dans votre organisation
Vous pouvez utiliser le module Microsoft Graph PowerShell pour mettre à jour les propriétés de carte de profil disponibles dans votre organisation.
Remarque
La commande update nécessite l’autorisation PeopleSettings.ReadWrite.All
. Pour créer une session Microsoft Graph avec une étendue requise spécifique, utilisez la commande et l’autorisation suivantes pour demander des autorisations.
Connect-MgGraph -Scopes "PeopleSettings.ReadWrite.All","PeopleSettings.Read.All"
Utilisez la commande suivante, où vous remplacez par $profileCardPropertyId
l’ID de la propriété à mettre à jour.
$params = @{
annotations = @(
@{
displayName = "Cost Center"
localizations = @(
@{
languageTag = "no"
displayName = "Kostnads Senter"
}
)
}
)
}
Update-MgAdminPeopleProfileCardProperty -ProfileCardPropertyId $profileCardPropertyId -BodyParameter $params
Supprimer les propriétés de carte de profil dans votre organisation
Vous pouvez utiliser le module Microsoft Graph PowerShell pour supprimer les propriétés de carte de profil de votre organisation.
Remarque
La commande remove nécessite l’autorisation PeopleSettings.ReadWrite.All
. Pour créer une session Microsoft Graph avec une étendue requise spécifique, utilisez la commande et l’autorisation suivantes pour demander des autorisations.
Connect-MgGraph -Scopes "PeopleSettings.ReadWrite.All","PeopleSettings.Read.All"
Utilisez la commande suivante, où vous remplacez par $profileCardPropertyId
l’ID de la propriété à supprimer.
Remove-MgAdminPeopleProfileCardProperty -ProfileCardPropertyId $profileCardPropertyId