Aktualisieren von profilePhoto

Namespace: microsoft.graph

Aktualisieren Sie das Foto für den angegebenen Kontakt, die Gruppe, das Team oder den Benutzer in einem Mandanten. Die Größe des Fotos, auf das Sie aktualisieren können, ist auf 4 MB beschränkt.

Für diesen Vorgang können Sie patch oder PUT verwenden.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

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

Berechtigungen

In den folgenden Tabellen sind die Berechtigungen mit den geringsten Berechtigungen aufgeführt, die zum Aufrufen dieser API für jeden unterstützten Ressourcentyp erforderlich sind. Befolgen Sie bewährte Methoden , um Berechtigungen mit den geringsten Berechtigungen anzufordern. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Um das Profilfoto eines Kontakts zu aktualisieren

Berechtigungstyp	Berechtigungen mit den geringsten Berechtigungen	Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto)	Contacts.ReadWrite	Nicht unterstützt
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt	Nicht unterstützt
Anwendung	Contacts.ReadWrite	Nicht unterstützt

Um das Profilfoto einer Gruppe zu aktualisieren

Berechtigungstyp	Berechtigungen mit den geringsten Berechtigungen	Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto)	ProfilePhoto.ReadWrite.All	Group.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt	Nicht unterstützt
Anwendung	ProfilePhoto.ReadWrite.All	Group.ReadWrite.All

So aktualisieren Sie die Profilfoto eines Teams

Berechtigungstyp	Berechtigungen mit den geringsten Berechtigungen	Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto)	TeamSettings.ReadWrite.All	Nicht unterstützt
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt	Nicht unterstützt
Anwendung	Nicht unterstützt	Nicht unterstützt

So aktualisieren Sie die Profilfoto eines Benutzers

Berechtigungstyp	Berechtigungen mit den geringsten Berechtigungen	Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto)	ProfilePhoto.ReadWrite.All	User.ReadWrite, User.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)	User.ReadWrite	Nicht unterstützt
Anwendung	ProfilePhoto.ReadWrite.All	User.ReadWrite.All

Hinweis

• Benutzer mit Administratorrollen wie Benutzeradministratoren können das Foto eines beliebigen Benutzers im organization mithilfe delegierter Berechtigungen aktualisieren. Dieser Vorgang wird auch mit Anwendungsberechtigungen unterstützt. Zum Aktualisieren des Fotos eines Benutzers im organization ist die Berechtigung ProfilePhoto.ReadWrite.All oder User.ReadWrite.All erforderlich. Zum Aktualisieren des Fotos des angemeldeten Benutzers ist nur die Berechtigung User.ReadWrite erforderlich.
• Das Aktualisieren des Fotos eines Benutzers mithilfe des Microsoft Graph-API wird derzeit in Azure AD B2C-Mandanten nicht unterstützt.

HTTP-Anforderung

So aktualisieren Sie die Profilfoto eines Kontakts:

PATCH /me/contacts/{id}/photo/$value
PATCH /users/{id | userPrincipalName}/contacts/{id}/photo/$value
PATCH /me/contactfolders/{contactFolderId}/contacts/{id}/photo/$value
PATCH /users/{id | userPrincipalName}/contactfolders/{contactFolderId}/contacts/{id}/photo/$value

PUT /me/contacts/{id}/photo/$value
PUT /users/{id | userPrincipalName}/contacts/{id}/photo/$value
PUT /me/contactfolders/{contactFolderId}/contacts/{id}/photo/$value
PUT /users/{id | userPrincipalName}/contactfolders/{contactFolderId}/contacts/{id}/photo/$value

So aktualisieren Sie ein Gruppenfoto:

PATCH /groups/{id}/photo/$value

PUT /groups/{id}/photo/$value

So aktualisieren Sie ein Teamfoto:

PUT /teams/{id}/photo/$value

So aktualisieren Sie die Profilfoto eines Benutzers:

PATCH /me/photo/$value
PATCH /users/{id | userPrincipalName}/photo/$value

PUT /me/photo/$value
PUT /users/{id | userPrincipalName}/photo/$value

Anforderungsheader

Kopfzeile	Wert
Authorization	Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.
Content-Type	image/jpeg. Erforderlich.

Anforderungstext

Fügen Sie die Binärdaten des Fotos in den Anforderungstext ein.

Antwort

Bei erfolgreicher Ausführung gibt die Methode einen 200 OK Antwortcode oder einen 204 No Content Antwortcode zum Aktualisieren des Fotos eines Teams zurück.

Beispiele

Beispiel 1: Aktualisieren des Fotos eines Benutzers

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

HTTP

PUT https://graph.microsoft.com/v1.0/me/photo/$value
Content-type: image/jpeg

Binary data for the image

CLI

mgc users photo content put --user-id {user-id}

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const stream = Binary data for the image;

await client.api('/me/photo/$value')
	.put(stream);

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

PowerShell

Import-Module Microsoft.Graph.Users

$params = Binary data for the image

# A UPN can also be used as -UserId.
Set-MgUserPhotoContent -UserId $userId -BodyParameter $params

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 200 OK

Beispiel 2: Aktualisieren des Fotos eines Teams

Anforderung

Das folgende Beispiel zeigt eine Anforderung zum Aktualisieren eines Teamfotos.

HTTP

PUT https://graph.microsoft.com/v1.0/teams/172b0cce-e65d-44ce-9a49-91d9f2e8491e/photo/$value
Content-type: image/jpeg

Binary data for the image

CLI

mgc teams photo content put --team-id {team-id}

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const stream = Binary data for the image;

await client.api('/teams/172b0cce-e65d-44ce-9a49-91d9f2e8491e/photo/$value')
	.put(stream);

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

PowerShell

Import-Module Microsoft.Graph.Teams

$params = Binary data for the image

Set-MgTeamPhotoContent -TeamId $teamId -BodyParameter $params

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 204 No Content