Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Namespace: microsoft.graph.externalConnectors
Stellt einen komplexen Datentyp dar, der verwendet wird, um personenbezogene Eigenschaften zu Elementen hinzuzufügen, die von einer externalConnection indiziert wurden. Sie können auch den principalCollection-Datentyp verwenden, wenn eine Liste von Personen vorhanden ist.
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| externalName | Zeichenfolge | Der Name, der der Person in der externen Datenquelle zugeordnet ist. |
| externalId | Zeichenfolge | Die ID, die der Person in der externen Datenquelle zugeordnet ist. Es kann auch eine E-Mail sein, die der Person in der externen Quelle zugeordnet ist. |
| entraDisplayName | Zeichenfolge | Der Name der Person, wie auf Microsoft Entra erwähnt. |
| entraId | Zeichenfolge | Die ID der Person, wie auf Microsoft Entra angegeben. |
| String | Die E-Mail-Adresse der Person, wie auf Microsoft Entra erwähnt. | |
| Upn | Zeichenfolge | Der Benutzerprinzipalname (User Principal Name, UPN) der Person, wie auf Azure Active Directory oder Microsoft Entra angegeben. |
| tenantId | Zeichenfolge | Die ID des Mandanten, zu dem die Person gehört. Mandanten-ID ist eine eindeutige GUID, die den Azure Active Directory-Mandanten (Entra ID) Ihres organization identifiziert. |
Beziehungen
Keine.
JSON-Darstellung
Sie können die Datentypen principal oder principalCollection verwenden.
| Datentyp | Beschreibung |
|---|---|
| Prinzipal | Verwenden Sie diesen Datentyp, wenn die Eigenschaft Informationen zu einer Person enthält. Beispiel: Weisen Sie die Eigenschaft "Zuweisen" für ein JIRA-Ticket zu, bei dem nur ein Zugewiesener vorhanden ist. |
| Principalcollection | Verwenden Sie diesen Datentyp, wenn die Eigenschaft auf eine Liste von Personen verweist. Beispiel: Eigenschaft "Contributors" für einen GitHub-PR, bei dem mehrere Personen vorhanden sein können. |
Die Verwendung von principal- oder principalCollection-Typeigenschaften anstelle einer Zeichenfolgen- oder Zeichenfolgenauflistung für personenbezogene Eigenschaften während der Erfassung von ExternalItems kann bessere und relevantere Ergebnisse in Copilot Search oder Chat liefern.
Die folgende JSON-Darstellung zeigt den Ressourcentyp für den Prinzipaldatentyp.
{
"externalName": "String",
"externalId": "String",
"entraDisplayName": "String",
"entraId": "String",
"email": "String",
"upn": "String",
"tenantId": "String"
}
Die folgende JSON-Darstellung zeigt den Ressourcentyp für den Prinzipalsammlungsdatentyp.
{
"principals": [
{
"externalName": "String",
"externalId": "String",
"entraDisplayName": "String",
"entraId": "String",
"email": "String",
"upn": "String",
"tenantId": "String"
}
]
}