Freigeben über

Hinzufügen oder Entfernen von benutzerdefinierten Attributen für ein Profil Karte mithilfe der Profil-Karte-API

  • Artikel

Das Profil Karte in Microsoft 365 zeigt Informationen zu einem Benutzer in einem organization an. Die auf dem Profil Karte angezeigten Informationen werden vom organization gespeichert und verwaltet, z. B. Position oder Bürostandort.

Organisationen können die profileCardProperty-Ressource verwenden, um weitere Eigenschaften aus Microsoft Entra ID für das Profil anzuzeigen, das für einen Benutzer in einem organization Karte:

  • Mehr Attribute sichtbar machen
  • Benutzerdefinierte Attribute hinzufügen

Weitere Eigenschaften werden im Abschnitt Kontakt des Profils Karte in Microsoft 365 angezeigt.

Sie können auch benutzerdefinierte Attribute aus Profilkarten des organization entfernen.

Hinweis

Profileigenschaften Karte entsprechen Attributen in Microsoft Entra ID. Durch das Hinzufügen eines Attributs als profileCardProperty zur profileCardProperties-Auflistung für eine organization werden Profilkarten so konfiguriert, dass der Attributwert angezeigt wird. Durch das Löschen von profileCardProperty aus der Auflistung wird das Attribut nicht aus Microsoft Entra ID gelöscht. Die Konfiguration wird gelöscht, sodass der Attributwert auf Profilkarten nicht mehr angezeigt wird.

Hinweis

Die in diesem Artikel beschriebenen Anpassungen Karte Eigenschaften gelten nicht für Win32-Anwendungen wie Outlook- und Office-Desktopclients. Informationen zum Anpassen von Profil- Karte Eigenschaften in Win32-Anwendungen für Ihre organization finden Sie unter Anpassen des Profils Karte in Win32-Apps mithilfe von Registrierungsschlüsseln.

Profil- Karte Eigenschaften-APIs sind in den folgenden nationalen Cloudbereitstellungen verfügbar.

Globaler Dienst US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet
✅ ✅ ✅ ✅

Hinweis

Vorgänge für die ressource profileCardProperty , die delegierte Berechtigungen verwenden, erfordern, dass der angemeldete Benutzer über die Rolle Mandantenadministrator verfügt.

Andere Attribute im Profil sichtbar machen Karte

Sie können die folgenden Attribute aus Microsoft Entra ID auf den Profilkarten der Benutzer sichtbar machen. Bei diesen Attributen wird die Groß-/Kleinschreibung nicht beachtet:

  • UserPrincipalName
  • Fax
  • StreetAddress
  • PostalCode
  • StateOrProvince
  • Alias

Die folgende Tabelle zeigt, wie die Microsoft Entra ID Attribute mit Eigenschaften der Microsoft Graph-Benutzerentität übereinstimmen.

Microsoft Entra ID-Attribut Entitätsigenschaft "Benutzer"
UserPrincipalName userPrincipalName
Fax faxNumber
StreetAddress streetAddress
PostalCode postalCode
StateOrProvince Status
Alias mailNickname

Sie können jedes dieser Attribute dem Profil Karte hinzufügen, indem Sie die Administratoreinstellungen Ihrer Personen konfigurieren und das Attribut als directoryPropertyName-Eigenschaft einer profileCardProperty-Eigenschaft in Microsoft Graph hinzufügen. Wenn Sie diese Attribute sichtbar machen, müssen Sie die Eigenschaftennamen für en-usverwenden. Sie müssen keine lokalisierten Werte hinzufügen. Diese Eigenschaften werden automatisch in den Spracheinstellungen angezeigt, die der Benutzer für Microsoft 365 angibt.

Anmerkung: Eigenschaftswerte der Benutzerentität enthalten Benutzerinformationen, die vom organization gespeichert und verwaltet werden.

Wichtig

Beim Hinzufügen eines Attributs zu einem Profil Karte dauert es bis zu 24 Stunden, bis die Hinzufügung angezeigt wird.

Konfigurieren von Profil- Karte Eigenschaften mithilfe der Microsoft Graph-REST-API

Beispiel

Im folgenden Beispiel wird das Attribut Alias auf der Profilkarte angezeigt.

POST https://graph.microsoft.com/v1.0/admin/people/profileCardProperties
Content-Type: application/json

{
  "directoryPropertyName": "Alias"
}

Anmerkung: Der /organization/{organizationId}/settings Pfad ist in der Betaumgebung veraltet. Verwenden Sie in Zukunft den /admin/people-Pfad.

Bei Erfolg gibt die Antwort einen Antwortcode 201 OK und ein Objekt profileCardProperty im Textkörper der Antwort zurück. Der Wert für das Alias Attribut wird im Profil eines Benutzers Karte angezeigt.

HTTP/1.1 201 OK
Content-type: application/json

{
  "directoryPropertyName": "Alias",
  "annotations": []
}

Hinzufügen eines benutzerdefinierten Attributs zum Profil Karte

Sie können jedes der 15 Microsoft Entra ID benutzerdefinierten Erweiterungsattribute den Profilkarten der Benutzer hinzufügen, indem Sie Ihre organization Einstellungen konfigurieren und den entsprechenden Wert als profileCardProperty in Microsoft Graph hinzufügen. Sie können jeweils eine Ressource profileCardProperty hinzufügen.

Es dauert bis zu 24 Stunden, bis die Änderungen auf den Profilkarten erscheinen.

Benutzerdefinierte Eigenschaften sind nicht durchsuchbar und können nicht für die Suche nach Personen in Microsoft-Apps und -Diensten verwendet werden.

Die folgende Tabelle zeigt, wie die Microsoft Entra ID benutzerdefinierten Erweiterungsattributnamen den unterstützten Werten für die directoryPropertyName-Eigenschaft der profileCardProperty-Ressource entsprechen. Bei diesen Microsoft Entra ID benutzerdefinierten Erweiterungsattributnamen wird die Groß-/Kleinschreibung nicht beachtet:

Microsoft Entra ID benutzerdefiniertes Erweiterungsattribut Wert, der als „directoryPropertyName“ anzugeben ist
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

Wichtig

Benutzerdefinierte Profil- Karte Attribute werden für alle Benutzer im organization hinzugefügt, sodass erforderliche Vorsichtsmaßnahmen erforderlich sind, um die versehentliche Offenlegung vertraulicher Daten zu verhindern.

Beispiel

Im folgenden Beispiel wird das erste Microsoft Entra ID benutzerdefinierte Erweiterungsattribut dem Profil Karte unter Verwendung des Anzeigenamens Kostenstelle hinzugefügt. Für Benutzer, die ihre Spracheinstellungen auf Deutsch festlegen, lautet der Anzeigename Kostenstelle.

Anforderung

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"
        }
      ]
    }
  ]
}

Anmerkung: Der /organization/{organizationId}/settings Pfad ist in der Betaumgebung veraltet. Verwenden Sie in Zukunft den /admin/people-Pfad.

Wenn eine Sprache nicht unterstützt wird, wird der Eigenschaftenname mit dem Standardwert angezeigt.

Bei Erfolg gibt die Antwort einen Antwortcode 201 OK und ein Objekt profileCardProperty im Textkörper der Antwort zurück. In diesem Beispiel können Sie davon ausgehen, dass im Profil Karte Kostenstelle für alle Benutzer angezeigt wird, die ihre Spracheinstellungen im Profil Karte auf Deutsch festgelegt haben. Für alle anderen Benutzer wird die Kostenstelle im Profil Karte angezeigt.

Antwort

HTTP/1.1 201 OK
Content-type: application/json

{
  "directoryPropertyName": "CustomAttribute1",
  "annotations": [
    {
      "displayName": "Cost center",
      "localizations": [
        {
          "languageTag": "de",
          "displayName": "Kostenstelle"
        }
      ]
    }
  ]
}

Entfernen eines benutzerdefinierten Attributs aus dem Profil Karte

Nach der gleichen Zuordnung zwischen Microsoft Entra ID benutzerdefinierten Erweiterungsattributen und dem Profil Karte benutzerdefinierten Attributen (zCustomAttribute1. B. ) wie im vorherigen Abschnitt Hinzufügen eines benutzerdefinierten Attributs beschrieben, können Sie ein benutzerdefiniertes Attribut mithilfe des Löschvorgangs entfernen, wie im folgenden Beispiel gezeigt.

Beispiel

Im folgenden Beispiel wird das benutzerdefinierte Attribut CustomAttribute5 aus den organization Einstellungen entfernt. Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No Content zurückgegeben.

Anforderung

DELETE https://graph.microsoft.com/v1.0/admin/people/profileCardProperties/CustomAttribute5

Anmerkung: Der /organization/{organizationId}/settings Pfad ist in der Betaumgebung veraltet. Verwenden Sie in Zukunft den /admin/people-Pfad.

Antwort

HTTP/1.1 204 No Content

Konfigurieren von Profil- Karte Eigenschaften mithilfe von PowerShell

Sie können das Microsoft Graph PowerShell SDK verwenden, um Profileigenschaften Karte in Ihrem organization zu konfigurieren.

Voraussetzungen

Bestätigen Der aktuellen Einstellungen

Verwenden Sie den folgenden Befehl, um die Profil- Karte Eigenschaftenkonfiguration für eine organization abzurufen.

   Get-MgAdminPeopleProfileCardProperty

Verwenden Sie den folgenden Befehl, um ein bestimmtes Profil Karte Eigenschaftenkonfiguration in einem organization abzurufen.

   Get-MgAdminPeopleProfileCardProperty -ProfileCardPropertyId $profileCardPropertyId

Hinweis

Die Get-Befehle erfordern die PeopleSettings.Read.All -Berechtigung. Um eine Microsoft Graph-Sitzung mit einem bestimmten erforderlichen Umfang zu erstellen, verwenden Sie den folgenden Befehl und stimmen den angeforderten Berechtigungen zu.

   Connect-MgGraph -Scopes "PeopleSettings.Read.All"

Hinzufügen von Profil- Karte Eigenschaften in Ihrem organization

Sie können das Microsoft Graph PowerShell-Modul verwenden, um sowohl Microsoft Entra ID Attribute als auch die 15 anpassbaren Microsoft Entra ID-Erweiterungsattribute in Ihrem organization verfügbar zu machen.

Hinweis

Der neue Befehl erfordert die PeopleSettings.ReadWrite.All -Berechtigung. Um eine Microsoft Graph-Sitzung mit einem bestimmten erforderlichen Umfang zu erstellen, verwenden Sie den folgenden Befehl und stimmen den angeforderten Berechtigungen zu.

   Connect-MgGraph -Scopes "PeopleSettings.ReadWrite.All","PeopleSettings.Read.All"

Verwenden Sie den folgenden Befehl.

$params = @{
	directoryPropertyName = "CustomAttribute1"
	annotations = @(
		@{
			displayName = "Cost Center"
			localizations = @(
				@{
					languageTag = "ru"
					displayName = "центр затрат"
				}
			)
		}
	)
}

New-MgAdminPeopleProfileCardProperty -BodyParameter $params

Aktualisieren von Profil- Karte Eigenschaften in Ihrem organization

Sie können das Microsoft Graph PowerShell-Modul verwenden, um Das Profil Karte Eigenschaften zu aktualisieren, die in Ihrem organization verfügbar sind.

Hinweis

Für den Befehl update ist die PeopleSettings.ReadWrite.All -Berechtigung erforderlich. Um eine Microsoft Graph-Sitzung mit einem bestimmten erforderlichen Umfang zu erstellen, verwenden Sie den folgenden Befehl und stimmen den angeforderten Berechtigungen zu.

   Connect-MgGraph -Scopes "PeopleSettings.ReadWrite.All","PeopleSettings.Read.All"

Verwenden Sie den folgenden Befehl, wobei Sie durch die ID der zu aktualisierenden Eigenschaft ersetzen $profileCardPropertyId .

$params = @{
	annotations = @(
		@{
      displayName = "Cost Center"
			localizations = @(
				@{
					languageTag = "no"
					displayName = "Kostnads Senter"
				}
			)
		}
	)
}

Update-MgAdminPeopleProfileCardProperty -ProfileCardPropertyId $profileCardPropertyId -BodyParameter $params

Entfernen von Profil- Karte Eigenschaften in Ihrem organization

Sie können das Microsoft Graph PowerShell-Modul verwenden, um Profileigenschaften Karte aus Ihrem organization zu entfernen.

Hinweis

Der Befehl remove erfordert die PeopleSettings.ReadWrite.All -Berechtigung. Um eine Microsoft Graph-Sitzung mit einem bestimmten erforderlichen Umfang zu erstellen, verwenden Sie den folgenden Befehl und stimmen den angeforderten Berechtigungen zu.

   Connect-MgGraph -Scopes "PeopleSettings.ReadWrite.All","PeopleSettings.Read.All"

Verwenden Sie den folgenden Befehl, wobei Sie durch die ID der zu entfernenden Eigenschaft ersetzen $profileCardPropertyId .

 Remove-MgAdminPeopleProfileCardProperty -ProfileCardPropertyId $profileCardPropertyId

Verwandte Inhalte