Compartir a través de

Set-UserPhoto

Módulo:
Exchange PowerShell

Este cmdlet solo está disponible en el entorno local de Exchange.

Utilice el cmdlet Set-UserPhoto para configurar la característica de fotos de usuario que permite a los usuarios asociar una imagen a su cuenta. Las fotos de usuario aparecen en aplicaciones cliente, como Outlook, Microsoft Teams y SharePoint.

Nota: En Microsoft 365, puede administrar las fotos de usuario en PowerShell de Microsoft Graph. Para obtener instrucciones, consulte Administración de fotos de usuario en PowerShell de Microsoft Graph.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Sintaxis

CancelPhoto 

Set-UserPhoto
    [-Identity] <MailboxIdParameter>
    [-Cancel]
    [-Confirm]
    [-GroupMailbox]
    [-DomainController <Fqdn>]
    [-IgnoreDefaultScope]
    [-PhotoType <String>]
    [-UseCustomRouting]
    [-WhatIf]
    [<CommonParameters>]

UploadPhotoData 

Set-UserPhoto
    [-Identity] <MailboxIdParameter>
    -PictureData <Byte[]>
    [-Confirm]
    [-DomainController <Fqdn>]
    [-GroupMailbox]
    [-IgnoreDefaultScope]
    [-PhotoType <String>]
    [-UseCustomRouting]
    [-WhatIf]
    [<CommonParameters>]

UploadPreview 

Set-UserPhoto
    [-Identity] <MailboxIdParameter>
    [-PictureData <Byte[]>]
    [-PictureStream <Stream>]
    [-Preview]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-GroupMailbox]
    [-IgnoreDefaultScope]
    [-PhotoType <String>]
    [-UseCustomRouting]
    [-WhatIf]
    [<CommonParameters>]

UploadPhotoStream 

Set-UserPhoto
    [-Identity] <MailboxIdParameter>
    -PictureStream <Stream>
    [-Confirm]
    [-DomainController <Fqdn>]
    [-GroupMailbox]
    [-IgnoreDefaultScope]
    [-PhotoType <String>]
    [-UseCustomRouting]
    [-WhatIf]
    [<CommonParameters>]

SavePhoto 

Set-UserPhoto
    [-Identity] <MailboxIdParameter>
    [-Save]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-GroupMailbox]
    [-IgnoreDefaultScope]
    [-PhotoType <String>]
    [-UseCustomRouting]
    [-WhatIf]
    [<CommonParameters>]

Description

La característica de fotos de usuario permite a los usuarios asociar una imagen a su cuenta. Las fotos de usuario se almacenan en la cuenta de Active Directory del usuario y en el directorio raíz del buzón de Exchange del usuario. Los administradores usan el cmdlet Set-UserPhoto para configurar las fotos de usuario. Los usuarios pueden cargar, obtener una vista previa y guardar una foto de usuario en su cuenta en la página Opciones de Outlook en la Web. Cuando un usuario carga una foto, se muestra una vista previa de la foto en la página Opciones de Outlook en la Web. Este es el estado de vista previa, y ofrece el mismo resultado que si se ejecuta el cmdlet Set-UserPhoto mediante el parámetro Preview. Si el usuario hace clic en Guardar, la foto de vista previa se guarda como la foto del usuario. Este es el mismo resultado que ejecutar el Set-UserPhoto -Save comando o ejecutar los Set-UserPhoto -Preview comandos y Set-UserPhoto -Save . Si el usuario cancela la foto de vista previa en la página Opciones de Outlook en la Web, se llama al Set-UserPhoto -Cancel comando .

Se debe establecer una foto de usuario para poder ejecutar el cmdlet Get-UserPhoto y ver la información de la foto del usuario. De lo contrario, recibirá un mensaje de error que indica que la foto del usuario no existe para el usuario especificado. Como alternativa, puede ejecutar el Get-UserPhoto -Preview comando para ver información sobre una foto de vista previa.

Notas: Los cambios en la foto del usuario no aparecen en SharePoint hasta que el usuario afectado visita su página de perfil (Mi sitio) o cualquier página de SharePoint que muestre su imagen en miniatura grande.

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este artículo se enumeran todos los parámetros del cmdlet, es posible que no tenga acceso a algunos parámetros si no se incluyen en los permisos que se le asignan. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Ejemplos

Ejemplo 1

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

En este ejemplo, se carga y se guarda una foto en la cuenta de usuario de Paul Cannon con un solo comando.

Ejemplo 2

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

Set-UserPhoto "Ann Beebe" -Save

En este ejemplo, se muestra cómo usar dos comandos para cargar y guardar una foto de vista previa en la cuenta de usuario de Ann Beebe. El primer comando carga una foto de vista previa en la cuenta de usuario de Ann Beebe y el segundo comando guarda la foto cargada como la foto de vista previa.

Ejemplo 3

Set-UserPhoto -Identity "Ann Beebe" -Cancel

En este ejemplo se elimina la foto de vista previa que se cargó en el ejemplo anterior.

Parámetros

-Cancel

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

El modificador Cancelar elimina la foto de vista previa actual. No es necesario especificar un valor con este modificador.

Para eliminar la foto que está asociada actualmente a la cuenta de un usuario, use el cmdlet Remove-UserPhoto. El modificador Cancelar solo elimina la foto de vista previa.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

CancelPhoto
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Confirm

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el cmdlet depende de si el cmdlet requiere confirmación antes de continuar.

  • Los cmdlets destructivos (por ejemplo, los cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta: -Confirm:$false.
  • La mayoría de los otros cmdlets (por ejemplo, New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el comando antes de continuar.

Este cmdlet tiene una pausa integrada, por lo que debe usar -Confirm:$false para omitir la confirmación.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DomainController

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

El parámetro DomainController especifica el controlador de dominio que el cmdlet usa para leer datos de Active Directory o escribirlos. El controlador de dominio se identifica por su nombre de dominio completo (FQDN). Por ejemplo, dc01.contoso.com.

Propiedades del parámetro

Tipo:Fqdn
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-GroupMailbox

Aplicable: Exchange Server 2016, Exchange Server 2019

El modificador GroupMailbox es necesario para modificar Grupos de Microsoft 365. No es necesario especificar un valor con este modificador.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Identity

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

El parámetro Identity especifica la identidad del usuario. Puede usar cualquier valor que identifique el usuario de forma exclusiva. Por ejemplo:

  • Nombre
  • Alias
  • Nombre distintivo (DN)
  • Nombre completo (DN)
  • Dominio\Nombre de usuario
  • Dirección de correo electrónico
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuario o nombre de la entidad de seguridad de usuario (UPN)

Propiedades del parámetro

Tipo:MailboxIdParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:1
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-IgnoreDefaultScope

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

El modificador IgnoreDefaultScope indica al comando que ignore la configuración predeterminada del ámbito del destinatario para la sesión de Exchange PowerShell y que use todo el bosque como ámbito. No es necesario especificar un valor con este modificador.

Este cambio habilita el comando tenga acceso a objetos de Active Directory que no están actualmente disponibles en el ámbito predeterminado, pero también introduce las siguientes restricciones:

  • No puede usar el parámetro DomainController. El comando usa un servidor de catálogo global adecuado de forma automática.
  • Sólo puede usar el DN para el parámetro Identity. No se aceptan otras formas de identificación, como alias o GUID.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-PhotoType

Aplicable: Exchange Server 2016, Exchange Server 2019

Este parámetro está reservado para uso interno de Microsoft.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-PictureData

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

El parámetro PictureData especifica el archivo fotográfico que se va a cargar en la cuenta del usuario.

Un valor válido para este parámetro requiere que lea el archivo en un objeto codificado en bytes mediante la sintaxis siguiente: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). Puede usar este comando como valor de parámetro o puede escribir la salida en una variable ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) y usar la variable como valor de parámetro ($data).

Propiedades del parámetro

Tipo:

Byte[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UploadPhotoData
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
UploadPreview
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-PictureStream

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

El parámetro PictureStream especifica la foto que se va a cargar en la cuenta del usuario. Este parámetro lo usan aplicaciones cliente como Outlook en la Web cuando los usuarios agregan una foto. Para cargar una foto con PowerShell, use el parámetro PictureData para especificar el archivo de foto.

Propiedades del parámetro

Tipo:Stream
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UploadPhotoStream
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
UploadPreview
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Preview

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

El modificador Vista previa carga una foto de vista previa para la cuenta de usuario. No es necesario especificar un valor con este modificador.

Se carga una foto en versión preliminar en la cuenta del usuario, pero no se guarda. Por ejemplo, si un usuario carga una foto en Outlook en la Web Opciones para obtener una vista previa antes de guardarlo. Si usa el modificador Vista previa para cargar una foto de vista previa, debe ejecutar el comando Set-UserPhoto -Save para guardarlo como la foto del usuario.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UploadPreview
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Save

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

El modificador Guardar especifica que la foto cargada se guarda como la foto del usuario. No es necesario especificar un valor con este modificador.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

SavePhoto
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

El modificador WhatIf simula las acciones del comando. Puede usar este modificador para ver los cambios que se producirían, pero sin aplicar los cambios. No es necesario especificar un valor con este modificador.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.

Entradas

Input types

Para ver los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.

Salidas

Output types

Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.