Set-UserPhoto
Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.
Usare il cmdlet Set-UserPhoto per configurare la funzionalità foto utente che consente agli utenti di associare una fotografia ai propri account. Le foto utente vengono visualizzate nelle applicazioni client locali e basate sul cloud, ad esempio Outlook sul web, Lync, Skype for Business e SharePoint.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
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>] Descrizione
La funzionalità foto utente consente agli utenti di associare una fotografia al proprio account. Le foto utente vengono archiviate nell'account Active Directory dell'utente e nella directory radice della cassetta postale di Exchange dell'utente. Gli amministratori usano il cmdlet Set-UserPhoto per configurare le foto utente. Gli utenti possono caricare, visualizzare in anteprima e salvare una foto dell'utente nel proprio account nella pagina Opzioni in Outlook sul web. Quando un utente carica una foto, nella pagina Opzioni di Outlook sul web viene visualizzata un'anteprima della foto. Questo è lo stato di anteprima e crea lo stesso risultato dell'esecuzione del cmdlet Set-UserPhoto usando il parametro Preview. Se l'utente fa clic su Salva, la foto di anteprima viene salvata come foto dell'utente. Questo è lo stesso risultato dell'esecuzione del comando o dell'esecuzione Set-UserPhoto -Save di entrambi i Set-UserPhoto -Preview comandi e Set-UserPhoto -Save . Se l'utente annulla la foto di anteprima nella pagina Opzioni in Outlook sul web, viene chiamato il Set-UserPhoto -Cancel comando .
È necessario impostare una foto utente per un utente prima di poter eseguire il cmdlet Get-UserPhoto per visualizzare le informazioni sulla foto dell'utente. In caso contrario, verrà visualizzato un messaggio di errore che indica che la foto dell'utente non esiste per l'utente specificato. In alternativa, è possibile eseguire il Get-UserPhoto -Preview comando per visualizzare le informazioni su una foto di anteprima.
Note:
- Le modifiche apportate alla foto utente non verranno visualizzate in SharePoint finché l'utente interessato non visita la pagina del profilo (Sito personale) o qualsiasi pagina di SharePoint che mostra l'immagine di anteprima di grandi dimensioni.
- In Microsoft Graph PowerShell sono disponibili anche i cmdlet Update-MgUserPhoto e Set-MgUserPhotoContent .
È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.
Esempio
Esempio 1
Set-UserPhoto -Identity "Paul Cannon" -PictureData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\PaulCannon.jpg"))In questo esempio viene caricata e salvata una foto sull'account utente di Paul Cannon con un unico comando.
Esempio 2
Set-UserPhoto -Identity "Ann Beebe" -PictureData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\AnnBeebe.jpg")) -Preview
Set-UserPhoto "Ann Beebe" -SaveQuesto esempio mostra come utilizzare due comandi per caricare e salvare l'anteprima di una foto sull'account utente di Ann Beebe. Il primo comando carica una foto di anteprima nell'account utente di Ann Beebe e il secondo comando salva la foto caricata come foto di anteprima.
Esempio 3
Set-UserPhoto -Identity "Ann Beebe" -CancelIn questo esempio viene eliminata la foto di anteprima caricata nell'esempio precedente.
Parametri
-Cancel
Il parametro cancel switch consente di eliminare la foto attualmente caricata come foto di anteprima. Con questa opzione non è necessario specificare alcun valore.
Per eliminare la foto attualmente associata all'account di un utente, usare il cmdlet Remove-UserPhoto. L'opzione Cancel consente di eliminare solo la foto di anteprima.
| 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
L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.
- I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi:
-Confirm:$false. - La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
| 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
Questo parametro è disponibile solo in Exchange locale.
Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, 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
L'opzione GroupMailbox è necessaria per modificare Gruppi di Microsoft 365. Con questa opzione non è necessario specificare alcun valore.
| 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
Il parametro Identity consente di specificare l'identità dell'utente. È possibile utilizzare qualsiasi valore che identifichi l'utente in modo univoco. Ad esempio:
- Nome
- Alias
- Nome distinto (DN)
- Nome distinto (DN)
- Dominio\nomeutente
- Indirizzo di posta elettronica
- GUID
- LegacyExchangeDN
- SamAccountName
- ID utente o Nome entità utente (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
L'opzione IgnoreDefaultScope indica al comando di ignorare l'impostazione dell'ambito del destinatario predefinito per la sessione di Exchange PowerShell e di usare l'intera foresta come ambito. Con questa opzione non è necessario specificare alcun valore.
Questa opzione consente al comando di accedere agli oggetti active directory attualmente non disponibili nell'ambito predefinito, ma introduce anche le restrizioni seguenti:
- Non è possibile utilizzare il parametro DomainController. Il comando utilizza automaticamente un server di catalogo globale appropriato.
- È possibile utilizzare solo il DN per il parametro Identity. Non vengono accettate altre forme di identificazione, ad esempio 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
Questo parametro è riservato all'uso interno da parte di 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
Il parametro PictureData specifica il file di foto che verrà caricato nell'account dell'utente.
Per un valore valido per questo parametro è necessario leggere il file in un oggetto con codifica byte usando la sintassi seguente: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). È possibile usare questo comando come valore del parametro oppure scrivere l'output in una variabile ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) e usare la variabile come valore del parametro ($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
Il parametro PictureStream specifica la foto che deve essere caricata sull'account utente. Questo parametro viene usato dalle applicazioni client, ad esempio Outlook sul web quando gli utenti aggiungono una foto. Per caricare una foto usando PowerShell, usare il parametro PictureData per specificare il file di 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
L'opzione Preview consente di caricare una foto di anteprima per l'account utente. Con questa opzione non è necessario specificare alcun valore.
Una foto di anteprima è l'oggetto foto caricato nell'account dell'utente, ma non salvato. Ad esempio, se un utente carica una foto in Outlook sul web Opzioni per visualizzare l'anteprima prima di salvarla. Se si usa l'opzione Anteprima per caricare una foto di anteprima, è necessario eseguire il comando Set-UserPhoto -Save per salvarla come foto dell'utente.
| 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
L'opzione Save consente di specificare che la foto caricata sull'account utente verrà salvata come foto utente. Con questa opzione non è necessario specificare alcun valore.
| 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
L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.
| 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 |
Input
Input types
Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.
Output
Output types
Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.