Aktualisieren von profilePhoto

Artikel
02/12/2024

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

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

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)	Group.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 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)	User.ReadWrite	User.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt	Nicht unterstützt
Anwendung	User.ReadWrite.All	Nicht unterstützt

Hinweis

Eine App mit nur Anwendungsberechtigungen kann das Foto einer Gruppe nicht aktualisieren.
Mit * gekennzeichnete Berechtigungen werden nur aus Gründen der Abwärtskompatibilität unterstützt. Aktualisieren Sie Ihre Lösungen, um eine alternative Berechtigung zu verwenden, und vermeiden Sie die Verwendung dieser Berechtigungen in Zukunft.
Globaler Administrator und Benutzeradministrator können das Foto jedes Benutzers im organization mithilfe delegierter Berechtigungen aktualisieren. Dieser Vorgang wird auch mit Anwendungsberechtigungen unterstützt. Das Aktualisieren des Fotos eines Benutzers im organization erfordert die Berechtigung User.ReadWrite.All. 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:

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

So aktualisieren Sie ein Teamfoto:

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

So aktualisieren Sie die Profilfoto eines Benutzers:

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	z.B. 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 der Profilfoto eines Benutzers

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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

Binary data for the image


// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc-beta users photo content put --user-id {user-id}

Wichtig

Die Microsoft Graph SDKs verwenden standardmäßig die Version v1.0 der API und unterstützen nicht alle Typen, Eigenschaften und APIs, die in der Beta-Version verfügbar sind. Einzelheiten zum Zugriff auf die Beta-API mit dem SDK finden Sie unter Verwenden der Microsoft Graph SDKs mit der Beta-API.

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


const options = {
	authProvider,
};

const client = Client.init(options);

const stream = Binary data for the image;

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

Wichtig

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


Import-Module Microsoft.Graph.Beta.Users

$params = Binary data for the image

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

Wichtig

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.

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

Binary data for the image


// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc-beta teams photo content put --team-id {team-id}

Wichtig

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


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')
	.version('beta')
	.put(stream);

Wichtig

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


Import-Module Microsoft.Graph.Beta.Teams

$params = Binary data for the image

Set-MgBetaTeamPhotoContent -TeamId $teamId -BodyParameter $params

Wichtig

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

Aktualisieren von profilePhoto

Berechtigungen

Um das Profilfoto eines Kontakts zu aktualisieren

Um das Profilfoto einer Gruppe zu aktualisieren

So aktualisieren Sie die Profilfoto eines Teams

So aktualisieren Sie die Profilfoto eines Benutzers

HTTP-Anforderung

Anforderungsheader

Anforderungstext

Antwort

Beispiele

Beispiel 1: Aktualisieren der Profilfoto eines Benutzers

Anforderung

Antwort

Beispiel 2: Aktualisieren des Fotos eines Teams

Anforderung

Antwort

Feedback

Feedback

Zusätzliche Ressourcen