Set-UserPhoto
Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут отличаться в зависимости от среды.
Используйте командлет Set-UserPhoto, чтобы настроить функцию "Фотографии пользователей", которая позволяет пользователям связывать рисунок со своей учетной записью. Фотографии пользователей отображаются в локальных и облачных клиентских приложениях, таких как Outlook в Интернете, Lync, Skype для бизнеса и SharePoint.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
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>] Описание
С помощью функции фотографий пользователя можно назначить изображение своей учетной записи. Фотографии пользователей хранятся в учетной записи Пользователя Active Directory и в корневом каталоге почтового ящика Exchange пользователя. Администраторы используют командлет Set-UserPhoto для настройки фотографий пользователей. Пользователи могут загружать, просматривать и сохранять фотографию пользователя в своей учетной записи на странице Параметры в Outlook в Интернете. Когда пользователь загружает фотографию, предварительный просмотр фотографии отображается на странице Параметры в Outlook в Интернете. Это состояние предварительной версии и создает тот же результат, что и выполнение командлета Set-UserPhoto с помощью параметра Preview. Если пользователь нажмет кнопку Сохранить, фотография предварительного просмотра сохраняется как фотография пользователя. Это тот же результат, что и выполнение Set-UserPhoto -Save команды или Set-UserPhoto -Preview команды и Set-UserPhoto -Save . Если пользователь отменяет предварительный просмотр фотографии на странице Параметры в Outlook в Интернете, Set-UserPhoto -Cancel вызывается команда .
Фотография пользователя должна быть задана для пользователя, прежде чем можно будет запустить командлет Get-UserPhoto для просмотра сведений о фотографии пользователя. В противном случае вы получите сообщение об ошибке о том, что фотография пользователя не существует для указанного пользователя. Кроме того, можно выполнить Get-UserPhoto -Preview команду , чтобы просмотреть сведения о предварительной версии фотографии.
Примечания.
- Изменения фотографии пользователя не будут отображаться в SharePoint до тех пор, пока затронутый пользователь не перейдет на страницу своего профиля (личный сайт) или любую страницу SharePoint, на которую отображается его большое эскизное изображение.
- В Microsoft Graph PowerShell также доступны командлеты Update-MgUserPhoto и Set-MgUserPhotoContent .
Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
Set-UserPhoto -Identity "Paul Cannon" -PictureData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\PaulCannon.jpg"))В этом примере фотография передается и сохраняется в учетной записи пользователя Пола Кэннона с помощью одной команды.
Пример 2
Set-UserPhoto -Identity "Ann Beebe" -PictureData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\AnnBeebe.jpg")) -Preview
Set-UserPhoto "Ann Beebe" -SaveВ этом примере показано, как использовать две команды для отправки и сохранения фотографии предварительного просмотра в учетную запись пользователя Энн Биб. Первая команда отправляет фотографию предварительного просмотра в учетную запись пользователя Энн Биб, а вторая команда сохраняет отправленную фотографию в качестве фотографии предварительного просмотра.
Пример 3
Set-UserPhoto -Identity "Ann Beebe" -CancelВ этом примере удаляется фотография предварительного просмотра, отправленная в предыдущем примере.
Параметры
-Cancel
Параметр "Отмена" удаляет фотографию, которая в настоящее время загружена в качестве фотографии предварительного просмотра. Указывать значение для этого параметра необязательно.
Чтобы удалить фотографию, которая в настоящее время связана с учетной записью пользователя, используйте командлет Remove-UserPhoto. Параметр Отмена удаляет только фотографию предварительного просмотра.
| 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
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.
- Деструктивные командлеты (например, командлеты Remove-*) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New-* и Set-*) не имеют встроенной приостановки. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
| 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
Этот параметр доступен только в локальной среде Exchange.
Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, 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
Для изменения Группы Microsoft 365 требуется переключатель GroupMailbox. Указывать значение для этого параметра необязательно.
| 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
Параметр Identity задает идентификатор пользователя. Можно использовать любое уникальное значение, идентифицирующее пользователя. Пример:
- Имя
- Псевдоним
- различающееся имя (DN);
- различающееся имя (DN);
- Домен\Имя пользователя
- Адрес электронной почты
- GUID
- LegacyExchangeDN
- SamAccountName
- Идентификатор пользователя или имя участника-пользователя
| 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
Параметр IgnoreDefaultScope указывает команде игнорировать параметр получателя область по умолчанию для сеанса Exchange PowerShell и использовать весь лес в качестве область. Указывать значение для этого параметра необязательно.
Этот параметр позволяет команде получать доступ к объектам Active Directory, которые в настоящее время недоступны в область по умолчанию, но также вводит следующие ограничения:
- При этом параметр DomainController использовать нельзя. Команда автоматически использует соответствующий сервер глобального каталога.
- При этом параметр DomainController использовать нельзя. Команда автоматически использует соответствующий сервер глобального каталога.
| 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
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| 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
Параметр PictureData указывает файл фотографии, который будет отправлен в учетную запись пользователя.
Допустимое значение для этого параметра требует считывания файла в байтовый объект с использованием следующего синтаксиса: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). Эту команду можно использовать в качестве значения параметра или записать выходные данные в переменную ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) и использовать переменную в качестве значения параметра ($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
Параметр PictureStream указывает фотографию, которая будет отправлена в учетную запись пользователя. Этот параметр используется клиентскими приложениями, такими как Outlook в Интернете, когда пользователи добавляют фотографию. Чтобы отправить фотографию с помощью PowerShell, укажите файл фотографии с помощью параметра PictureData.
| 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
Параметр Предварительный просмотр отправляет фотографию предварительного просмотра для учетной записи пользователя. Указывать значение для этого параметра необязательно.
Фотография предварительного просмотра — это объект фотографии, который передается в учетную запись пользователя, но не сохраняется. Например, если пользователь отправляет фотографию в Outlook в Интернете Параметры для предварительного просмотра перед сохранением. Если вы используете параметр Предварительный просмотр для отправки фотографии предварительного просмотра, необходимо выполнить команду Set-UserPhoto -Save , чтобы сохранить ее как фотографию пользователя.
| 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
Параметр Сохранить указывает, что фотография, отправленная в учетную запись пользователя, будет сохранена как фотография пользователя. Для этого переключателя не требуется указывать значение.
| 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
Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.
| 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 types
Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.
Выходные данные
Output types
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.