Set-UserPhoto
Este cmdlet está disponível somente no Exchange local.
Use o cmdlet Set-UserPhoto para configurar o recurso de fotos de usuário que permite que os usuários associem uma foto às suas contas. As fotografias do utilizador são apresentadas em aplicações cliente, como o Outlook, o Microsoft Teams e o SharePoint.
Nota: no Microsoft 365, pode gerir fotografias de utilizador no Microsoft Graph PowerShell. Para obter instruções, consulte Gerir fotografias de utilizador no Microsoft Graph PowerShell.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
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
O recurso fotos de usuário permite que os usuários associem uma foto às suas contas. As fotografias do utilizador são armazenadas na conta do Active Directory do utilizador e no diretório de raiz da caixa de correio do Exchange do utilizador. Os administradores utilizam o cmdlet Set-UserPhoto para configurar fotografias de utilizador. Os utilizadores podem carregar, pré-visualizar e guardar uma fotografia de utilizador na respetiva conta na página Opções no Outlook na Web. Quando um utilizador carrega uma fotografia, é apresentada uma pré-visualização da fotografia na página Opções no Outlook na Web. Este é o estado de visualização e cria o mesmo resultado que executar o cmdlet Set-UserPhoto usando o parâmetro Preview. Se o usuário clicar em Salvar, a foto de visualização é salva como a foto do usuário. Este é o mesmo resultado que executar o Set-UserPhoto -Save comando ou executar os Set-UserPhoto -Preview comandos e Set-UserPhoto -Save . Se o utilizador cancelar a fotografia de pré-visualização na página Opções no Outlook na Web, o Set-UserPhoto -Cancel comando é chamado.
A foto do usuário deve ser definido para um usuário antes que você possa executar o cmdlet Get-UserPhoto para exibir informações sobre a foto do usuário. Caso contrário, recebe uma mensagem de erro a indicar que a fotografia de utilizador não existe para o utilizador especificado. Em alternativa, pode executar o Get-UserPhoto -Preview comando para ver informações sobre uma fotografia de pré-visualização.
Notas: as alterações à fotografia de utilizador não aparecem no SharePoint até que o utilizador afetado visite a página de perfil (O Meu Site) ou qualquer página do SharePoint que mostre a imagem em miniatura grande.
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.
Exemplos
Exemplo 1
Set-UserPhoto -Identity "Paul Cannon" -PictureData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\PaulCannon.jpg"))
Este exemplo carrega e salva uma foto para a conta de usuário do Paul Cannon usando um único comando.
Exemplo 2
Set-UserPhoto -Identity "Ann Beebe" -PictureData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\AnnBeebe.jpg")) -Preview
Set-UserPhoto "Ann Beebe" -Save
Este exemplo mostra como usar dois comandos para carregar e salvar uma foto de visualização para a conta de usuário de Ann Beebe. O primeiro comando carrega uma fotografia de pré-visualização para a conta de utilizador de Ann Beebe e o segundo comando guarda a fotografia carregada como a fotografia de pré-visualização.
Exemplo 3
Set-UserPhoto -Identity "Ann Beebe" -Cancel
Este exemplo elimina a fotografia de pré-visualização que foi carregada no exemplo anterior.
Parâmetros
-Cancel
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O comutador Cancelar elimina a fotografia de pré-visualização atual. Não é preciso especificar um valor com essa opção.
Para eliminar a fotografia que está atualmente associada à conta de um utilizador, utilize o cmdlet Remove-UserPhoto. O comutador Cancelar só elimina a fotografia de pré-visualização.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
CancelPhoto
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Confirm
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.
- Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false. - A maioria dos outros cmdlets (por exemplo, New- e Set-) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.
Este cmdlet tem uma pausa incorporada, pelo que deve utilizar -Confirm:$false para ignorar a confirmação.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DomainController
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.
Propriedades do parâmetro
| Tipo: | Fqdn |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-GroupMailbox
Aplicável: Exchange Server 2016, Exchange Server 2019
O comutador GroupMailbox é necessário para modificar Grupos do Microsoft 365. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Identity
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro Identityespecifica a identidade do usuário. É possível usar qualquer valor que identifique o usuário com exclusividade. Por exemplo:
- Nome
- Alias
- Nome diferenciado (DN)
- Nome diferenciado (DN)
- Domínio\Nome de Utilizador
- Endereço de email
- GUID
- LegacyExchangeDN
- SamAccountName
- ID de usuário ou nome UPN
Propriedades do parâmetro
| Tipo: | MailboxIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-IgnoreDefaultScope
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O comutador IgnoreDefaultScope indica ao comando para ignorar a definição de âmbito de destinatário predefinida para a sessão do Exchange PowerShell e utilizar toda a floresta como âmbito. Não é preciso especificar um valor com essa opção.
Este comutador permite que o comando aceda a objetos do Active Directory que não estão atualmente disponíveis no âmbito predefinido, mas também introduz as seguintes restrições:
- Não é possível usar o parâmetro DomainController. O comando usa um servidor de catálogo global adequado automaticamente.
- Não é possível usar o parâmetro DomainController. O comando usa um servidor de catálogo global adequado automaticamente.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PhotoType
Aplicável: Exchange Server 2016, Exchange Server 2019
Esse parâmetro está reservado para uso interno da Microsoft.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PictureData
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro PictureData especifica o ficheiro de fotografia a carregar para a conta do utilizador.
Um valor válido para este parâmetro requer que leia o ficheiro para um objeto codificado por bytes com a seguinte sintaxe: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). Pode utilizar este comando como o valor do parâmetro ou escrever a saída numa variável ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) e utilizar a variável como o valor do parâmetro ($data).
Propriedades do parâmetro
| Tipo: | Byte[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
UploadPhotoData
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
UploadPreview
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PictureStream
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro PictureStream especifica a fotografia a carregar para a conta do utilizador. Este parâmetro é utilizado por aplicações cliente, como Outlook na Web quando os utilizadores adicionam uma fotografia. Para carregar uma foto usando o PowerShell, use o parâmetro PictureData para especificar o arquivo de foto.
Propriedades do parâmetro
| Tipo: | Stream |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
UploadPhotoStream
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
UploadPreview
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Preview
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O comutador pré-visualização carrega uma fotografia de pré-visualização para a conta de utilizador. Não é preciso especificar um valor com essa opção.
É carregada uma fotografia de pré-visualização para a conta do utilizador, mas não é guardada. Por exemplo, se um utilizador carregar uma fotografia no Outlook na Web Opções para pré-visualizar antes de a guardar. Se utilizar o comutador Pré-visualização para carregar uma fotografia de pré-visualização, terá de executar o comando Set-UserPhoto -Save para guardá-la como a fotografia do utilizador.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
UploadPreview
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Save
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O comutador Guardar especifica que a fotografia carregada é guardada como a fotografia do utilizador. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
SavePhoto
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.
Entradas
Input types
Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.
Saídas
Output types
Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.