Set-UserPhoto

 

S’applique à :Exchange Online, Exchange Server 2016

Dernière rubrique modifiée :2017-03-24

Cette cmdlet est disponible dans Exchange Server 2016 sur site et dans le service en nuage. Certains paramètres peuvent être propres à un environnement ou à un autre.

Utilisez la cmdlet Set-UserPhoto pour configurer les paramètres des fonctions photographiques qui permettent à l’utilisateur d’associer une photographie à son compte. Les photos des utilisateurs s’affichent dans les applications clientes locales et en nuage, telles que Outlook sur le web, Lync, Skype Entreprise et SharePoint.

Pour plus d'informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir SyntaxeSyntaxe de cmdlet Exchange.

Set-UserPhoto -Identity <MailboxIdParameter> -PictureData <Byte[]> <COMMON PARAMETERS>

Set-UserPhoto -Identity <MailboxIdParameter> -PictureStream <Stream> <COMMON PARAMETERS>

Set-UserPhoto -Identity <MailboxIdParameter> -Save <SwitchParameter> <COMMON PARAMETERS>

Set-UserPhoto -Identity <MailboxIdParameter> -Preview <SwitchParameter> [-PictureData <Byte[]>] [-PictureStream <Stream>] <COMMON PARAMETERS>

Set-UserPhoto -Cancel <SwitchParameter> -Identity <MailboxIdParameter> <COMMON PARAMETERS>

COMMON PARAMETERS: [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-GroupMailbox <SwitchParameter>] [-IgnoreDefaultScope <SwitchParameter>] [-PhotoType <String>] [-WhatIf [<SwitchParameter>]]

Cet exemple illustre le téléchargement et l’enregistrement d’une photo sur le compte d’utilisateur de Paul Cannon à l’aide d’une seule commande.

Set-UserPhoto "Paul Cannon" -PictureData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\PaulCannon.jpg"))

Cet exemple montre comment utiliser deux commandes pour télécharger et enregistrer l’aperçu d’une photo sur le compte d’utilisateur d’Ann Beebe.

Cette commande décrit le téléchargement de l’aperçu d’une photo sur le compte d’utilisateur d’Ann Beebe.

Set-UserPhoto "Ann Beebe" -PictureData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\AnnBeebe.jpg")) -Preview

Pour enregistrer l’aperçu d’une photo téléchargée via la commande précédemment décrite, procédez comme suit :

Set-UserPhoto "Ann Beebe" -Save

Pour supprimer l’aperçu d’une photo téléchargée via la commande précédemment décrite (dans notre exemple), procédez comme suit :

Set-UserPhoto "Ann Beebe" -Cancel

La fonctionnalité Photos permet aux utilisateurs d’associer une photo à leur compte. Les photos utilisateur sont stockées sur le compte de l’utilisateur Active Directory, ainsi que dans le répertoire racine de la boîte aux lettres Exchange de l’utilisateur. Les administrateurs utilisent la cmdlet Set-UserPhoto ou le Centre d’administration Exchange (CAE) pour configurer les photos d’utilisateur. L’utilisateur peut télécharger, consulter et enregistrer une photo utilisateur dans la page Options d’Outlook sur le web. Lorsqu’un utilisateur télécharge une photo, l’aperçu de la photo s’affiche dans la page Options d’Outlook sur le web. Il ne s’agit que d’un aperçu. Vous obtenez donc les mêmes résultats que lorsque vous exécutez la cmdlet Set-UserPhoto avec le paramètre Preview. Si vous cliquez sur Enregistrer, vous enregistrez l’aperçu de la photo de l’utilisateur. Vous obtenez le même résultat qu’en exécutant la commande Set-UserPhoto -Save, ou en exécutant les commandes Set-UserPhoto -Preview et Set-UserPhoto -Save Si l’utilisateur supprime l’aperçu sur la page Options d’Outlook sur le web, la commande Set-UserPhoto -Cancel est appelée.

Vous devez configurer cette fonctionnalité avant d’exécuter la cmdlet Get-UserPhoto pour consulter les informations. Dans le cas contraire, vous obtiendrez un message d’erreur qui indique que l’utilisateur n’existe pas. Vous pouvez également exécuter la commande Get-UserPhoto -Preview pour afficher des informations sur un aperçu.

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que tous les paramètres de cette cmdlet soient répertoriés dans cette rubrique, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour voir les autorisations qui vous sont nécessaires, voir Section « Autorisations de configuration des destinataires » dans la rubrique Autorisations des destinataires.

 

Paramètre Obligatoire Type Description

Cancel

Obligatoire

System.Management.Automation.SwitchParameter

Le paramètre de commutateur Cancel supprime la photo actuellement téléchargée comme aperçu. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Pour supprimer la photo qui est actuellement associée à un compte d’utilisateur, utilisez la cmdlet Remove-UserPhoto. Le commutateur Cancel supprime uniquement l’aperçu.

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Le paramètre Identity spécifie l’identité de l’utilisateur. Vous pouvez utiliser n’importe quelle valeur qui identifie l’utilisateur de façon unique.

Par exemple :

  • Nom

  • Nom complet

  • Alias

  • Nom unique

  • Nom unique canonique

  • <domain name>\<account name>

  • Adresse de messagerie

  • GUID

  • LegacyExchangeDN

  • SamAccountName

  • Identifiant utilisateur ou nom d’utilisateur principal (UPN)

PictureData

Obligatoire

System.Byte[]

Le paramètre PictureData indique le fichier que vous téléchargez sur le compte utilisateur.

Ce paramètre utilise la syntaxe ([System.IO.File]::ReadAllBytes("<nom de fichier et chemin d’accès>")). Voici un exemple. ([System.IO.File]::ReadAllBytes("C:\Documents\Pictures\MyPhoto.jpg")).

PictureStream

Obligatoire

System.IO.Stream

Le paramètre PictureStream indique le fichier que vous téléchargez sur le compte utilisateur. Des applications clientes, notamment Outlook sur le web, emploient ce paramètre lorsqu’un utilisateur souhaite ajouter une photo. Pour télécharger une photo à l’aide de PowerShell, utilisez le paramètre PictureData pour spécifier le fichier de la photo.

Preview

Obligatoire

System.Management.Automation.SwitchParameter

Le commutateur Preview télécharge un aperçu pour le compte utilisateur. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

L’aperçu est l’objet photo qui est téléchargé sur le compte de l’utilisateur, mais qui n’est pas enregistré. Par exemple, si vous téléchargez une photo sur la page Options d’Outlook sur le web pour la prévisualiser avant de l’enregistrer. Si vous utilisez le commutateur Preview pour télécharger un aperçu, exécutez la commande Set-UserPhoto -Save pour l’enregistrer comme photo de l’utilisateur.

Save

Obligatoire

System.Management.Automation.SwitchParameter

Le commutateur Save spécifie que la photo téléchargée vers le compte de l’utilisateur sera enregistrée en tant que photo de ce dernier. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Confirm spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.

  • Les cmdlets destructives (par exemple, les cmdlets Remove-*) ont une pause intégrée qui vous oblige à confirmer la commande avant de poursuivre. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.

  • La plupart des autres cmdlets (par exemple, les cmdlets New-* et Set-*) n’ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Ce paramètre est disponible uniquement dans Exchange 2016 sur site.

Le paramètre DomainController spécifie le contrôleur de domaine qui est utilisé par cette cmdlet pour lire ou écrire les données dans Active Directory. Vous identifiez le contrôleur de domaine par son nom de domaine complet (FQDN). Par exemple : dc01.contoso.com.

GroupMailbox

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur GroupMailbox indique que l’utilisateur spécifié est un Groupe Office 365. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

IgnoreDefaultScope

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur IgnoreDefaultScope donne pour instruction à la commande d’ignorer le paramétrage de l’étendue du destinataire par défaut pour la session Exchange Management Shell et d’utiliser l’ensemble de la forêt comme étendue. Cela permet à la commande d’accéder à des objets Active Directory ne figurant pas actuellement dans l’étendue par défaut.

L’utilisation du commutateur IgnoreDefaultScope introduit les restrictions suivantes :

  • Vous ne pouvez pas utiliser le paramètre DomainController. La commande utilise automatiquement un serveur de catalogue global approprié.

  • Vous ne pouvez utiliser que le nom unique pour le paramètre Identity. D'autres formes d'identification, telles qu'un alias ou un GUID, ne sont pas acceptées.

PhotoType

Facultatif

System.String

PARAMVALUE : String

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur WhatIf simule les actions de la commande. Vous pouvez utiliser ce commutateur pour afficher les modifications qui se produiraient sans réellement appliquer ces modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Pour visualiser les types d’entrées acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type d’entrée pour une cmdlet est vide, la cmdlet n’accepte pas les données d’entrée.

Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.

 
Afficher: