Teammitglieder auflisten
Namespace: microsoft.graph
Die conversationMember-Sammlung eines Teams abrufen.
Die vom Server zurückgegebenen Mitgliedschafts-IDs müssen als nicht transparente Zeichenfolgen behandelt werden. Der Client sollte nicht versuchen, diese Ressourcen-IDs zu analysieren oder Annahmen zu treffen.
In Zukunft können die Mitgliedschaftsergebnisse Benutzer aus verschiedenen Mandanten enthalten, wie in der Antwort angegeben. Clients sollten davon ausgehen, dass alle Mitglieder ausschließlich zum aktuellen Mandanten gehören.
Hinweis
Diese API gibt einen Fehler 401 zurück, wenn ein neu erstellter Mandant diese Methode aufruft. Weitere Informationen finden Sie unter Bekannte Probleme.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Berechtigungen
Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
---|---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | TeamMember.Read.All | TeamMember.ReadWrite.All |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | TeamMember.Read.Group | TeamMember.ReadWrite.All, TeamMember.Read.All |
Hinweis
Die TeamMember.Read.Group-Berechtigung verwendet ressourcenspezifische Zustimmung.
HTTP-Anforderung
GET /teams/{team-id}/members
Optionale Abfrageparameter
Diese Methode unterstützt die $filter
OData-Abfrageparameter , $select
und $top
zum Anpassen der Antwort. Die Standard- und maximale Seitengröße beträgt 100 bzw. 999 Objekte.
Anforderungsheader
Name | Beschreibung |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Antwort
Im Erfolgsfall erzeugt diese Methode einen 200 OK
Antwortcode sowie eine Auflistung aller conversationMember-Objekte im Antworttext.
Beispiele
Beispiel 1: Abrufen der Liste der Mitglieder in einem Team
Anforderung
GET https://graph.microsoft.com/v1.0/teams/ee0f5ae2-8bc6-4ae5-8466-7daeebbfa062/members
Antwort
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#teams('ee0f5ae2-8bc6-4ae5-8466-7daeebbfa062')/members",
"@odata.count": 3,
"value": [
{
"@odata.type": "#microsoft.graph.aadUserConversationMember",
"id": "ZWUwZjVhZTItOGJjNi00YWU1LTg0NjYtN2RhZWViYmZhMDYyIyM3Mzc2MWYwNi0yYWM5LTQ2OWMtOWYxMC0yNzlhOGNjMjY3Zjk=",
"roles": [],
"displayName": "Adele Vance",
"userId": "73761f06-2ac9-469c-9f10-279a8cc267f9",
"email": "AdeleV@contoso.com"
},
{
"@odata.type": "#microsoft.graph.aadUserConversationMember",
"id": "ZWUwZjVhZTItOGJjNi00YWU1LTg0NjYtN2RhZWViYmZhMDYyIyM1OThlZmNkNC1lNTQ5LTQwMmEtOTYwMi0wYjUwMjAxZmFlYmU=",
"roles": [
"owner"
],
"displayName": "MOD Administrator",
"userId": "598efcd4-e549-402a-9602-0b50201faebe",
"email": "admin@contoso.com"
},
{
"@odata.type": "#microsoft.graph.aadUserConversationMember",
"id": "MmFiOWM3OTYtMjkwMi00NWY4LWI3MTItN2M1YTYzY2Y0MWM0IyM3NTJmNTBiNy0yNTZmLTQ1MzktYjc3NS1jNGQxMmYyZTQ3MjI=",
"roles": [],
"displayName": "Harry Johnson",
"userId": "752f50b7-256f-4539-b775-c4d12f2e4722",
"email": "harry@contoso.com"
}
]
}
Beispiel 2: Suchen von Mitgliedern eines Teams anhand ihrer Microsoft Entra Benutzerobjekt-ID
Das folgende Beispiel zeigt eine Anforderung zum Suchen der Mitgliedschaftsressourcen basierend auf id
dem Microsoft Entra Benutzer, der dem aadUserConversationMember zugeordnet ist.
Anforderung
GET https://graph.microsoft.com/v1.0/teams/ee0f5ae2-8bc6-4ae5-8466-7daeebbfa062/members?$filter=(microsoft.graph.aadUserConversationMember/userId eq '73761f06-2ac9-469c-9f10-279a8cc267f9')
Antwort
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#teams('ee0f5ae2-8bc6-4ae5-8466-7daeebbfa062')/members",
"@odata.count": 1,
"value": [
{
"@odata.type": "#microsoft.graph.aadUserConversationMember",
"id": "ZWUwZjVhZTItOGJjNi00YWU1LTg0NjYtN2RhZWViYmZhMDYyIyM3Mzc2MWYwNi0yYWM5LTQ2OWMtOWYxMC0yNzlhOGNjMjY3Zjk=",
"roles": [],
"displayName": "Adele Vance",
"userId": "73761f06-2ac9-469c-9f10-279a8cc267f9",
"email": "AdeleV@contoso.com"
}
]
}
Beispiel 3: Suchen von Teammitgliedern anhand ihrer Namen oder E-Mail-Adressen
Das folgende Beispiel zeigt eine Anforderung zur Suche nach den Mitgliedschaftsressourcen basierend auf displayName
oder email
des aadUserConversationMember.
Anforderung
GET https://graph.microsoft.com/v1.0/teams/ee0f5ae2-8bc6-4ae5-8466-7daeebbfa062/members?$filter=(microsoft.graph.aadUserConversationMember/displayName eq 'Harry Johnson' or microsoft.graph.aadUserConversationMember/email eq 'admin@contoso.com')
Antwort
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#teams('ee0f5ae2-8bc6-4ae5-8466-7daeebbfa062')/members",
"@odata.count": 2,
"value": [
{
"@odata.type": "#microsoft.graph.aadUserConversationMember",
"id": "ZWUwZjVhZTItOGJjNi00YWU1LTg0NjYtN2RhZWViYmZhMDYyIyM1OThlZmNkNC1lNTQ5LTQwMmEtOTYwMi0wYjUwMjAxZmFlYmU=",
"roles": [
"owner"
],
"displayName": "MOD Administrator",
"userId": "598efcd4-e549-402a-9602-0b50201faebe",
"email": "admin@contoso.com"
},
{
"@odata.type": "#microsoft.graph.aadUserConversationMember",
"id": "MmFiOWM3OTYtMjkwMi00NWY4LWI3MTItN2M1YTYzY2Y0MWM0IyM3NTJmNTBiNy0yNTZmLTQ1MzktYjc3NS1jNGQxMmYyZTQ3MjI=",
"roles": [],
"displayName": "Harry Johnson",
"userId": "752f50b7-256f-4539-b775-c4d12f2e4722",
"email": "harry@contoso.com"
}
]
}
Verwandte Inhalte
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für