Set-UserPhoto

Módulo:: Exchange PowerShell

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 fotos do usuário são exibidas em aplicativos cliente, como Outlook, Microsoft Teams e SharePoint.

Observação: no Microsoft 365, você pode gerenciar fotos do usuário no Microsoft Graph PowerShell. Para obter instruções, consulte Gerenciar fotos do usuário 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 fotos dos usuários são armazenadas na conta do Active Directory do usuário e no diretório raiz da caixa de correio do Exchange do usuário. Os administradores usam o cmdlet Set-UserPhoto para configurar as fotos do usuário. Os usuários podem carregar, visualizar e salvar uma foto de usuário em sua conta na página Opções do Outlook na Web. Quando um usuário carrega uma foto, uma visualização da foto é exibida na página Opções do 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. Esse é o mesmo resultado que executar o Set-UserPhoto -Save comando ou executar os Set-UserPhoto -Preview comandos and Set-UserPhoto -Save . Se o usuário cancelar a foto de visualização na página Opções no Outlook na Web, o Set-UserPhoto -Cancel comando será 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, você receberá uma mensagem de erro informando que a foto do usuário não existe para o usuário especificado. Como alternativa, você pode executar o Get-UserPhoto -Preview comando para exibir informações sobre uma foto de visualização.

Observações: As alterações na foto do usuário não aparecem no SharePoint até que o usuário afetado visite sua página de perfil (Meu Site) ou qualquer página do SharePoint que mostre sua imagem em miniatura grande.

Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. 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 foto de visualização para a conta de usuário de Ann Beebe e o segundo comando salva a foto carregada como a foto de visualização.

Exemplo 3

Set-UserPhoto -Identity "Ann Beebe" -Cancel

Este exemplo exclui a foto de visualização que foi carregada no exemplo anterior.

Parâmetros

-Cancel

O botão Cancelar exclui a foto de visualização atual. Não é preciso especificar um valor com essa opção.

Para excluir a foto atualmente associada à conta de um usuário, use o cmdlet Remove-UserPhoto. O botão Cancelar exclui apenas a foto de 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

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer 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 reconhecer o comando antes de continuar.

Este cmdlet tem uma pausa interna, portanto, use -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

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

O comutador GroupMailbox é necessário para modificar os 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

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 usuário
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

A opção IgnoreDefaultScope informa ao comando para ignorar a configuração de escopo de destinatário padrão para a sessão do PowerShell do Exchange e usar toda a floresta como escopo. Não é preciso especificar um valor com essa opção.

Essa opção permite que o comando acesse objetos do Active Directory que não estão disponíveis no momento no escopo padrão, 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

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

O parâmetro PictureData especifica o arquivo de foto a ser carregado para a conta do usuário.

Um valor válido para esse parâmetro exige que você leia o arquivo em um objeto codificado por byte usando a seguinte sintaxe: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). Você pode usar esse comando como o valor do parâmetro ou pode gravar a saída em uma variável ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) e usar 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

O parâmetro PictureStream especifica a foto a ser carregada na conta do usuário. Esse parâmetro é usado por aplicativos cliente, como o Outlook na Web, quando os usuários adicionam uma foto. 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

O botão de visualização carrega uma foto de visualização para a conta de usuário. Não é preciso especificar um valor com essa opção.

Uma foto de visualização é carregada na conta do usuário, mas não é salva. Por exemplo, se um usuário carregar uma foto no Outlook na Web, escolha Opções para visualizar antes de salvá-la. Se você usar a opção Visualizar para carregar uma foto de visualização, precisará executar o comando Set-UserPhoto -Save para salvá-la como a foto do usuário.

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

A opção Salvar especifica que a foto carregada é salva como a foto do usuário. 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

A opção WhatIf mostra o que o comando faz sem fazer nenhuma alteração. 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 dá suporte aos 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.

Comentários

Esta página foi útil?