Set-UserPhoto
Este cmdlet está disponible en Exchange local y en el servicio basado en la nube. Puede que algunos parámetros y opciones de configuración sean exclusivos de un entorno u otro.
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 locales y basadas en la nube, como Outlook en la Web, Lync, Skype Empresarial y SharePoint.
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.
Syntax
Set-UserPhoto
[-Identity] <MailboxIdParameter>
[-Cancel]
[-Confirm]
[-GroupMailbox]
[-DomainController <Fqdn>]
[-IgnoreDefaultScope]
[-PhotoType <String>]
[-WhatIf]
[<CommonParameters>] Set-UserPhoto
[-Identity] <MailboxIdParameter>
-PictureData <Byte[]>
[-Confirm]
[-DomainController <Fqdn>]
[-GroupMailbox]
[-IgnoreDefaultScope]
[-PhotoType <String>]
[-WhatIf]
[<CommonParameters>] Set-UserPhoto
[-Identity] <MailboxIdParameter>
[-PictureData <Byte[]>]
[-PictureStream <Stream>]
[-Preview]
[-Confirm]
[-DomainController <Fqdn>]
[-GroupMailbox]
[-IgnoreDefaultScope]
[-PhotoType <String>]
[-WhatIf]
[<CommonParameters>] Set-UserPhoto
[-Identity] <MailboxIdParameter>
-PictureStream <Stream>
[-Confirm]
[-DomainController <Fqdn>]
[-GroupMailbox]
[-IgnoreDefaultScope]
[-PhotoType <String>]
[-WhatIf]
[<CommonParameters>] Set-UserPhoto
[-Identity] <MailboxIdParameter>
[-Save]
[-Confirm]
[-DomainController <Fqdn>]
[-GroupMailbox]
[-IgnoreDefaultScope]
[-PhotoType <String>]
[-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, aparecerá un mensaje de error que indica que la foto de 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 de usuario no aparecerán en SharePoint hasta que el usuario afectado visite su página de perfil (Mi sitio) o cualquier página de SharePoint que muestre su imagen en miniatura grande.
- En PowerShell de Microsoft Graph, también están disponibles los cmdlets Update-MgUserPhoto y Set-MgUserPhotoContent .
Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. 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" -SaveEn 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" -CancelEn este ejemplo se elimina la foto de vista previa que se cargó en el ejemplo anterior.
Parámetros
-Cancel
El parámetro cancelar modificador elimina la foto que se carga actualmente como la foto de vista previa. 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Confirm
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, 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 demás cmdlets (por ejemplo, los cmdlets 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.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DomainController
Este parámetro solo está disponible en Exchange local.
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.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-GroupMailbox
El modificador GroupMailbox es necesario para modificar Grupos de Microsoft 365. No es necesario especificar un valor con este modificador.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Identity
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)
| Type: | MailboxIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-IgnoreDefaultScope
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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-PhotoType
Este parámetro está reservado para uso interno de Microsoft.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-PictureData
El parámetro PictureData especifica el archivo de foto que se 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).
| Type: | Byte[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-PictureStream
El parámetro PictureStream especifica la foto que se 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.
| Type: | Stream |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Preview
El modificador Vista previa carga una foto de vista previa para la cuenta de usuario. No es necesario especificar un valor con este modificador.
Una foto de vista previa es el objeto de foto que se carga 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Save
El modificador Guardar especifica que la foto que se carga en la cuenta del usuario se guardará como la foto del usuario. No es necesario especificar un valor con este modificador.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-WhatIf
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.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
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.